v6부터 Parsec 재현 계약을 적용한다. 각 기능의 parity.status는 unreviewed / different / matched / exception_verified이며, sourceEvidence와 comparisonEvidence에 근거 링크를 기록한다. exceptionIds는 parity-policy.json의 E01–E04만 허용한다. matched에는 예외를 섞지 않으며, 혼합 항목은 exception_verified와 상세 차이 보고서를 사용한다. done에는 기존 구현/시험/통합/선행 완료 외에 원본 대조 완료가 필요하다. 문서만 작성한 것으로 matched를 표시하지 않는다.
progress-7에서 사용자 EXE·프로필 통합을 구현했다. F01/F24/F64/F82는 전체 원본 UI·수명·접속 흐름 차이가 남아 different이며 나머지 78개는 원본 대조 전이다. 현재 근거. 기존 구현 상태와 사용자 기록은 유지했다. 원본 근거가 있어도 비교 시험이 없으면 matched가 아니다. 근거 파일 존재와 구조 검사는 실제 대조의 정확성을 대신 심사하지 않는다.
전체 개발 진행 현황에서 M0–M5와 전체 82개 기능을 확인한다. 개발 단계, 구현 상태, 선택 범위와 검색을 조합해 필터링할 수 있다. 단계 카드를 누르면 그 단계의 전체 기능을 보여준다. 각 행은 구현 기록, 설계/구현/검증/통합 단계, 근거 파일, 남은 작업, 원래 완료 기준과 사용자 수동 기록을 표시한다.
구현 기록과 사용자 기록
development-status.json: 코드와 검증 결과를 확인한 개발 기록. HTML에 내장되며 브라우저가 임의로 완료 상태를 바꾸지 않는다.- 기존 선택 JSON/localStorage: 사용자가 선택한 개발 범위·메모·수동 상태. 이번 보강은 기존 기록을 덮어쓰지 않는다.
- 사용자가 완료로 표시했지만 구현 기록이 미완료라면 표에서 재검토 메시지를 보여준다. 기능 행의 “상태 기록”은 기존 체크리스트로 이동한다. 선택 밖 기능을 자동 선택하지 않는다.
- 상단 현황은 항상 전체 82개 기준이다. “내 선택만” 필터는 아래 표만 좁힌다. 부분 구현은 임의의 50% 등으로 환산하지 않고, 전체 완료된 기능 수로만 단계 완료율을 계산한다.
- “전체 진행 보고서 .md 저장”은 82개 전체의 구현 근거와 사용자 상태를 내보낸다. “체크 상태를 HTML로 저장”에는 개발 기록도 내장된다. 저장본은 저장 시점의 기록이며 이후 코드 변경을 자동 반영하지 않는다.
상태 기준
| 기록 | 뜻 |
|---|---|
미착수 (todo) |
명세는 있지만 구현/시험 근거가 없음 |
진행 중 (doing) |
일부 코드·분석·시험 산출물이 있고 남은 구현이 있음 |
검증 대기 (validation) |
구현을 만들었지만 필요한 환경·통합 검증이 남음 |
완료 (done) |
해당 기능의 구현·검증·통합과 선행 기능이 완료. 남은 작업 없음 |
차단 (blocked) |
외부 조건 등의 해결 없이는 해당 작업을 진행하기 어려움. 이유와 해소 조건을 남은 작업에 기록 |
각 작업 단계의 pending은 확인 전, partial은 일부 확인, complete는 해당 단계 확인 완료, na는 적용 대상이 아님을 뜻한다. 설계의 documented는 명세가 있다는 뜻이다. 코드가 있거나 단위 검사가 통과했다는 이유만으로 기능 전체를 완료 처리하지 않는다.
현재: 진행 30개, 검증 대기 1개, 미착수 51개, 전체 완료 0개. 실제 끝난 인증 CLI·release 빌드 등의 작업은 이력에 별도로 표시한다. Ubuntu 운영 systemd/Nginx·공개 HTTPS/WSS·백업/복원은 검증했다. 서로 다른 Windows PC와 실제 영상·입력은 아직 미검증 또는 미구현이다.
매 개발 작업 후 갱신 절차
- 변경한 F ID의 실제 코드와 완료 기준을 대조한다.
development-status.json의 해당 기록만 갱신한다.state,stages,summary,remaining,evidence,checkedAt를 함께 수정하고 다른 기능의 기존 기록은 유지한다. 근거 링크는design/기준의 저장소 내부 파일이다.- 전체
updatedAt와revision을 바꾸고 실제로 마친 작업은milestones에 추가한다. 다음 작업 묶음도 필요하면 조정한다. 실패와 미실행 조건을VERIFICATION.md에 기록한다. - 아래 명령으로 단일 HTML을 재생성하고 검사한다. ID 누락이나 존재하지 않는 근거 파일은 빌드/검사에서 거부한다. 완료 상태의 근거·선행 기능·작업 단계도 검사한다.
- 브라우저를 새로고침해 변경과 기존 사용자 기록 보존을 확인한다. 선택 JSON은 개발 기록 JSON과 별개의 파일이다.
python design/build_plan.py
node design/write_briefs.cjs
node --test design/plan.test.cjs design/homeserver.test.cjs design/development-progress.test.cjs
F ID나 설계 버전이 바뀌면 plan-data.json과 개발 기록을 함께 수정한다. 이 문서는 자동 감시 서비스가 아니다. 개발 기록을 갱신하지 않은 채 HTML만 새로고침해도 최신 코드 상태로 바뀌지 않는다.