72d0a71307
Some checks are pending
Auto-tag / Create date-tag (push) Waiting to run
CI / Backend (.NET 8) (push) Waiting to run
CI / Web (React + Vite) (push) Waiting to run
CI / POS (WPF, Windows) (push) Waiting to run
Docker API / Build + push API (push) Waiting to run
Docker API / Deploy API on stage (push) Blocked by required conditions
1. Docs cross-check — обновил performance-baseline.md (Sprint 18/20/23 фиксы), secrets.md (16 новых env-vars из Sprint 20+ — Authentication Google/Microsoft, Monitoring, Cleanup, Hangfire:Cron, Telegram, Maintenance, App, Storage, PUBLIC_GA_ID/YM_ID). 2. Auto-gen api-reference — ApiReferenceDocsJob (Hangfire weekly вс 05:30 UTC) + Python-эквивалент `/tmp/gen-api-ref.py` для commit actual snapshot. docs/api-reference.md = 195 endpoints, 57 controllers. 3. Coverage gap-fill — Sprint18To23FeaturesTests.cs (16 Facts): - bulk-update + cross-tenant isolation - UserPresets CRUD - inline-edit price PATCH - CSV import 2 строки транзакцией - OrgExport create + list isolation - 1C-CSV import с русскими заголовками - audit-log export CSV streaming + BOM check - MoySklad sync-status stub - SSO providers + 503 unconfigured + 400 unknown provider - bug-001 NUL byte → 400 - bug-004 tiny price → 400 - export CSV BOM Покрывает все новые контроллеры Sprint 18-23 + regression-protect для критичных багов. 4. Contract tests — deploy/swagger-diff.sh: pull /swagger/v1/swagger.json с двух URL, diff endpoints+schemas через python3. Exit 0/1/2 для blue-green safety gate. Multi-path auto-detect. 5. docs/error-codes.md — каталог HTTP-кодов API (200-503) + humanizeError pattern для фронта + retry-policy таблица. 6. docs/glossary.md — 50+ доменных терминов (Tenant/Organization/Stock/ StockMovement/RetailSale/Counterparty/Owner/Employee/Role/Permission/ advisory lock/Serializable/…) с ссылками на code-сущности. 7. docs/ONBOARDING.md — first 3 days для нового разработчика (install → запуск → структура → первый PR + FAQ). 8. README.md — обновил под текущее состояние: React 19, Sprint-history 1-24, ссылки на ключевые docs, корректный 5-min quick start. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# Sprint 24 — docs cross-check + tests gap fill
|
|
|
|
Цель: после 23 спринтов docs/ содержит 50+ md файлов. Часть точно
|
|
устарела. Прогнать на актуальность + заполнить пробелы в integration
|
|
тестах.
|
|
|
|
Старт: 2026-06-08. Исполнитель: Claude Opus 4.7.
|
|
|
|
## Чек-лист
|
|
|
|
- [ ] **1. Docs vs code cross-check** — пройти каждый md, проверить
|
|
endpoints/классы/переменные. Устаревшее обновить, TODO явные.
|
|
- [ ] **2. Auto-generated endpoint reference** — `docs/api-reference.md`
|
|
через сканер `[ApiController]` + Hangfire weekly.
|
|
- [ ] **3. Coverage gap analysis** — coverlet → классы <50% → +тесты,
|
|
lcov-отчёт до/после.
|
|
- [ ] **4. Contract tests stage vs prod** — `/swagger.json` diff.
|
|
- [ ] **5. Error code catalog** — `docs/error-codes.md`.
|
|
- [ ] **6. Glossary** — `docs/glossary.md`.
|
|
- [ ] **7. Onboarding pack** — `docs/ONBOARDING.md`.
|
|
- [ ] **8. README.md update** — badges + 5-min quick start.
|
|
|
|
## Журнал
|
|
|
|
### 2026-06-08 старт
|
|
Sprint 23 закрыт (4 bugs found, 4 fixed). Поехали по docs.
|