Files
MikrotikManager/docs/bandwidth-operator-writer-window-20261026.md
T

76 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# S3-06: operator writer window
Реализация: `backend/src/services/bandwidth-operator-writer-window.ts` и
`bandwidth-operator-writer-composition.ts`. Это explicit operator construction;
startup, scheduler и HTTP activation не подключены.
Композиция вызывает настоящие `createBandwidthOperatorEnrollmentPrerequisite`
и `createBandwidthOperatorRegistry`, а не заменяет их synthetic register callback.
Private original Ed25519 authority получается до external Q, configured node lease,
credential resolution и native identity observation. Signed grant фиксирует peer,
inventory, root, original expiry и monotonic lifetime. Внешний caller не выбирает
другой peer при регистрации.
Один configured node source lease держит session exclusive 8723116. Registry
получает borrowed facade той же connection и выполняет собственные BEGIN/COMMIT;
outer BEGIN отсутствует. Optional `keyedProofs` сохраняет atomic MAC batch той же
lease. Driver COMMIT должен вернуть `command: COMMIT`; rows-only/lost ACK не
достаточны. Registry release(true) является только logical release после ACK.
Owner делает последнюю read-only original-authority/external-Q проверку, затем
уничтожает lease. Ошибки после начала COMMIT возвращают UNKNOWN без replay;
любая неопределённость уничтожает lease. Pool reuse и occupancy cleanup отсутствуют.
Configured source использует optional `openWithOwnershipFence`: exact physical
PID и held session lock проверяются через уже удерживаемую raw core fence до
заключительных file guards и original-authority guard. Это сохраняет before/after
driver ownership checks без рекурсивных outer source queries и metadata проходов.
Во время opening lock ещё приобретается; после перехода held обе проверки
обязательны, включая свежую fenced query для atomic MAC batch. Legacy structural
sources сохраняют прежние outer SQL checks.
Safe alias registration на том же canonical при существующей UNKNOWN occupancy
не запрещена; window вообще не имеет SQL/API для удаления occupancy/owners или
перепривязки node ради обхода занятого canonical.
## Конкретная внешняя граница и открытый issuer
В проверенном source deployment `deploy/docker-compose.cdn-mm.yml:179` backend
имеет container name `mmapp-backend`, `restart: unless-stopped` и updater labels.
Там же `:277` updater `mmapp-updater` имеет `restart: unless-stopped`, Docker socket
`/var/run/docker.sock` и readonly targets catalog. `deploy/updater/entrypoint.sh:391`
реализует update_target с recreate/rollback lifecycle. Поэтому stop только
backend или `stopScheduler()` не доказывает запрет его последующего запуска.
Реальная implementable adapter boundary должна быть operator-owned host service,
вне backend и вне public restore, контролирующая Docker daemon/deployment writers:
исходный полный inventory backend replicas, local dev/stdio executors, updater,
внешние RouterOS scripts/tools и отдельные старые binaries. Она должна удерживать
enforced stop и prohibition на start/recreate/restart старых executors, включая
updater/rollback, до конца writer window; проверять неизменность inventory и
activation/build/protocol generation до разрешения credentials. Remote RouterOS
executors требуют отдельной сетевой/credential enforcement boundary либо явного
доказанного охвата исходного inventory. `pg_locks`, пустые таблицы и подпись JSON
не заменяют эту границу.
Такого host issuer/ACL/activation attestor в прочитанном source не обнаружено.
`externalStop` является обязательной trusted server dependency, без production
default или fallback. Сам факт передачи callback не является production proof.
Ни deployment config, ни restart policy, ни сервисы здесь не изменены/остановлены;
удалённые hosts, RouterOS и PostgreSQL для этой реализации не запускались.
## Локальная проверка и предел результата
14 CPU тестов owner/composition прошли: Ed25519 authority до Q/credentials,
single-lease ownership, shared-holder contention model, same backend identity,
COMMIT ACK и logical release, cancellation/late acquisition, original inventory
drift, wall-clock rollback и bounded monotonic lifetime, UNKNOWN-preserving alias
lifecycle и raw-fence ownership path без outer metadata SQL, включая lock/PID
loss после driver dispatch до COMMIT. External Q и SQL в этих тестах синтетические. Это не доказательство
остановки production executors и не PostgreSQL multiprocess acceptance.
Нужна дополнительная actual PostgreSQL проверка именно новой композиции с
configured node source: одна physical PID, held session exclusion на 8723116,
same-lease registry COMMIT ACK, отсутствие self-deadlock, final check до destroy,
lost-ACK UNKNOWN без replay. Такой SQL runner принадлежит общему acceptance flow;
новая композиция не открывает DB самостоятельно.