Document Groups

Audit ของทุกเอกสารภายใต้ console.pattayatogether.com · จัดเป็น 6 กลุ่มตามหลักฐานในไฟล์จริง · ทุกเอกสารย้อนกลับถึง Main Console ได้ · อ้างอิง / cross-group references ชัดเจน

Landing Live · scaffold Batch 6 · document-IA Start Audit · v1.0 A-owned

User · Access · ผู้ใช้และสิทธิ์ local/dev scaffold · no backend · create or switch profile to test visibility

Current access summary · สรุปสิทธิ์ปัจจุบัน

Stakeholder filter · ตัวกรองผู้มีส่วนได้ส่วนเสีย click to toggle · multi-select · filters the audience cards below

Stakeholder · ผู้มีส่วนได้ส่วนเสีย

Overview Audit of every document · grouping rationale · how to navigate

Thailand-Together console ปัจจุบันมีเอกสารทั้งหมด 108 หน้า HTML (รวม main console, operations, planning, runtime, demos, KB, docs). ก่อน batch นี้ การจัดกลุ่มเกิดจากประวัติการพัฒนา ไม่ใช่ audit ที่อิงเอกสารจริง. หน้านี้เป็นผลของ audit ใหม่ที่ Claude วิเคราะห์เอกสารทั้งหมดใน repo แล้วเสนอ 6 กลุ่มหลัก: Start · Knowledge · Planning · Runtime · Operations · Journey.

ทุกเอกสารกลับไปที่ Main Console ได้ผ่านปุ่ม "← Console" ที่มุมซ้ายบน (ส่วนหนึ่งของ Universal Document Shell). Cross-group references ระบุไว้ชัดเจนเพื่อป้องกันเอกสารถูกฝังอยู่ในกลุ่มเดียวโดยตัดขาดจากกลุ่มอื่น.

Key Point ประเด็นสำคัญที่สุดของเอกสารนี้

6 กลุ่มเอกสาร · ทุกเอกสารย้อนกลับถึง Main Console · ทุกเอกสารมีที่อยู่ชัดเจน. Grouping ที่เสนอจะไม่ลบเอกสารใด · ไม่เปลี่ยน route เดิม · ไม่ลดจำนวน destination ที่มีอยู่ · แต่เพิ่ม metadata layer ที่บอกว่าเอกสารไหนอยู่กลุ่มไหน เพราะอะไร และเชื่อมข้ามกลุ่มอย่างไร.

Universal Document Shell เริ่มใช้งานจริงได้แล้วบนหน้านี้ (ลอง Print · Copy link · สลับ mode · เพิ่ม note ด้านล่าง). หน้าอื่น opt-in โดยการ link assets/document-shell.css + assets/document-shell.js และตั้ง data-ds-doc-id.

Executive Summary 3 ย่อหน้า · อ่านใน 60 วินาที

Console มีเอกสารหลากหลายประเภท — main portal, planning (RFC + phase), runtime (scaffold + service), KB (documents + data), demos, catalogs. Audit นี้พบว่าเอกสารจริงตกลงในกลุ่มใหญ่ 6 กลุ่มโดยธรรมชาติ. ทุกเอกสารได้รับ primary group และอาจมี secondary references ไปกลุ่มอื่น.

Universal Document Shell (shared CSS + JS) ให้เอกสารทุกหน้ามี pattern เดียวกัน: back-to-console, breadcrumb, identity header, sub-tabs 2-mode, key point, summary, purpose, audience, reading flow, missing gaps, glossary, references, checklist, change log, export affordance, และ notes/requirements loop. Body text ≥ 16pt. Note text = 14pt. Content full-width.

Notes/Requirements system เก็บที่ browser localStorage ในรอบนี้ (scaffold). Schema พร้อมสำหรับการอัปเกรดเป็น server backend ในอนาคต. AI periodic sweep เป็น MODEL only (ยังไม่มี scheduler) · ใช้เป็นแม่แบบให้ Batch 6+ ทำจริง.

