<!-- 달록 PaceLog Archive 내비게이션 — AI 컨텍스트 복구용 전체 지도 — 2026.06.03 작성 -->

# 🧭 달록 PaceLog Archive — Navigation (AI 컨텍스트 복구 지도)

> **이 문서는 사람과 LLM(GPT·Claude·Codex 등) 모두를 위한 "지도"입니다.**
> 노션 "달록 PaceLog" 워크스페이스 전체를 무손실로 추출한 Knowledge Base의 진입점입니다.
> 향후 `https://dallog-tools.hansbridge.co.kr/` 에 업로드되어 외부 LLM 컨텍스트 복구용으로 사용됩니다.
>
> **LLM이 전체 문서를 직접 URL로 열람하려면** — 모든 문서의 절대 URL 색인을 참조하십시오: `https://dallog-tools.hansbridge.co.kr/llms.txt` (순수 텍스트) 또는 `https://dallog-tools.hansbridge.co.kr/knowledge/ai-index.html` (HTML). 신규 문서 업로드 시 자동 갱신됩니다.

---

## 0. 진입 레이어 — 이 문서의 위치

> **부팅 진입점은 `START_HERE.md` 입니다.** 새 LLM 컨텍스트 복구는 거기서 시작하세요.
> 이 `navigation.md` 는 그다음 단계인 **상세 지도**(카테고리 설명·기간·상황별 가이드)입니다.

복구 레이어 구조:

1. **`START_HERE.md`** (LEVEL 0) — 프로젝트 개요 + 읽기 순서 + 작업유형별 진입. 가장 먼저.
2. **`navigation.md`** (이 문서) — 전체 지도·카테고리 상세·상황별 가이드.
3. **`manifest.json`** — 142개 전 문서 기계판독 색인(title·category·**document_type**·**source_status**·priority·**read_when**·**knowledge_group**·**url_slug**·purpose·short_description·**excerpt**·updated·local_md_path·notion_id·notion_url). schema_version 3.
4. **`context-router.json`** — 작업유형(read_when)별 문서 묶음(LEVEL 1) + 전체 복구 순서(LEVEL 2). manifest에서 자동 생성.
5. **`pages/`** — 노션 원본 142개 .md (단일 진본, 무손실).

### 문서 공통 규약
- 모든 `.md` 최상단에 **YAML frontmatter**(title·notion_id·notion_url·category·parent·updated·priority·purpose, High 문서는 +read_when)가 있다.
- `priority`: **High** = 컨텍스트 복구·의사결정 핵심 / **Medium** = 이력·맥락 / **Low** = 세부 fix·이전버전.
- `knowledge_group`·`url_slug` 는 manifest에서 category로부터 결정론적 파생(파일 이동 없음, frontmatter override 가능).
- 본문의 OCR 깨진 한글·오타·평문(공개용 anon 키 등)도 원본 그대로 보존(무손실 원칙).
- **단일 진본 원칙**: pages/ 와 각 frontmatter가 진본. manifest·router는 직접 수정 금지, `_gen_manifest.cjs`/`_gen_router.cjs` 로 재생성.

---

## 1. 전체 구조 지도

