판본 1.0 / 2026-09-07 / 구현을 시작하기 위한 제품·기술·개발 운영 기준선
이 패키지는 금융·공공 SI용 프론트엔드 데이터그리드를 구현하기 위한 설계와 개발 작업 패키지다. 완성된 그리드 제품, 배포 가능한 런타임, 성능 인증 결과가 아니다. SI Grid, @si-grid/*는 가칭이며 배포된 npm 패키지가 아니다.
START_HERE.md: 도입 순서와 실제 명령.docs/00-charter.md: 범위·가정·완료 정의.docs/03-architecture.md,docs/05-public-api.md,docs/07-ssr-integration.md: 핵심 계약.docs/16-codex-operating-model.md: 경량 하네스와 재개 규칙.work/current.json이 가리키는 작업: 첫 실행 지점.
| 구분 | 내용 | 상태 |
|---|---|---|
| 제품 설계 | 기능·조합·데이터·API·테마·SSR·SI 시나리오 | 제안 기준선 |
| 개발 작업 | 의존관계·완료 조건·산출물이 있는 작업 파일 | 제품 구현 전 |
| API 계약 | TypeScript 선언과 계약 사용 예제 | 타입 검사 대상; 런타임 없음 |
| 통합 예제 | HTML/JSP/React/Vue/SSR의 구현 패턴 | 런타임 구현 후 통합 검증 필요 |
| 보조 도구 | 상태 확인·체크포인트·실행 증거·완료 확인 | 제공 코드; 검증 보고서 참조 |
| 고객 문서 | 구조·작성 계약·대표 가이드 원고 | 제품 기능과 함께 완성 |
사용자 승인 요구 > product/requirements.json 및 승인된 결정 > 작업별 인수 기준 > 실제 코드·실행 증거 > 설명 문서 > 대화 요약. 코드가 요구와 다르면 코드를 정답으로 삼지 않는다. 충돌은 기록하고 해소한다.
작업 상태의 원본은 work/items/*.json이다. work/current.json은 현재 ID만 가리킨다. Word 통합본·HTML 열람본·목록은 읽기용 결과물이며 수정 원본이 아니다. 중복된 상태 파일을 추가하지 않는다.
Codex 하나를 기본 구현 주체로 사용한다. /goal은 릴리스 목적을 유지하고, 저장소는 작업 상태를 보존한다. 훅은 선택적 문맥 공급이다. 훅이나 지침만으로 품질·안전·지속 실행을 보장하지 않는다. 독립 CI와 사람이 승인하는 출시 절차를 유지한다.
실행 명령은 START_HERE.md, 검증 범위는 VALIDATION.md를 확인한다. planned, not_run, needs_review, blocked를 passed나 accepted로 바꾸려면 해당 근거가 필요하다.
DESIGN_READER.html은 검색 가능한 통합 열람본이다. SI_Grid_Enterprise_Design_v1.0.docx는 21개 설계 장과 참고 자료를 합친 37쪽 Word 문서다. 고객 문서 초안·세부 작업 JSON·API 계약·보조 도구는 ZIP의 원본 파일을 사용한다. 현재 그리드 런타임이 없으므로 예제의 가칭 패키지를 실제 npm 패키지로 오인하지 않는다.