A.5 Volume cross-reference — matrix ระหว่าง volume
แสดงความสัมพันธ์ระหว่าง volume — เมื่ออ่าน volume หนึ่งแล้วต้องการเนื้อหาที่เกี่ยวข้อง ให้ดู column ของ volume นั้น
วิธีอ่าน matrix
- แถว = volume ที่เป็น source (อ้างถึง)
- คอลัมน์ = volume ที่เป็น target (ถูกอ้างถึง)
- เครื่องหมาย ✓ = source อ้างถึง target
Matrix
| จาก \ ไป | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 Getting Started | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 1 Business | ✓ | — | ✓ | ✓ | ||||||||||||
| 2 Architecture | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| 3 vtrc-api | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| 4 cu-central-api | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| 5 centralize-api | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| 6 vtrc-web | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| 7 backoffice | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| 8 Data Model | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| 9 Security | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| 10 API Reference | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ||||
| 11 Business Logic | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | |||
| 12 Infrastructure | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | |||
| 13 Runbooks | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| 14 Tech Debt | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | |
| 15 Modernization | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
ความสัมพันธ์สำคัญ
Volume ที่ถูกอ้างถึงมากที่สุด (hub)
| Volume | ถูกอ้างโดย | หน้าที่ในฐานะ hub |
|---|---|---|
| Vol 0 Getting Started | ทุก volume | ประตูเข้า — เชื่อมโยงไปทุกเล่ม |
| Vol 2 Architecture | 13 volume | ภาพรวมระบบ — ใช้เป็น reference ของทุกเล่ม |
| Vol 9 Security | 14 volume | threat model + auth — ใช้ตรวจสอบผลกระทบ |
| Vol 14 Tech Debt | 14 volume | debt register — source of truth ของ debt |
| Vol 8 Data Model | 13 volume | schema + ERD — ใช้ cross-check |
Volume ที่อ้างถึงคนอื่นมากที่สุด (spoke)
| Volume | อ้างถึง | เหตุผล |
|---|---|---|
| Vol 13 Runbooks | 15 volume | runbook ต้องอ้างทุกเรื่อง |
| Vol 14 Tech Debt | 15 volume | debt อยู่ในทุกส่วนของระบบ |
| Vol 15 Modernization | 15 volume | migration กระทบทุกส่วน |
คู่ volume ที่อ้างถึงกันบ่อย
| คู่ | เหตุผล |
|---|---|
| Vol 3 ↔ Vol 8 | vtrc-api ใช้ model ของ Vol 8 |
| Vol 3 ↔ Vol 9 | auth + RBAC อยู่ใน vtrc-api |
| Vol 3 ↔ Vol 14 | debt ส่วนใหญ่อยู่ใน vtrc-api |
| Vol 6 ↔ Vol 7 | frontend ทั้งคู่มี pattern เดียวกัน |
| Vol 14 ↔ Vol 15 | modernization plan อ้าง debt ID ทุกตัว |
เส้นทางอ่านแนะนำ
สำหรับ engineer ใหม่
0 → 2 → 3 → (8 หรือ 9) → เลือกตาม taskสำหรับ auditor
0 → 2 → 9 → 14 → (ตามด้วย volume ของ repo ที่ audit)สำหรับ operator
0 → 13 → 12 → (ดู Vol 1 ถ้าต้องเข้าใจ business)สำหรับ architect ที่วางแผน modernization
0 → 2 → 14 → 15 → (ดู Vol 3-7 สำหรับ detail ของ repo ที่จะ modernize)cross-reference ที่ต้องระวัง
Vol 2 → Vol 4/5
Vol 2 (Architecture) เคยเขียนผิดว่า vtrc-api เรียก NestJS centralize-api — ความจริง vtrc-api เรียก cu-central-api (Node.js Apollo; CODE_DEFAULT APP_PORT=8080, CLIENT_TARGET ใน vtrc .env.example อาจเป็น 8082) ผ่าน END_POINT_CENTRALIZE (ดู A.8 Changelog)
Vol 14 → Vol 15
Vol 15 อ้าง debt ID จาก Vol 14 โดยตรง — ถ้า debt ID เปลี่ยน Vol 15 ต้องอัปเดตตาม