프로젝트 docs/README.md GitHub에서 보기

docs 색인

파일명 규칙과 카테고리 정의는 AGENTS.md 3장을 따른다. 새 문서를 만들면 이 색인에 한 줄을 추가한다.

지금 진행 중인 작업 목록은 저장소 루트의 TASKS.md 에 있다 (원본은 WBS 문서).

앱을 띄우면 /docs (상단 바의 "문서") 에서 이 문서들을 한 화면에서 읽을 수 있다. 로그인은 필요 없다. 새 문서는 다시 컴파일하면 위키에 나타난다 (문서 위키 devlog).

devlog - 개발 과정 기록

문서 요약
2026-10-17-1-프로젝트-선정과-작업-원칙 주제 선정 근거, 작업 원칙 5가지와 세부 결정
2026-10-17-6-인증과-첫-병렬-라운드 phx.gen.auth, 문서 워커 3명 병렬 라운드, 문서 간 충돌 정리, 기본값 결정
2026-10-17-9-engagements-컨텍스트 워커 A 보고: Engagements 공개 함수, S1 목록과 S2 상세 화면
2026-10-17-10-GL-CSV-적재 워커 B 보고: GL CSV 파서, 적재, ImportWorker, 2만 행 측정
2026-10-17-11-합성-GL-생성기 결정적 합성 GL 생성기와 정답 라벨, 기본 시드 실측
2026-10-17-12-선행-작업과-두번째-병렬-라운드 M1 선행 작업, 워커 3명 병합, 오류 코드 4종, 생성-적재 통합 테스트 실측
2026-10-19-1-화면설계서와-시안-정합 화면설계서 작성, 시안 오류 6건 수정, 조립 스크립트 문제, M2 전에 확정할 계약 항목
2026-10-19-2-Testing-실행-경로 워커 A 보고: 룰 실행 경로, RuleWorker, 완료 감지, FailureHandler
2026-10-19-3-룰-7종과-정답-라벨-시험 워커 B 보고: 룰 7종, 레지스트리, 합성 GL 정답 라벨과 직접 대조
2026-10-19-4-적재-화면과-테스트-실행-화면 워커 C 보고: S3 GL 불러오기, S4 테스트 실행 화면, TickmarkWeb.Format
2026-10-19-5-AI-클라이언트 워커 D 보고: AI Client behaviour, Fake, Anthropic, 트리아지 프롬프트, 금지 표현 검사
2026-10-19-6-라운드-3-통합 라운드 3 B, C, D 병합, D 오탐 후속, S1 두 열, S2 통계와 실행 목록, 스트림 학습 포인트, A 병합과 교착 수정
2026-10-20-1-라운드-4-계약과-통합 라운드 4 선행 작업 (AI.model/0, broadcast_appended/1), M3/M4 계약 결정과 트레이드오프, 워커 5명 배정과 병합, S2 start_run 수정, TRUNCATE 테스트가 부른 간헐 타임아웃 원인, W6 병합
2026-10-20-2-Triage-요청과-워커 W1: 건별/일괄 트리아지 요청, 조건부 update_all 로 중복 job 방지, TriageWorker 반환표와 snooze 확인, 같은 입력의 제안 재사용
2026-10-20-3-Review와-직무분리 W2: submit_conclusion/3, decide/4, lock-first, stale/self_review 순서, DB backstop 테스트, 실제 연결 경합 검증의 제한
2026-10-20-4-감사-로그-조회와-S6 W3: list_events/3 필터와 커서, S6 필터, 새 이벤트 카운터 (수동 갱신), payload 요약 컴포넌트
2026-10-20-5-S5-finding-상세-표시 W4: get_finding!/2, list_rule_results/2, S5 읽기 화면, AI 제안과 사람 판단 구분, 초안 보존
2026-10-20-6-M2-통합-테스트 W5: Runner 경유 정답 라벨 시험, S2 단추 테스트, 커밋 뒤 audit_appended 보강, DuplicateEntry 15초 타임아웃 원인과 쿼리 수정
2026-10-20-7-S5-결론과-검토-동작 W6: S5 컴포넌트 영역별 분리, 결론 제출, 승인/반려 2단계, C-11 결론 ID 전달, 실시간 초안 보존
2026-10-20-12-공통-셸과-홈-화면 F1: 디자인 토큰, 48px 상단 바와 Layouts.app attr, 홈 리다이렉트와 소개, 한글 404/500
2026-10-20-13-인증-화면과-한글-문구 F2: 로그인, 회원가입, 설정 한글화, Gettext ko 번역 (errors, default), 인증 메일 문구
2026-10-20-14-라운드-5-화면-셸과-명세-문서 라운드 5: F1, F2, D1, D2 배정과 병합, 데모 시드, S5 AI 제안 요청 단추, 한글 로케일이 만든 빈 부재 단언, 브라우저 확인 수정
2026-10-20-15-문서-위키 /docs 문서 위키: 컴파일 시점 문서 목록, MDEx 렌더링과 링크 재작성, sandbox iframe 과 CSP, 검색과 목차
2026-10-25-2-배포-준비 배포 준비: release 와 Dockerfile, 부팅 시드 Task, 운영 메일 Logger 와 안내, render.yaml, 로컬 prod release 확인
2026-10-25-3-Render-첫-배포와-외부-확인 Render 첫 배포: 빌드와 부팅 로그, 가려진 Blueprint 값을 결과로 확인, 외부 HTTP 와 S1-S6 읽기 확인, plug_crypto 보안 권고

