docs: D6-D9 — HEALTHCHECK, env regression test, new docs, archive spec

Add Docker HEALTHCHECK and mail-path /healthz liveness; env-doc regression
test; architecture.md and development.md; product.md and expanded security.md;
retire live specification.md to docs/archive/.

Co-Authored-By: Claude <claude-opus-5-thinking-high@noreply@anthropic.com>
This commit is contained in:
2026-08-05 00:33:49 +03:00
parent 7f24b2923c
commit baaed5991b
16 changed files with 703 additions and 28 deletions
+5 -11
View File
@@ -1,22 +1,18 @@
# План документации SelfPost
**Зачем этот файл.** Документация — часть поставки (deliverables v1.0, пп. 5, 7, 9
в [specification.md](specification.md)), а не сопроводительный текст. Перед тегом
в [archive/specification-v1.0.md](archive/specification-v1.0.md)), а не сопроводительный текст. Перед тегом
релиза она обязана описывать **то, что делает код**, а не то, что задумывалось:
расхождение здесь — такой же дефект, как несоответствие требованиям, только
обнаруживает его пользователь на своём проде. План описывает, из чего состоит
пакет, как он сверяется с кодом, что уже разошлось (первый проход выполнен,
результаты ниже) и что с этим делать.
**Цель после выполнения плана:** [specification.md](specification.md) (ТЗ v1.0)
**выводится из обращения** — не потому что требования исчезли, а потому что v1.0
реализован и каждый блок ТЗ получает постоянный дом: пользовательское — в
**Цель (достигнута в D9):** ТЗ v1.0 **выведено из обращения** v1.0
реализован и каждый блок ТЗ получил постоянный дом: пользовательское — в
README, устройство — в `architecture.md`, продуктовые границы — в
`product.md`, обязательная безопасность — в `security.md`, процесс разработки —
в `development.md`. Живой `specification.md` после этого держит два риска:
дублирование с кодом и ложное ощущение «источника истины», который уже не
сверяют. Задача **D9** — миграция остатков и снятие файла; до её закрытия
ссылки на ТЗ в этом файле — исторические.
в `development.md`. Архив: [archive/specification-v1.0.md](archive/specification-v1.0.md).
**Место в общем плане:** документационный проход идёт вместе с **D.5**
([implementation-plan.md](implementation-plan.md)) — до тега следующего релиза,
@@ -43,9 +39,7 @@ README, устройство — в `architecture.md`, продуктовые г
### Рабочие документы проекта (не поставка, но обязаны быть верны)
[specification.md](specification.md) — ТЗ v1.0; **на вывод после D9** (см. карту
миграции ниже). До закрытия D9 — ещё используется как историческая ссылка в
находках раздела 3.
[archive/specification-v1.0.md](archive/specification-v1.0.md) — исторический снимок ТЗ v1.0 (D9 закрыт).
[implementation-plan.md](implementation-plan.md) — открытые вопросы для v1.0/v1.x.
[roadmap.md](roadmap.md) — линия 2.x.x.
[progress.md](progress.md) — живой трекер, читается первым после `/clear`.