Purpose วัตถุประสงค์ของหน้านี้และของระบบจัดกลุ่ม

ลดความสับสนของผู้ใช้ใหม่ที่เจอเอกสารจำนวนมาก
ให้ executive + developer + governance team มีแผนที่เอกสารร่วมกัน
รักษา discoverability เดิมไว้ — ไม่ลบเอกสารใด · ไม่ซ่อน route
เป็น reference implementation ของ Universal Document Shell ที่หน้าอื่น copy ไปใช้ได้
เปิดให้ note/requirement ถูกเก็บตามรายหน้าเพื่อไม่ให้สิ่งต้องทำหายไป

Audience ใครควรอ่านหน้านี้ก่อน

Persona	Why read this	Next stop
Executive · new to project	Understand breadth of system docs in 60s	Journey Hub (tab 7)
Developer · picking up a ticket	Find the right document family to search in	Planning or Runtime group
Governance / QA	See which documents still lack metadata / glossary / checklist	"What's missing" tab
Operator	Map docs to operational responsibility	Operations group + Checklist tab

6 Main Document Groups อ้างอิงเอกสารจริงใน repo

#	Group	What's in it (from real repo)	Rationale	Cross-refs
1	Start Main portal surfaces	`index.html` · `hub.html` · `portal.html` · `links.html` · `index-portal.html` · `operations-portal.html` · `journey-console.html` · `ai-content-dashboard.html` · `merchant` surfaces	Entry points · the first click from `console.pattayatogether.com`. Must be discoverable without prior knowledge.	→ Operations (portal) · → Journey (tab 7) · → Knowledge (KB link)
2	Knowledge KB / Document Portal	`docs/kb/` (32 HTML pages) · `docs/kb/data/` (B-owned JSON contracts) · `document_index.json` (24 indexed docs)	B-owned authoritative content. Grouped tabs inside (Portal/Commercial/Executive/Knowledge/Journey/Operations/Meta) already in place.	→ Journey (journey-intelligence-system) · → Planning (concepts/canonical/derived)
3	Planning RFC + phase docs	`docs/planning/*` (20 HTML pages) — feature-flags · admin-control-plane · runtime-continuation · batch-4-readiness · cross-runtime-integration · ia-governance · discovery-audit	A-owned design / RFC / phase-gate documents. Not yet implemented OR documenting acceptance gates.	→ Runtime (each planning doc has a runtime peer) · → Knowledge (canonical references)
4	Runtime Service + scaffold code pages	`docs/runtime/*` (17+ HTML pages) — feature-flags-service · admin-control-plane-service · cross-runtime-integration · wizard · enterprise-upload · intake-workspace · generated-assets · daily-queue	A-owned runtime surfaces · contract-bound previews · file-backed or decode-only in most phases. "The code face" of the planning docs.	→ Planning (every runtime has a matching planning doc) · → Operations (daily-queue · generated-assets)
5	Operations Monitoring + portal + dashboards	`operations-portal.html` · `dashboard.html` · `datasource-dashboard.html` · `hotel-dashboard.html` · `feature-tracker.html` · `feature-requests.html`	Day-to-day operator surfaces. Entry and tracking for people running the system live.	→ Start (operations-portal is linked from main console) · → Runtime (drills into runtime pages)
6	Journey Intelligence system + demos	`journey-console.html` (A-owned hub · tab 7) · `docs/kb/journey-intelligence-system.html` (B-owned content) · `docs/kb/data/journey_*.json` (6 contract files) · `journey.html` (tourist demo · separate)	Largest data surface. Has its own tab on main console because the user explicitly requested it in a prior batch.	→ Knowledge (KB authoritative content) · → Planning (instrumentation planning)

Cross-group references เอกสารที่อยู่ได้หลายกลุ่ม

Not every document sits cleanly in one group. Below are the principal cross-cut relationships.

