154 lines
7.4 KiB
Markdown
154 lines
7.4 KiB
Markdown
---
|
||
title: LLM Wiki
|
||
---
|
||
|
||
# LLM Wiki — Map of Content
|
||
|
||
이 문서는 **Map of Content (MOC)** 입니다. 모든 문서를 일일이 나열하지 않습니다. 세부 목록은 Obsidian Dataview 또는 `/query` 명령으로 동적으로 확인합니다.
|
||
|
||
---
|
||
|
||
## 카테고리
|
||
|
||
### Canonical Layer (검증된 실무 기술 문서)
|
||
|
||
#### 개념 (`wiki/concepts/`)
|
||
백엔드/인프라 중심의 일반 기술 개념. 공식 기준 / 사례 / 트레이드오프 / 한계 / 출처 필수. "내가 했다" 표현은 `wiki/projects/` 전용. 자세한 요구사항은 [[CLAUDE]] §15.
|
||
|
||
#### 프로젝트 (`wiki/projects/`)
|
||
내 프로젝트의 실무 적용 내용. 문제 배경 / 검토 선택지 / 결정 이유 / 구현 / 검증(`actually-implemented` / `locally-verified` / `prod-verified`) / 한계 / 면접 가능 범위 필수.
|
||
|
||
### Derived Layer (canonical에서만 파생)
|
||
|
||
> 모두 Sources에 `[[wiki/concepts/...]]` 또는 `[[wiki/projects/...]]` 링크 필수. 원천 status가 `reviewed` / `verified` / `published-ready` 중 하나가 아니면 생성 불가 (`/lint` CRITICAL).
|
||
|
||
#### 면접 (`wiki/interview/`)
|
||
`/interviewize`로 생성. 답변 본문에 `actually-implemented` / `locally-verified` / `prod-verified`만 사용 가능. `documented-only` / `planned` / `needs-confirmation`은 "모른다고 답해야 하는 범위"에만.
|
||
|
||
#### 포트폴리오 (`wiki/portfolio/`)
|
||
수동 작성. `wiki/projects/` Sources 필수 (concepts 단독 출처 금지). 외부 공개 문장은 `prod-verified` 권장, 최소 `locally-verified`임을 본문에 명시. `published-ready` 상태에서만 외부 공개.
|
||
|
||
#### 블로그 (`wiki/blog/`)
|
||
`/blogify`로 글감/구조만 생성, 본문은 사람이 작성. 공식 개념과 내 해석을 분리.
|
||
|
||
---
|
||
|
||
## 진행 중 프로젝트 노트 (raw/project-notes/)
|
||
|
||
- [[raw/project-notes/ca-skeleton-operational-contract]] — ca-tmpl 운영 계약 canonical SSOT (29 섹션, 43 branch 결정 통합)
|
||
- [[raw/project-notes/project-infra-overview]] — 사용자 본인 프로젝트 인프라 개요 (작성 중, 추후 wiki/projects/로 승급 예정)
|
||
|
||
## 일일 실습 과제 (raw/daily-tasks/)
|
||
|
||
매일 아침 사수→신입 형식의 학습 과제를 두 트랙으로 누적. 각 트랙당 1과제 ~2시간.
|
||
|
||
- **Hub / 트랙 가이드**: [[raw/daily-tasks/README]]
|
||
- **develop 트랙** (`raw/daily-tasks/develop/`): 코드 / 테스트 / ArchUnit / PR 중심. Template: [[templates/daily-task-develop-template]]
|
||
- **infra 트랙** (`raw/daily-tasks/infra/`): manifest / probe / observability / 롤백 drill 중심. Template: [[templates/daily-task-infra-template]]
|
||
- 근거: §Sources 의 Skillable + Red-Green-Code 두 raw — *공식 best practice 아님*, 운영 가능한 학습 구조로만 인용.
|
||
|
||
## 진행 중 프로젝트 (raw/branch-notes/)
|
||
|
||
### keycloak-patterns (2026-05-25 시작)
|
||
|
||
vanilla JS + Keycloak 연동 6가지 패턴(배치 위치 × Google federation) 학습/구현 프로젝트. **P3A (Single EC2, no Google)만 실 구현**, 나머지 5개는 문서/다이어그램까지.
|
||
|
||
- **canonical SSOT**: [[raw/project-notes/keycloak-patterns-overview]] (메인 프로젝트 정의)
|
||
- **root branch**: [[raw/branch-notes/feature-keycloak-patterns]] (작업 진행 인덱스)
|
||
- **34 branch-notes** = root 1 + 6 sub + 27 sub-sub. 세부 hierarchy는 root branch의 진행 인덱스 표 참조.
|
||
|
||
---
|
||
|
||
## Sources / 근거 자료
|
||
|
||
> 이 vault 의 운영 결정 또는 템플릿 설계의 근거로 수집된 외부 자료.
|
||
|
||
- [[raw/company-tech-blogs/skillable-hands-on-lab-structure]] — daily-task-template 의 7-component 구조(Learning Objectives / Storyline / Environment / Exercises / Assessments / Outcomes / Technologies) 근거
|
||
- [[raw/company-tech-blogs/deliberate-practice-software-developers-redgreencode]] — daily-task template 의 deliberate practice 원칙 (현재 능력보다 약간 높은 skill 설계 + 매 반복 후 objective standard 자기평가 + reflection 질문 + Pomodoro 25분 단위) 근거
|
||
|
||
---
|
||
|
||
## 운영 규칙 / 템플릿
|
||
|
||
- [[CLAUDE]] — 본 저장소 운영 규칙 SSOT
|
||
- [[wiki/log]] — 작업 로그
|
||
- [[templates/concept-template]], [[templates/project-template]], [[templates/wiki-project-template]], [[templates/interview-template]], [[templates/raw-source-template]], [[templates/source-summary-template]], [[templates/daily-note-template]], [[templates/branch-note-template]], [[templates/daily-task-develop-template]], [[templates/daily-task-infra-template]]
|
||
|
||
---
|
||
|
||
## 문서 승급 흐름
|
||
|
||
```text
|
||
raw → draft → reviewed → verified → published-ready
|
||
↑ ↑
|
||
└ 파생 가능 └ 외부 공개 가능
|
||
```
|
||
|
||
자세한 단계 정의와 명령별 게이트는 [[CLAUDE]] §15.
|
||
|
||
---
|
||
|
||
## 주요 허브 문서
|
||
|
||
> 새 허브 문서가 생기면 여기에 추가. 개별 문서는 적지 않음.
|
||
|
||
- **개인 투자 (개발과 분리)**: [[wiki/invest/invest-hub]] — 운용 파이프라인 (Claude 전용). 분야 지식 지도: [[wiki/invest-concepts/field-map]] (거시·섹터 카드 + 인과/상관)
|
||
|
||
### ca-skeleton (ca-tmpl) hub
|
||
|
||
`raw/project-notes/ca-skeleton-operational-contract.md` Phase E 합성.
|
||
|
||
- **Project doc hub (16 의사결정)**: [[ca-tmpl]] — 모두 `documented-only` (Phase C2 미진입). 각 결정의 면접 가능 범위 명시.
|
||
|
||
#### 16 concepts (일반 개념 + 표준 + 한계)
|
||
|
||
모두 `status: draft` (review 대기). 각 concept과 1:1 매핑되는 `wiki/projects/ca-tmpl/{topic}.md` project 문서가 존재.
|
||
|
||
- **Core 6 (T1-T6)**:
|
||
- [[wiki/concepts/clean-architecture-package-layout]] — feature-first vs layer-first vs hexagonal vs modulith vs onion
|
||
- [[wiki/concepts/transaction-boundary-abstraction]] — TransactionPort vs `@Transactional`
|
||
- [[wiki/concepts/transactional-outbox-pattern]] — SKIP LOCKED polling vs CDC
|
||
- [[wiki/concepts/api-error-envelope-design]] — custom vs ProblemDetail vs rpc.Status
|
||
- [[wiki/concepts/idempotency-key-design]] — triple scope vs Stripe/Square/Toss
|
||
- [[wiki/concepts/multi-tenancy-isolation-patterns]] — Pool vs Silo vs Bridge
|
||
- **Cross-cutting 10 (G-A ~ G-J)**:
|
||
- [[wiki/concepts/observability-log-metric-trace-runbook]] (G-A)
|
||
- [[wiki/concepts/security-baseline-jwt-actuator-secrets]] (G-B)
|
||
- [[wiki/concepts/data-layer-persistence-cache-outbound]] (G-C)
|
||
- [[wiki/concepts/runtime-container-health-migration]] (G-D)
|
||
- [[wiki/concepts/devops-ci-supply-chain-dx]] (G-E)
|
||
- [[wiki/concepts/api-evolution-and-schema]] (G-F)
|
||
- [[wiki/concepts/skeleton-governance-registry-verification-test-scorecard]] (G-G)
|
||
- [[wiki/concepts/sample-fixture-and-adoption]] (G-H)
|
||
- [[wiki/concepts/config-and-adapter-templates]] (G-I)
|
||
- [[wiki/concepts/privacy-file-domain-modeling]] (G-J)
|
||
|
||
---
|
||
|
||
## Dataview 예시 (Obsidian)
|
||
|
||
```dataview
|
||
TABLE source_type, status, confidence, last_reviewed
|
||
FROM "wiki/concepts"
|
||
SORT last_reviewed DESC
|
||
```
|
||
|
||
```dataview
|
||
TABLE related_projects, status
|
||
FROM "wiki/projects"
|
||
WHERE status = "reviewed" OR status = "verified" OR status = "published-ready"
|
||
```
|
||
|
||
```dataview
|
||
TABLE file.link AS "파생 문서", status, file.outlinks AS "Sources"
|
||
FROM "wiki/interview" OR "wiki/portfolio" OR "wiki/blog"
|
||
WHERE !any(file.outlinks, (l) => startswith(string(l), "wiki/concepts") OR startswith(string(l), "wiki/projects"))
|
||
```
|
||
> 위 쿼리는 canonical 우회 의심 문서(파생인데 concepts/projects 링크가 없는 문서)를 찾습니다.
|
||
|
||
```dataview
|
||
LIST
|
||
FROM "wiki"
|
||
WHERE status = "needs-confirmation" OR status = "stale"
|
||
```
|