chore: adopt agent harness and update common starter

This commit is contained in:
2026-08-07 15:41:59 +09:00
parent 324ba3a1ca
commit 2a684bf401
6 changed files with 332 additions and 1 deletions

21
.agent/profile.yml Normal file
View File

@@ -0,0 +1,21 @@
schema_version: 1
project:
id: lge-cx-dash-back
name: LGE CX Dashboard Backend
type: requested-project
layer: backend
legacy: false
stack:
- java-springboot
shared_contracts:
consumes:
- kri-common
databases:
- id: lge-cx
engine: mysql
role: primary-survey-statistics-data
access: read-write

21
.agent/project.md Normal file
View File

@@ -0,0 +1,21 @@
## LGE CX Dashboard Backend Repository Rules
### Deliverable and Domain
- This Spring Boot backend serves the LGE appliance penetration, purchase, category, profile, and trend dashboard.
- Treat approved planning material and acceptance criteria as the scope boundary. Preserve year, category, variable, filter, calculation, and response semantics used by the frontend.
- Statistics endpoints, Excel upload, persisted survey data, variable/year metadata, and statistics cache behavior form one coordinated data contract.
- Do not infer a new statistic, category mapping, aggregation rule, or visualization requirement from source names alone.
### Statistics, Upload, and Cache Safety
- Preserve denominators, weighting, missing values, category membership, ordering, decimal precision, rounding, totals, and cache-key semantics when changing a statistic.
- Validate Excel structure, headers, cell types, file size, and partial-failure behavior at the upload boundary. Never use customer source data as an unrestricted test fixture.
- Keep cache invalidation explicit when uploaded data, variables, years, or calculation behavior changes.
- 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 MySQL, upload customer workbooks, or call production integrations without separate approval.