From 4d2ed60c6fac8ee6e9929f1dc081ab75c3776f72 Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Sun, 26 Jul 2026 01:44:09 +0900 Subject: [PATCH] docs(governance): enforce 4-layer component & 11-template CRUD guidelines into AGENTS.md authority --- AGENTS.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 7363563d..86cf805d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -192,15 +192,15 @@ - **비즈니스 로직 단순화**: 다차원 중첩 조건이나 연쇄 트리거를 제거하고 선형 구조(Waterfall, Sequence)의 단순 프로세스 플로우로 구현하여 추적 가능성을 극대화한다. - **코드 및 다국어 규칙**: 모든 관리자 UI 레이블, 폼, 오류 메시지는 한국어로 작성하며, 소스 코드 주석 및 내부 예외 메시지는 영어 작성을 허용한다. 클래스, 메서드, 프로퍼티는 `PascalCase`를 사용하고 비동기 메서드에는 `Async` 접미사를 지정한다. - **OMS·WMS·ERP 상용화 10대 설계 원칙 (`docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md`)**: - 1. 공통 `FieldContract` (`FieldStatus`, `FieldState`)를 최우선으로 확정한다. - 2. `UI Primitive`와 `도메인 입력 컴포넌트`를 엄격히 분리한다. - 3. 단순 CRUD가 아닌 업무 트랜잭션 템플릿(목록, 등록, 상세, 수정, 일괄, 승인, 취소·역처리)을 적용한다. - 4. 클라이언트(UI 1차 검증) → 서버(업무 규칙) → DB(무결성/낙관적 락) 4계층 검증 경계를 준수한다. + 1. 공통 `FieldContract` (`FieldStatus` 13가지, `ValueSource` 8가지, `FieldState`)를 최우선으로 확정한다. + 2. **입력 컴포넌트 4계층 아키텍처** (`primitives/` → `fields/` → `domain-fields/` → `business-composites/`)를 엄격히 준수하며, Primitive 영역에 도메인 로직 혼입을 원천 차단한다. + 3. **11대 표준 업무 템플릿** (`TPL-LIST-01` ~ `TPL-HISTORY-01`) 체계를 적용하여 목록, 단일/헤더·라인/단계 등록, 상세, 수정, 일괄, 승인, 취소·역처리, 이력 화면을 업무 위험도에 따라 명확히 분리한다. + 4. 클라이언트(UI 1차 검증) → 스키마(2차) → 서버(업무 규칙 3차) → DB(무결성/낙관적 락 4차) 4계층 검증 경계를 준수한다. 5. 원본 마스터 모델은 정규화하고 조회/피킹/대시보드는 역정규화 Read Model로 구별하며 과거 문서는 스냅샷을 보존한다. - 6. 완료된 시점 거래는 물리 삭제/덮어쓰기 대신 취소·반제·역처리 트랜잭션을 생성한다. + 6. 완료된 시점 거래는 물리 삭제/덮어쓰기 대신 `TPL-CANCEL-01` 취소·반제·역처리 트랜잭션을 생성한다. 7. 현장 작업(WMS)은 바코드 연속 스캔, 100ms 이내 단결 판정, 오프라인 큐 적재, 오류 음향/진동 피드백을 필수 탑재한다. - 8. AI 보조(AX)는 초안/추천 역할에 국한하며 R0~R4 위험 등급 정책을 준수하고 결정론적 수식(금액/수량/세금)은 AI에 직접 위임하지 않는다. - 9. 바이브코딩(AI 생성 코드)도 동일한 품질 게이트(타입/정적분석/E2E 테스트/이력 추적)를 통과한 경우에만 반영한다. + 8. AI 보조(AX)는 초안/추천(`AISuggestedField`) 역할에 국한하며 R0~R4 위험 등급 정책을 준수하고 결정론적 수식(금액/수량/세금)은 AI에 직접 위임하지 않는다. + 9. 바이브코딩(AI 생성 코드)도 동일한 품질 게이트(타입/정적분석/E2E 테스트/이력 추적) 및 자동 검증 하네스 CLI (`tools/validate_enterprise_crud_specification_v1.py`)를 통과한 경우에만 반영한다. 10. 화면 개수가 아닌 필드 오류율, 건당 처리시간, 역처리율, P95 지표로 개발 성과를 검증한다. ## 5c. 퀀트 엔진 엔지니어링 철학 및 구현 원칙 (Operational Philosophy)