Document	Primary	Also appears in	Why
`operations-portal.html`	Start	Operations	Portal page AND operational entry.
`journey-console.html`	Start	Journey	Main-console tab 7 AND Journey group landing.
`ia-governance.html`	Planning	Knowledge · Operations	Governance affects all groups.
`cross-runtime-integration.html`	Planning	Runtime	Planning doc directly describes runtime demos.
`feature-flags-batch-4-readiness.html`	Planning	Runtime	Plan consumed by runtime artefacts.
`docs/kb/journey-intelligence-system.html`	Knowledge	Journey	Authoritative content for the Journey group.
`daily-queue` runtime	Runtime	Operations	12E.1 cadence is operational.

Reading flow อ่านก่อน · อ่านต่อ

Read before this

Main Console — understand the 7-button layout first
IA Governance — read the rules that govern document structure

What's missing · honest gaps อะไรที่ยังไม่ครอบคลุม

Legacy pages docs/feature-catalog.html, docs/feature-tracker.html, docs/hotel-dashboard.html have NOT been retrofitted with the shell · they keep their existing inline styling.
All B-owned docs/kb/*.html content pages keep their own kb.css presentation · shell is OPT-IN only.
Planning / runtime pages from Batch 1–4 retain their own inline styles · grouping badge not yet rendered per-page.
Notes system is browser-local ONLY · no cross-device sync · no server-side persistence.
AI periodic sweep is a MODEL · no cron · no queue · no automated triage running.
Mobile viewport < 480px has minimal compact fallback only · no hamburger menu.

Glossary คำเฉพาะที่หน้านี้ใช้

Document Shell: Shared CSS + JS bundle that standardizes header, sub-tabs, sections, and notes across pages. Pages opt in by linking assets/document-shell.css and assets/document-shell.js.
data-ds-doc-id: Attribute on the root <html> element that uniquely identifies a document for notes storage. Stable across renames.
Sequential mode: Sub-tab order optimized for linear reading: Overview → Context → Main → Checklist → Related → References → Changelog → Notes.
Importance mode: Sub-tab order optimized for skimming: Key Point → Summary → Main → Risks → Checklist → Related → Notes → Full → References.
Cross-group reference: A document's pointer to another group when it serves more than one role.
Terminal state (notes): A note status that ends the lifecycle: done or rejected. Reopen is allowed but audit trail records the oscillation.
Periodic sweep model: A specification for an AI routine that reviews note backlog. Model-only in this batch — no live scheduler.

References ลิงก์ที่เกี่ยวข้อง · ภายใน/ภายนอก

Checklist สิ่งที่ต้องทำต่อเพื่อให้ครบ 100%

☐ Retrofit Planning + Runtime pages to link document-shell.css + document-shell.js
☐ Retrofit KB content pages (coordinate with B session — presentation-layer only)
☐ Per-document add data-ds-doc-id on root <html>
☐ Populate Key Point / Summary / Glossary / References / Checklist on top-10 highest-traffic docs first
☐ Server-side notes persistence (per schema) — Batch 7+
☐ Implement AI periodic sweep scheduler (consumes sweep_model.json) — Batch 7+
☐ Mobile hamburger fallback below 480px
☐ PDF export template (beyond window.print) if needed

Change log ประวัติการแก้ไขเอกสารนี้

Date	Commit	Change	By
2026-04-19	`(this commit)`	Initial creation · part of Batch 6 Document-IA + Note-loop	Session A

Export พิมพ์ · คัดลอกลิงก์ · เปิด source

Use the top bar buttons, or the buttons below.

📄 Open note schema 📘 Shell standard

Access · สิทธิ์การเข้าถึง current profile · what this page reveals under your access

Full model: planning/document-access-model.html

Notes · Requirements · Improvement Requests เพิ่มได้ตลอดเวลา · เรียงเก่าสุด/ใหม่สุด · บันทึกใน browser

Honest state: Notes are stored in this browser only (localStorage key ds.notes:/document-groups.html). They do not sync across devices. There is no server backend yet. AI periodic sweep is a model — no scheduler is running. See planning/document-note-system.html for the full contract and roadmap.