```
docs/pacelog-archive/
├── START_HERE.md        ← LEVEL 0 진입점 (가장 먼저 읽힘)
├── navigation.md        ← (이 문서) 전체 지도·카테고리 설명·상황별 가이드
├── manifest.json        ← 142개 전 문서 기계판독 색인 (자동 생성)
├── context-router.json  ← 작업유형별/전체 복구 라우터 (자동 생성)
├── _gen_manifest.cjs    ← manifest 재생성 스크립트
├── _gen_router.cjs      ← router 재생성 스크립트
└── pages/
    ├── 00-pacelog-root.md                 [root]        프로젝트 루트 안내
    ├── 01-devlog/        (16)             [devlog]      날짜별 개발일지 (05-13 ~ 05-30)
    │   └── _index.md + 15개 일자별
    ├── 02-workreport/    (78)             [workreport]  Claude Code 작업 단위 보고 (76건 + 69a 대화raw + _index)
    │   └── _index.md + 01~76 + 69a
    ├── 03-handoff/       (21)             [handoff]     컨텍스트 핸드오프 (05-18 ~ 06-02)
    │   └── _index.md + 20개
    ├── 04-운영핵심지침.md                  [guideline]   ★ 개발 운영 철학·역할분업·프롬프트 템플릿
    ├── 05-status/        (20)             [status]      개발 현황·설명서·체크리스트·충족기준·SAFEZONE
    │   ├── _index.md
    │   ├── 달록-PaceLog-설명서.md / 기능설명서.md / UI시각화-내용-설명서.md
    │   ├── 달록-v0.9-완성-충족기준.md / SAFEZONE-멀티유저-데이터분리-RLS.md
    │   ├── 작업-체크리스트-V2-260527.md / 작업-체크리스트-260603-0805.md
    │   ├── MCP브라우징-보고서.md / 달록-개발-현황_260530_1.md
    │   └── versions/  (9)  이전버전·스냅샷 보관
    ├── 06-감량러닝전략-v1.md                [strategy]    개인 감량·러닝 전략 (도메인 컨텍스트)
    ├── 07-PACELINK-트래커통합-앱화기획.md   [planning]    트래커 통합 + 네이티브 앱화 대형 기획
    ├── 08-수익화시뮬레이션보고서.md          [business]    수익화 시뮬레이션
    ├── 09-LIFELINE-1인운영지속가능성설계서.md [business]   1인 운영 지속가능성 설계
    ├── 10-사업성체크-한스브릿지종합평가서.md  [business]    사업성 종합 평가
    └── 11-브랜드설명서-v0.1초안.md           [brand]      브랜드 스토리·BI·컬러 토큰
```

> **총 142개 문서.** 정확한 파일 목록과 메타데이터는 `manifest.json` 참조.

---

## 2. 카테고리별 설명

| 카테고리 | 폴더/파일 | 무엇인가 | 언제 보나 |
|---|---|---|---|
| **root** | `00-pacelog-root.md` | 노션 최상위 페이지. 전체 하위 문서 안내 | 아카이브 첫 진입 시 |
| **guideline** | `04-운영핵심지침.md` | 달록 개발의 **운영 철학·관리 방식·3자(사용자·Claude.ai·Claude Code) 역할분업·파트섹션 트리·프롬프트 템플릿** | 작업 방식·역할·규칙을 알아야 할 때 (★최우선 맥락) |
| **devlog** | `01-devlog/` | 날짜별 개발일지. 그날 무슨 일이 있었는지 시간순 요약 | "언제 무엇을 했나" 시간축으로 훑을 때 |
| **workreport** | `02-workreport/` | Claude Code의 **작업 단위별 상세 실행 보고**(지시 원문·변경 파일·diff·검증·커밋). 가장 기술적으로 깊음 | 특정 기능/버그가 **어떻게 구현·수정**됐는지 코드 레벨로 알 때 |
| **handoff** | `03-handoff/` | 컨텍스트 간 인계 문서. 각 시점의 **상태 스냅샷 + 다음 할 일** | "그 시점에 전체 상태가 어땠나"를 한 장으로 볼 때 |
| **status** | `05-status/` | 개발 현황 허브 + **기능설명서·UI설명서·v0.9 충족기준·SAFEZONE(RLS)·작업 체크리스트** | 현재 기능 전모·UI 구조·남은 작업·완성 기준을 볼 때 (★현황 파악) |
| **strategy** | `06-감량러닝전략-v1.md` | 사용자(사장님) 본인 감량·러닝 전략. 달록의 **도메인 컨텍스트** | 달록이 왜 이런 기능을 가지는지 배경이 필요할 때 |
| **planning** | `07-PACELINK-…` | 트래커 통합·네이티브 앱화 대형 로드맵 | 중장기 제품 방향을 볼 때 |
| **business** | `08~10` | 수익화 시뮬레이션·1인 운영 지속가능성·사업성 종합평가 | 사업·경영 의사결정 맥락이 필요할 때 |
| **brand** | `11-브랜드설명서-…` | 브랜드 스토리·BI·컬러 토큰 규정 | 디자인·브랜딩 작업 시 |

