kjh2064/QuantEngineByItz
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 9 Wiki Activity

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
Details
Validators (Pushes and Pull Requests) / Database & Schema Validation (push) Successful in 11s
Details
Validators (Pushes and Pull Requests) / Core Validators & Database Setup (push) Failing after 20s
Details
Validators (Pushes and Pull Requests) / WBS & Audit Validations (push) Has been skipped
Details
Validators (Pushes and Pull Requests) / .NET Contracts (push) Has been skipped
Details
Validators (Pushes and Pull Requests) / Calibration & Performance (push) Has been skipped
Details
Validators (Pushes and Pull Requests) / Operational Report & Decision Packet (push) Has been skipped
Details
Validators (Pushes and Pull Requests) / CI Workflow Lint (push) Failing after 9s
Details
Validators (Pushes and Pull Requests) / Security & Secrets (push) Successful in 10s
Details
Validators (Pushes and Pull Requests) / Notify PR Results (push) Has been skipped
Details

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