Files
platform-core/docs
DongHyeonka 819f3f14f1 docs(runbooks): add restore, rebuild, upgrade and reboot runbooks
The review found no procedure for losing the host, restoring the k3s
datastore or Gitea, upgrading k3s, or checking the platform after a
reboot, and the existing runbooks live outside version control.

Add five runbooks and a restart-window procedure in docs/runbooks:
after-reboot-checks (clock, k3s and certificates, node, pods in
dependency order, public paths, Prometheus, alerts, runner),
k3s-datastore-restore, gitea-restore (file-only vs full restore, with
the warning that a PITR of the shared database also rewinds Keycloak
and tech-log), k3s-upgrade (patch within a minor), host-rebuild (order
and the easy-to-miss parts: host name for PV node affinity, Tailscale
address in the DNS config, time sync before the first k3s start), and
k3s-restart-window (what to apply in the one restart window, with the
PriorityClasses first). The docs map gains runbooks/ and design/.

Each runbook starts with its preconditions and the commands that check
them; on 2026-11-12 the backups they need are not installed yet, and
they say so.

Risk: documentation only. Restores and the rebuild were not executed.

Verification: a fresh subagent with only these files ran every command
in after-reboot-checks on the desktop and walked the others read-only;
its findings (about 60, e.g. a READY check that missed 0/1 Running
pods, `stable` pointing to another minor, a missing pgAdmin directory,
time sync after the first k3s start) are fixed here. The revised
after-reboot commands were rerun on the desktop and match the text.
Every repository path the runbooks name exists on main or in the
named PR.
2026-11-12 01:38:58 +09:00
..

platform-core 문서 지도

이 폴더는 이 저장소 안에 두는 기록 문서만 담는다. 아키텍처·운영 절차·결정 기록의 정본은 루트 README가 가리키는 중앙 Platform 문서다. 구성요소의 사용법과 적용 절차는 각 디렉터리의 README.md와 bootstrap/manual/에 있다.

폴더 담는 것 수명
runbooks/ 운영 절차(복원, 재구축, 업그레이드, 재부팅 뒤 확인, 재시작 창) 살아 있음
design/ 설계서(결정 전·후) 기록(상태가 있다)
reviews/ 점검·리뷰 결과 기록(쓴 날의 상태)
platform/plans/ 설계 메모 기록
superpowers/plans/ 실행 계획 기록

폴더 이름과 수명 구분은 design-docs conventions/docs-system.md 2절을 따른다. 새 폴더를 만들면 같은 변경에서 이 표에 더한다.

기록 문서의 머리 블록

reviews/·design/에 새로 쓰는 기록은 맨 위에 머리 블록(상태·작성일·요약·현재 정본)을 단다. 형식과 상태 어휘는 design-docs conventions/docs-system.md 4절이 정본이다. 리뷰의 상태는 「진행 중」·「닫힘」 둘이다. 이 절을 만들기 전에 쓴 platform/plans/· superpowers/plans/ 문서에는 머리 블록이 없다.