37 lines
2.8 KiB
Markdown
37 lines
2.8 KiB
Markdown
# v60 Reference Integration Index
|
|
|
|
## Scope
|
|
|
|
Canonical reference: `docs/Design/kbx-foundation-v60-status-canonical-contract-hardening`.
|
|
|
|
This index records what was borrowed into the current domain, what remains intentionally deferred, and the evidence that supports each disposition. The reference package is not the current domain source of truth.
|
|
|
|
## Adopted patterns
|
|
|
|
| Area | Adopted element | Current artifact | Evidence |
|
|
|---|---|---|---|
|
|
| FE UI | Provider-neutral UI adapter and shared screen/state boundaries | `frontend/src/shared/ui/adapter`; `frontend/src/shared/ui/screen-types` | FE regression `53 files / 135 tests`, typecheck passed |
|
|
| FE validation | Runtime request/form validation and ProblemDetails mapping | `frontend/src/shared/crud/formValidation.ts`; `frontend/src/shared/api` | Form and full FE tests |
|
|
| FE vendor boundary | Feature code cannot import PrimeVue/AG Grid directly | `frontend/src/shared/ui/adapter/tests/vendorBoundary.spec.ts` | Vendor boundary test `1/1` passed |
|
|
| API generation | Runtime Swashbuckle generation with deterministic schema IDs | `src/KArtSell.Host/Program.cs` | Host Release build; real artifact generation |
|
|
| API errors | ProblemDetails response family documented without inventing `422` | `src/KArtSell.Host/OpenApi/ProblemDetailsOperationFilter.cs` | Generated responses `200/400/401/403/404/409/500` |
|
|
| Reliability | JobRun repository-to-baseline column drift check | `tests/KArtSell.ArchitectureTests/RepositoryRulesTests.cs` | Architecture tests `17/17` passed |
|
|
| Safety | KIS/Trade endpoints remain unregistered while hard-off | `TradeEndpoints.cs`; architecture guard | KIS hard-off evidence and architecture test |
|
|
| CI governance | Approved baseline only; candidate upload, no auto-promotion | `.gitea/workflows/openapi-gate.yml` | PyYAML parse passed; fail-closed baseline path |
|
|
|
|
## Intentionally deferred
|
|
|
|
- v60 API operation catalog as a current baseline: explicit audit found live IDs `31`, reference IDs `66`, intersection `0`.
|
|
- `docs/api/openapi.json` baseline: requires API Architect approval.
|
|
- Reconciliation route authorization and correction mutation: approved permission/maker-checker contract absent.
|
|
- JobRun fresh/upgrade/re-run/failure DB rehearsal: PostgreSQL was unavailable; no completion claim.
|
|
- FE global router guard: approved auth hydration and unauthorized screen contract absent.
|
|
- KIS order/status/cancel/settlement activation: separately approved release required; capability remains OFF.
|
|
|
|
## Governance invariants
|
|
|
|
- Reference code is borrowed only through current repository ports and contracts.
|
|
- No guessed route, permission, threshold, migration, or production capability is introduced.
|
|
- Evidence records actual commands and results; unavailable external dependencies remain unresolved.
|
|
- WBS status is not promoted to `COMPLETED` without its acceptance evidence.
|