2.0 KiB
2.0 KiB
KART Front Repository Rules
Repository Role and Current Authority
- This repository is the current React 17 and JavaScript frontend for KART survey processing and reporting.
- Treat the existing routing, state management, report screens, tables, charts, exports, and custom publishing CSS as authoritative until an approved migration slice replaces them.
- Do not perform incidental JavaScript-to-TypeScript, custom-CSS-to-Tailwind, React-to-Next.js, router, or state-library migrations while handling an unrelated change.
- The sibling
../Style_publishdirectory is outside this Git repository. Treat it as external reference material and do not modify it unless a task explicitly adds it to scope.
Legacy Auxiliary Server
- The tracked
server/directory is a legacy auxiliary Express/MSSQL artifact and includes embedded connection configuration. Do not copy, disclose, extend, or rely on those values. - Treat removal or replacement of that server configuration as migration cleanup; keep it outside unrelated frontend maintenance.
Frontend Migration Direction
- The approved destination is Next.js with TypeScript and shadcn/ui, migrated by bounded route or feature slices.
- In an approved migration slice, use shared KRI frontend contracts and shadcn components before creating application-local equivalents.
- Do not create new frontend TypeScript type or interface names ending in
DtoorDTO. - Preserve report filters, table and chart semantics, loading and error states, export behavior, responsive behavior, and user-visible styling during migration.
- Existing partial Tailwind or shadcn work does not authorize a broad migration or establish that the entire application has already moved to the target architecture.
Harness and Verification
AGENTS.mdandCLAUDE.mdare generated. Edit.agent/profile.ymlor.agent/project.md, then recompose instead of editing generated files.- Use the repository's existing package manager and narrow frontend checks. Do not start the auxiliary server or connect to MSSQL during validation.