# 개발 진행 기록 사용·갱신 v6부터 [Parsec 재현 계약](PARSEC_PARITY.ko.md)을 적용한다. 각 기능의 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개는 원본 대조 전이다. [현재 근거](UNIFIED_APP_PARITY.ko.md). 기존 구현 상태와 사용자 기록은 유지했다. 원본 근거가 있어도 비교 시험이 없으면 matched가 아니다. 근거 파일 존재와 구조 검사는 실제 대조의 정확성을 대신 심사하지 않는다. [전체 개발 진행 현황](notparsec-plan.html#development-progress)에서 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와 실제 영상·입력은 아직 미검증 또는 미구현이다. ## 매 개발 작업 후 갱신 절차 1. 변경한 F ID의 실제 코드와 완료 기준을 대조한다. 2. `development-status.json`의 해당 기록만 갱신한다. `state`, `stages`, `summary`, `remaining`, `evidence`, `checkedAt`를 함께 수정하고 다른 기능의 기존 기록은 유지한다. 근거 링크는 `design/` 기준의 저장소 내부 파일이다. 3. 전체 `updatedAt`와 `revision`을 바꾸고 실제로 마친 작업은 `milestones`에 추가한다. 다음 작업 묶음도 필요하면 조정한다. 실패와 미실행 조건을 `VERIFICATION.md`에 기록한다. 4. 아래 명령으로 단일 HTML을 재생성하고 검사한다. ID 누락이나 존재하지 않는 근거 파일은 빌드/검사에서 거부한다. 완료 상태의 근거·선행 기능·작업 단계도 검사한다. 5. 브라우저를 새로고침해 변경과 기존 사용자 기록 보존을 확인한다. 선택 JSON은 개발 기록 JSON과 별개의 파일이다. ```powershell 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만 새로고침해도 최신 코드 상태로 바뀌지 않는다.