문서 인덱스
기능 (PRD가 중심 노드 — 여기서 시작)
- 공개 명함 공유와 NFC 진입 — 직무별 관점 · API 흐름 · 관련 문서가 한 노드에
손으로 유지하는 정적 인덱스. Dataview 인덱스는 Obsidian에서만 보이므로 AI·GitHub·Quartz용은 이 파일이 원본이다. 문서를 추가·삭제하면 이 파일도 같은 PR에서 갱신할 것.
결정 (ADR — append-only)
- 0001 docs-as-code 하이브리드 — 문서 시스템 자체의 결정
- 0002 스펙 퍼스트 OpenAPI — API 계약은 손 스펙이 원본, 코드는 CI 검증
- 0003 문서 허브 중앙화 — 지식 문서는 전부 허브, 레포 작업 문서만 코드 옆
API 맥락 (docs/api/)
스펙(“무엇”)은 tapple-be openapi.yaml, 여기는 “왜·엣지케이스”만.
- public-card — 공개 명함 세 층 구조, OG, revision, slug, CSP
- business-card — 편집(Live Studio), expectedVersion, 개수 제한, presigned 업로드
- nfc-card — 4상태 판정, self-claim(first-tap-wins), visitId 멱등성
- analytics — 이벤트 schema v2, SHARE 유입, 중복 제거
- auth — refresh 쿠키(stateless JWT), single-flight 재발급
설계 (docs/design/)
- 공개 명함·NFC 시스템 전체 흐름 — Caddy 라우팅·상태 분기 한 장
- 팀 문서 시스템 핸드오프 — 시스템 구축 여정
- API·멀티레포·AI 친화 핸드오프 — 3레포 토폴로지, 스펙 퍼스트 경위
기획 (docs/product/) — Relay 공유
운영 (docs/runbook/)
(비어 있음)
회고 (docs/postmortem/)
(비어 있음)
회의록 (docs/meetings/) — Relay 공유
(비어 있음)
기타
- 일하는 방법 — PRD → 스펙 PR → 병렬 구현 → 기록 → 연결
- 문서 체계 가이드 · 컨벤션
- 템플릿: prd · design-doc · adr · runbook · postmortem · api · meeting
- 설치: obsidian · relay · quartz
BE 문서 (docs/be/)
- as-built 통합 구현 명세 — 공개 명함·NFC·분석의 현재 진실
- 배포 계약 · 인증 refresh 쿠키
- self-claim · 발급 후 전환 · admin NFC
FE 문서 (docs/fe/)
- 공개 명함 문서 배포 · NFC 라우팅
- 뷰어 개선 · admin 운영
- 제품 정책 체크리스트: action · implementation
- Vercel React 감사 2026-07-22
코드 레포에 남는 것 (여기 없음)
- 계약 원본
openapi/openapi.yaml, 각 레포 CLAUDE.md - 레포 작업 문서: 구현 규칙·테스트 가이드·온보딩·레포-로컬 ADR (ADR-0003 예외 조항)