### 카테고리 안에서의 우선 등급
- `*-index` = 각 폴더의 목차(컨테이너 본문).
- `spec`(충족기준) / `checklist`(작업 체크리스트) / `security-planning`(SAFEZONE) = status 폴더 내 **High** 핵심.
- `guide`(설명서 3종) = 현재 기능·UI **진본 설명서**.
- `*-version`(versions/) = 갱신 전 이전버전·스냅샷. **Low**, 이력 추적용.

---

## 3. 카테고리별 깊은 설명 — devlog / workreport / handoff 의 차이

세 카테고리가 시기적으로 겹쳐 헷갈리기 쉬워 구분을 명시합니다.

- **개발일지(devlog)** — "그날의 일기". 하루 단위로 무슨 작업·결정이 있었는지 **서술형 요약**. 가장 읽기 쉬움. 시간축 입문용.
- **작업보고(workreport)** — "작업 영수증". 하나의 작업 단위(예: F-8, 셀기능 Phase1~4)마다 **지시 원문 → 변경 파일 → diff → 빌드 검증 → 커밋**까지. 가장 상세·기술적. 코드가 어떻게 바뀌었는지 추적할 때.
- **핸드오프(handoff)** — "인수인계서". 컨텍스트(대화 세션)가 끝날 때 **현재 전체 상태 + 미완료 작업 + 다음 지시**를 한 장에 정리. LLM 컨텍스트 복구의 **가장 직접적인 입력**.

> 즉, **빠른 현황 복구 = 최신 handoff**, **깊은 기술 추적 = workreport**, **시간 흐름 = devlog**.

---

## 4. 기간 커버리지

| 카테고리 | 기간 | 건수 |
|---|---|---|
| 개발일지 | 2026-05-13 ~ 05-30 | 15 |
| 작업보고 | 2026-05-18 ~ 06-02 | 76 (+69a 대화raw) |
| 핸드오프 | 2026-05-18 ~ 06-02 | 20 |

- **프로젝트 시작**: 2026-05-13 (v0.1.0 달록 탄생, Claude.ai Artifacts 직접 개발).
- **노션 체제 구축**: 2026-05-18.
- **최신 상태 기준점**: 2026-06-02 (도메인 `dallog.kr` 라이브 + OAuth 3종 + 카카오 B안 자체처리).

---

## 5. 대화록(Conversation Logs) 처리 — ⚠️ 미추출 (의도적)

노션 초기 핸드오프(05-18~05-20) 하위에 **원시 대화록 12개**(`yymmdd-hh:mm대화록_N` 형식 11개 + `전체 대화록` 1개)가 존재합니다. **이번 아카이브에는 포함하지 않았습니다.**

- **위치**: 핸드오프 페이지의 자식 페이지 (달록 PaceLog → 핸드오프 → 각 핸드오프 → 대화록).
- **기간**: 2026-05-18 ~ 05-20. **05-21 이후 중단**(운영 방식이 'Claude Code 자기충족 프롬프트 + GPT 프롬프트 작성'으로 전환되며 대화록 체계 사실상 폐기).
- **판단**: 대화록은 **핸드오프/작업보고/개발일지로 충분히 커버**되어 KB 컨텍스트 복구 목적에는 **불필요**. 다만 "왜·어떻게 그 결정에 도달했는지"의 원시 의사결정 과정(사용자 원문 프롬프트·시행착오 시퀀스)은 고유 자산이라 **역사적·감사 가치**는 있음.
- **필요 시 추가**: 보존을 원하면 `pages/99-conversations/` 폴더로 12개를 동일 무손실 방식으로 추출 가능. (notion_id 목록은 `manifest.json` 외부 별도 메모/본 절 참조)

