Files
KArtSell.Aegis/docs/CURRENT/V13-FE-022_URL_QUERY_CODEC_SLICE_NOTE.md
T
kjh2064 3f293d8aa8
deploy / deploy (push) Successful in 1m52s
deploy / notify (push) Successful in 1s
V13-FE-006: consolidate approved UI and contract hardening
2026-08-13 02:41:00 +09:00

1.2 KiB

V13-FE-022 — URL query codec slice note

  • Requirement: REQ-FE-URL
  • API/UI/Test: UI-URL-01 / T-FE-URL-01
  • Source: v60 deep-link/canonical route boundary; current frontend/src/shared/crud/queryCodec.ts.
  • Assumption: Each screen that consumes the codec can provide an approved field/operator allowlist from its resource contract.
  • Unknown: No active production screen currently wires this codec to router state.
  • Decision Required: FE/QA must approve per-resource filter/sort allowlists before enabling URL synchronization in a screen.

Applied boundary

  • Added optional allowlists for sort fields, filter fields, and filter operators.
  • When supplied, unapproved URL values are discarded and the approved fallback remains authoritative.
  • Preserved existing behavior for callers that have not yet supplied a screen-specific allowlist.
  • Kept URL state as a serializable query contract; no Pinia/server-state duplication was introduced.

Evidence

pnpm test -- src/shared/crud/tests/queryCodec.spec.ts
PASS: 1 file / 3 tests (2026-08-12)

pnpm typecheck
PASS (2026-08-12)

The Slice remains IN_PROGRESS until a production screen supplies an approved allowlist and deep-link browser evidence is collected.