docs(governance): enforce 4-layer component & 11-template CRUD guidelines into AGENTS.md authority
Validators (Pushes and Pull Requests) / UI & Storage Validation (push) Failing after 11s
Validators (Pushes and Pull Requests) / Database & Schema Validation (push) Successful in 11s
Validators (Pushes and Pull Requests) / Core Validators & Database Setup (push) Failing after 20s
Validators (Pushes and Pull Requests) / WBS & Audit Validations (push) Has been skipped
Validators (Pushes and Pull Requests) / .NET Contracts (push) Has been skipped
Validators (Pushes and Pull Requests) / Calibration & Performance (push) Has been skipped
Validators (Pushes and Pull Requests) / Operational Report & Decision Packet (push) Has been skipped
Validators (Pushes and Pull Requests) / CI Workflow Lint (push) Failing after 9s
Validators (Pushes and Pull Requests) / Security & Secrets (push) Successful in 10s
Validators (Pushes and Pull Requests) / Notify PR Results (push) Has been skipped
Validators (Pushes and Pull Requests) / UI & Storage Validation (push) Failing after 11s
Validators (Pushes and Pull Requests) / Database & Schema Validation (push) Successful in 11s
Validators (Pushes and Pull Requests) / Core Validators & Database Setup (push) Failing after 20s
Validators (Pushes and Pull Requests) / WBS & Audit Validations (push) Has been skipped
Validators (Pushes and Pull Requests) / .NET Contracts (push) Has been skipped
Validators (Pushes and Pull Requests) / Calibration & Performance (push) Has been skipped
Validators (Pushes and Pull Requests) / Operational Report & Decision Packet (push) Has been skipped
Validators (Pushes and Pull Requests) / CI Workflow Lint (push) Failing after 9s
Validators (Pushes and Pull Requests) / Security & Secrets (push) Successful in 10s
Validators (Pushes and Pull Requests) / Notify PR Results (push) Has been skipped
This commit is contained in:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user