> 대화록 12개 notion_id:
> `3642296208688133b68bc30082486b48`(전체대화록), `3642296208688100966adc94f1ff98c5`, `36422962086881039cf2f9b10e02402b`, `36422962086881029795e286ffef1c4e`, `36422962086881b4b075d7850f74e00d`, `36522962086881049ce5fc652df23d0c`, `365229620868815bae33ed2f3b6b7824`, `3652296208688162926fcfaebd18329d`, `3652296208688138a11cd0803800065c`, `3662296208688148905bfc5f3cdbda95`, `36622962086881129b8fc6961da09383`, `36622962086881c3aa5fc5442514461f`

---

## 6. 상황별 가이드 — "이럴 땐 이 문서"

| 상황 / 질문 | 먼저 볼 문서 |
|---|---|
| ⚡ **달록 지금 상태가 어때? (최신 컨텍스트 복구)** | `03-handoff/20_2026-06-02_…도메인OAuth.md` → `05-status/작업-체크리스트-260603-0805.md` → `05-status/_index.md` |
| 현재 어떤 기능들이 있나 | `05-status/기능설명서.md` |
| UI/레이아웃 구조·컬러토큰·반응형 | `05-status/UI시각화-내용-설명서.md` (+ `11-브랜드설명서`) |
| 남은 작업·우선순위 | `05-status/작업-체크리스트-V2-260527.md`, `…-260603-0805.md` |
| v0.9(클로즈베타) 완성 기준 | `05-status/달록-v0.9-완성-충족기준.md` |
| 멀티유저·RLS·보안 설계 | `05-status/SAFEZONE-멀티유저-데이터분리-RLS.md` |
| 개발 운영 규칙·역할분업·프롬프트 방식 | `04-운영핵심지침.md` |
| 특정 기능이 **어떻게 구현**됐나 (코드 레벨) | `02-workreport/` 해당 작업 + `manifest.json` 검색 |
| 인증/OAuth(구글·네이버·카카오) 이력 | `02-workreport/76_260602_…OAuth3종….md`, `07_C-1_로그인…`, `03-handoff/20_…` |
| 엑셀 편집기·셀 입력 기능 | `02-workreport/61,66,71,72,73,74` (셀기능·엑셀편집기) |
| 스튜디오(UI 편집 툴)·디자인시스템 마이그레이션 | `02-workreport/69_…스튜디오…`, `67_…디자인폴리싱…`, `03-handoff/15,16` |
| 외부 설명(소개·세일즈)용 원천 자료 | `05-status/달록-PaceLog-설명서.md` |
| 수익화·사업성·운영 지속가능성 | `08-수익화…`, `09-LIFELINE…`, `10-사업성체크…` |
| 중장기 제품 로드맵(앱화·트래커 통합) | `07-PACELINK-…` |
| 사용자(사장님) 운동·감량 도메인 배경 | `06-감량러닝전략-v1.md` |
| 시간 흐름으로 전체 훑기 | `01-devlog/_index.md` → 날짜별 |

---

## 7. 생성·갱신 메타

- **생성일**: 2026-06-03
- **추출 원천**: 노션 "📁 달록 PaceLog" (`https://app.notion.com/p/36422962086881328e63c185344b77d3`) 및 전 하위 페이지.
- **추출 원칙**: 요약·축약·토큰절약 목적 단축 **금지**, 본문 누락 **금지**, 노션 계층 구조 유지.
- **재생성**: 노션 갱신 후 다시 추출하면 `_gen_manifest.cjs` 로 `manifest.json` 을 frontmatter 기반 자동 재조립 가능.
- **검증**: 작업보고 76개 정본 ID 전수 대조(F8 누락·S2 중복 교정 완료), 142개 전 문서 frontmatter 100% 확인.
