[AZ-350] Refactor 03 Phase 2: roadmap + 27 task specs + safety net

Adds Phase 0 (baseline metrics, .gitignore tweaks), Phase 1
(research findings, list-of-changes), and Phase 2 (refactoring
roadmap, epic AZ-350, 27 task specs AZ-351..AZ-380, dependency
table updates) for the 03-code-quality-refactoring run.

Phase 3 (Safety Net) re-verified: 40/40 unit + 5/5 smoke
integration pass; documented in test_specs/existing_coverage.md.
Coverage % gating deferred to ticket C19 (AZ-372) which adds
Coverlet + reportgenerator.

Auto-chains to Phase 4 (Execution) via /implement starting at
batch 1 (Phase 1 critical fixes).

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-05-10 23:26:07 +03:00
parent 524809d77d
commit ff030a9521
36 changed files with 2570 additions and 15 deletions
@@ -12,6 +12,7 @@ Resolves the two remaining Medium architecture findings from the baseline scan:
## Discovery shortcut (Targeted-mode skip)
Phase 1 sub-steps 1a, 1b, 1c are **skipped** because:
- Component documentation already exists at `_docs/02_document/components/01_common/``05_route_management/` (5 components fully documented).
- Solution synthesis already exists at `_docs/01_solution/solution.md`.
- System flows already exist at `_docs/02_document/system-flows.md`.
@@ -100,17 +101,18 @@ Logical-flow analysis was performed implicitly in Step 7's smoke run (real flows
## Self-Verification
- [x] Every referenced file exists in the codebase (validated against `git ls-files` and the live tree).
- [x] Each change has File(s), Problem, Change, Rationale, Constraint Fit, Risk, Dependencies.
- [x] Component documentation already covers all affected areas (Targeted-mode skip applied).
- [x] Logical-flow analysis: green smoke + unit run on 2026-05-10 traced every affected endpoint.
- [x] Each change maps to ≤ 5 complexity points (C01: 3, C02: 2, C03: 5, C04: 2, C05: 3, C06: 2).
- Every referenced file exists in the codebase (validated against `git ls-files` and the live tree).
- Each change has File(s), Problem, Change, Rationale, Constraint Fit, Risk, Dependencies.
- Component documentation already covers all affected areas (Targeted-mode skip applied).
- Logical-flow analysis: green smoke + unit run on 2026-05-10 traced every affected endpoint.
- Each change maps to ≤ 5 complexity points (C01: 3, C02: 2, C03: 5, C04: 2, C05: 3, C06: 2).
## Self-Verification (Phase 1 close)
Discovery summary:
- Two architecture findings to resolve (F3 Medium, F4 Medium).
- Six changes (C01..C06), one task per change after Phase 2 decomposition.
- Total estimate: ~17 story points, but each PBI stays at ≤ 5 points per the project's PBI sizing rule.
Ready for Phase 2 (Analysis + Roadmap + Task Decomposition) on user approval.
Ready for Phase 2 (Analysis + Roadmap + Task Decomposition) on user approval.