planning - 기획

문서 요약
2026-10-17-2-MVP-범위와-일정 MVP 시나리오, 기능 범위, GL CSV 계약, 일정 (최신)
2026-10-17-8-WBS와-마일스톤 마일스톤 M0-M7, WBS 항목별 담당/상태/커밋, 리스크 (살아있는 문서)
2026-10-20-8-배포-대상-검토 무료 배포 대상 8곳 비교 (Vercel, Render, Fly.io, Neon 등), Render + Neon 제안 (10/25 결정)
2026-10-20-9-요구사항-명세서 기능 요구사항 (REQ 8개 영역), 비기능 요구사항 (NFR), 추적표, 미결 사항 (초안, 기준 f5f7f78)
2026-10-20-10-기능-정의서 화면 S1-S6, 인증, 시스템 기능 (FN), 입력 계약, 기능과 감사 이벤트, 권한 대조표 (초안, 기준 f5f7f78)
2026-10-25-1-배포-가이드-Render-Neon Render Free + Neon Free 구성, 환경 변수, 사용자 단계, 로컬 release 확인 결과, 첫 배포 결과, 플랜 변경과 재배포 결과, 제약과 대안 (최신, 배포 완료)

architecture - 설계

문서 요약
2026-10-17-4-시스템-구조와-데이터-모델 컨텍스트, 테이블 13개, Oban, PubSub, AI 클라이언트, 병렬 개발 계획 (병렬 코딩 라운드의 공유 계약서)
2026-10-20-11-API-연동-규격서 HTTP 라우트, LiveView 이벤트, PubSub, Oban, Claude API, CSV, context 경계 (IF), 기준 커밋 이후 변경 (14장)

design - 디자인

문서 요약
2026-10-17-5-디자인-시스템 색, 타이포그래피, 컴포넌트, 화면 6종 구성 (확정, 원본)
2026-10-17-7-디자인-시스템-시안 5번 문서의 HTML 시안: 색 토큰(라이트/다크), 글꼴, 컴포넌트 상태, 화면 S1-S6
2026-10-17-13-화면설계서 S1-S6 화면별 영역 번호, 상태 변형, 이벤트/권한/감사 로그 매핑, 문구, 미결 사항 C-01-C-13 (HTML, 살아있는 문서)

domain - 감사/회계 도메인

문서 요약
2026-10-17-3-분개테스트-룰과-감사-용어 룰 8종, 점수, AI 입출력, 상태 모델, 합성 데이터 명세 (확정)