docs: add legacy verification and defensive-check guidance to the Backend knowledge base; create new guides for Legacy Oracle Test and Coverage Workflow and Legacy Defensive Checks
70ee8a7
docs: add Carbon React Grid and Subgrid Layouts guide; update index and log
5a87d01
docs: add object storage configuration contract
Documents where each object storage value comes from, how it reaches the backend, the fail-closed deployment gate, and how to rotate, verify and diagnose it.
7ce30bc
docs: document file-based router migration (frontend routing rewrite)
Rewrite the frontend routing documentation for the TanStack Router
file-based system (PR #1447) and record the migration with reasoning:
- architecture/frontend/Routing.md: full rewrite — request flow,
router bootstrap + defaults, single Register + staticData typing,
auth/status gate, role tiers, beforeLoad flag gates (fail-closed
trade-off documented), 404 split, redirect-after-login, route-owned
search state (#1238), loaders, navigation conventions, nav
projection, Vite codegen, add-a-route and add-a-flag walkthroughs;
4 validated mermaid diagrams
- codes/frontend/routes: RouteGuards rewritten for pathless layouts +
beforeLoad (HOC guidance removed); RoutesIndex rewritten as the
verified 29-route catalog
- changes/refactors: new dated migration entry with self-contained
reasoning for every design decision
- stale old-router references corrected across Feature-Flags,
Authentication, Roles, Frontend Structure/Overview, ReportingUnitBlockDetails,
Formula pages, LayoutSideNav, and index/log files; the deleted
search-params sync hook converted to a removal record
- block details accuracy: the route keeps its dedicated
reporting-unit-block-details-enabled flag (beforeLoad, same pattern
as RU details); its lack of role restriction predates the migration
(#1254 dropped the D9-era ADMIN gate on 2026-10-13) — preserved
1:1, not changed by the migration
5c2d3a5
docs: update Frontend Structure and Guidelines; add Frontend Verification and Tooling guide; create Frontend Type Boundary pattern
885c139
docs: update navigation and contribution guidance; add security and testing knowledge bases
17e8ce0
docs: add Block Creation Wizard test patterns and update index
64745f6
docs: document block details feature flag
ed84400
docs: update block details docs for route restructure
Rename the block details route to /reporting-units/$ruId/$blockId, document the new ReportingUnitBlocksList section on the reporting unit details page, and trim the standalone block details page doc to match the restructured implementation (decision D8).
1030eae
docs: add reporting unit block details page docs
Documents ReportingUnitBlockDetailsPage, BlockDetailsSummary,
BlockDetailsSkeleton, useDelayedFlag, and useReportingUnitDetailsQuery;
updates routing, architecture overview, and frontend testing pages
(issue #1369, slices 1/2/4/5).
a238831
docs: add TanStack Form useForm re-render gotcha to frontend KB
ac81cf7
feat(patterns): add Formula Create Screen pattern guide and update related documentation
46d1d28
fix(codes): correct Backend Components link in CodesIndex
c72fa0e
refactor(assets): move images to markdown folders and normalize links
- development/testing: move playwright images locally, update links
- architecture/backend: move IntelliJ/Eclipse images locally, update links
- changes/refactors/frontend: normalize public/img links to filename-only
94c5e91
refactor(codes): update CodesIndex link to folder index to avoid PATH_LINK
078e3f6
refactor(cypress): normalize CypressIndex links to filename-only slugs
eb4c8b2
refactor(codes): update OKF index and CodesIndex link after backend consolidation
25f3b48
refactor(codes): consolidate backend human index
- Remove duplicate BackendCodeIndex.md
- Keep BackendComponents.md as canonical human index for codes/backend
62824be
refactor(kb): convert PR #1297 postmortem to Fix Guide format
- Rename pr-1297-reporting-unit-create-test-failure.md to testing-library-async-test-isolation.md
- Convert Postmortem to Fix Guide format with Problem/Root Cause/Fix/Prevention
- Update kb/frontend/index.md entry
b2ea630
feat(wiki): enforce OKF in-place, remove okf bundle, regenerate per-folder indexes and fix human links
- Delete okf/ bundle; OKF format now in-place via per-folder index.md/log.md
- Regenerate 35 per-folder index.md to strict OKF format, create missing log.md
- Rebuild Home.md/_Sidebar.md to Navigation Contract; remove NAV_BLOAT
- Fix MD_EXT/PATH_LINK violations in 18 human pages to filename-only slugs
- Clean kb/index.md duplicate entry and intro content
e9f76be
feat: Add ADR 004: District Average Schema Design Decisions and update index references
1877fd3
refactor: Update links in Home and Sidebar for consistency and clarity
cc94ba5
feat: Add ADR 003: District Average Parity Fixture Contract and update related documentation
f4cf789
feat: Add human-facing indexes for various components, services, and documentation across the project
75d4b07
feat: Add comprehensive architecture and legacy documentation, including conventions, endpoints, patterns, and stubs
737a3ae
feat: Enhance backend architecture documentation and conventions
- Updated code style asset links in Profiles and Environment Separation documentation.
- Added conventions and endpoints documentation for the backend component.
- Created overview and patterns documentation for the backend component.
- Introduced stubs documentation for both backend and legacy components.
- Migrated legacy component documentation, including conventions, endpoints, and patterns.
- Removed outdated INDEX.md files from backend structure.
- Added detailed documentation for audit tables and correlation ID connection provider.
- Introduced District Average Parity Fixtures for backend testing.
9257bea
feat: Introduce decision notes and architecture decision records
- Added a new `Decisions.md` file to document the purpose, format, and writing guidance for decision records.
- Created an index for decisions in `index.md` to provide easy navigation to decision notes.
- Updated the Home and Sidebar to link to the new decision notes instead of specific ADRs.
- Removed outdated knowledge components and decision records related to correlation ID audit propagation and related patterns.
- Consolidated and organized knowledge base entries, removing obsolete documentation and ensuring clarity in the remaining content.
d975f26
feat: add Route Guards and related components for enhanced routing control
16e6036
feat: Enhance audit capabilities with database trigger and correlation ID propagation
- Added documentation for the new Database Trigger Audit Process, detailing the trigger flow, transaction behavior, and test coverage.
- Introduced the Audit Tables component, outlining the PostgreSQL audit_event and audit_change schema.
- Created a reference for the CorrelationIdConnectionProvider, a Hibernate decorator for injecting Micrometer B3 trace IDs into PostgreSQL.
- Documented architectural decision ADR 001 regarding the deferred-bind ConnectionProvider for transaction-local GUC.
- Updated existing documentation to reflect changes in migration safeguards, integration scenarios, and actor fallback behavior.
b12e591
docs: add documentation for Correlation-ID Audit Trigger and related backend patterns
8372b29