Changes between
revision 0 - and
revision 1 - initial
--- Dev Page
+++ Dev Page
@@ -1,1 +1,51 @@
+= [Dev] Page
+== Tables
+=== Page
+
+`Page` 테이블은 페이지 revision 원본을 저장한다.
+
+ * 키: `(site, name, revision)`
+ * 본문: `content`
+ * revision 메타: `dateTime`, `user`, `remoteAddress`, `comment`, `isMinorEdit`
+ * `permRead`는 더 이상 사용하지 않으며 evolution 51에서 제거했다.
+
+최신 본문, history, diff, blame, include, search처럼 revision 원본이 필요한 경로는 `Page`를 직접 읽는다.
+
+=== PageMeta
+
+`PageMeta` 테이블은 페이지별 최신 상태 캐시다.
+
+ * 키: `(site, name)`
+ * `revision`: 최신 revision
+ * `dateInserted`: row 생성 시각
+ * `dateUpdated`: 계산 완료 시각
+ * `image`: 대표 이미지
+ * `size`: 최신 revision의 content length
+
+`PageMeta.permRead`도 evolution 51에서 제거했다. 읽기 권한 판정은 `Permission` 기반으로 처리한다.
+
+== Calculation
+
+페이지 계산 시 `PageLogic.calculate`가 최신 `Page`를 읽고 `PageMeta.upsert`를 수행한다.
+
+대표 이미지는 다음 순서로 선택한다.
+
+ 1. `#!Schema`의 `image` 또는 `logo`
+ 1. 업로드된 `Attachment`
+ 1. `[[Image(...)]]`
+ 1. `[[Attachment(...)]]`
+
+이미지가 없으면 `NULL`로 저장하고 렌더링/API 쪽에서 기본 이미지를 사용한다.
+
+== Read Paths
+
+페이지 이름 목록과 최신 페이지 목록/size는 `PageMeta` 기반 캐시를 사용한다.
+
+ * `AhaWikiCache.PageMeta.SeqPageName`
+ * `AhaWikiCache.PageMeta.SeqPageLatestSummary`
+ * `ContextSite.setPageName`
+ * `ContextSite.seqPageByPermission`
+ * Admin Page 목록과 재계산 대상 선택
+
+페이지 생성, 수정, 삭제, rename 시 관련 `PageMeta` row와 캐시를 갱신하거나 무효화한다.