Files
kfpa-cx-dash-back/.agent/project.md

1.6 KiB

KFPA CX Dashboard Backend Repository Rules

Deliverable and Domain

  • This Spring Boot backend serves the KFPA CX dashboard for CSI summaries, ranks, object types, business divisions, comments, and related survey statistics.
  • Treat approved requirements and acceptance criteria as the scope boundary. Preserve survey date, division, object type, rank, score, comment, and response semantics used by the frontend.
  • Do not infer new aggregation, ranking, filtering, or comment-editing behavior from source names or planning-file dates alone.

Statistics and Persistence Safety

  • Preserve denominators, weighting, missing values, grouping, ranking ties, ordering, decimal precision, rounding, totals, and survey-date boundaries when changing statistics.
  • Keep MSSQL/MyBatis parameter binding, result mappings, null behavior, and query ordering explicit.
  • Treat division comments and administrative writes as auditable business changes with authorization, validation, and failure behavior.
  • Preserve backward-compatible request and response shapes so frontend and backend can deploy independently.

Shared Library and Verification

  • Consume com.kri.common:starter:beta.1.6.3 and use public com.kri.common.feature.* APIs. Do not duplicate a KriCommon feature locally.
  • AGENTS.md and CLAUDE.md are generated. Edit .agent/profile.yml or .agent/project.md, then recompose instead of editing generated files.
  • Use the Gradle Wrapper and the narrowest safe compile and tests. Do not connect to real MSSQL or modify customer comments during validation without separate approval.