VTRC Knowledge Manual (V2)

ธีม

3 · Changelog ​

บันทึกการเปลี่ยนแปลงของ "VTRC Knowledge Manual" ระดับ major effort — ไม่ใช่ changelog ของระบบ VTRC เอง แต่เป็น changelog ของเอกสารคู่มือฉบับนี้

v2.1 — 2026-07-14 — Deep Redo (V1-depth) + final VitePress audit ​

สถานะ: supersedes shallow depth ของ v2.0 สำหรับ per-service volumes; cross-cutting Vol 17 master count ยังเป็น baseline

สิ่งที่ทำ:

  • Rewrote Vol 3–9 ให้ใกล้ความลึกของ docs-v1-archive/ (Wave 1 legacy ~17k บรรทัด; Wave 2 domain/2way/meeting/mobile/OCR รวมแล้ว corpus ~52k บรรทัดใน docs/)
  • เพิ่ม Vol 12.5 Critical addendum และ Vol 17.4 debt addendum; rebuild Vol 18 (~1465) และ Vol 19 (~1087)
  • อัปเดต Vol 16 runbook สำหรับ backdoor/bypass incident; foundation Vol 0–2 ใส่สถานะ Deep Redo
  • Final audit: แก้ Vue mustache ใน vtrc-rc-backoffice/03-state-styling-locale.md และแปลง fence ภาษาผิดรูป N:M:path → plain fences; npm run build ผ่าน

ค้าง (ไม่บล็อก build): reconcile ตัวเลข 275 ใน Vol 17 master กับ Critical IDs ใหม่จาก deep scorecards; refresh เบา ๆ ของ Vol 11/13/14/15 จากแหล่ง deep ใหม่

v2 — 2026-07-13 — Full platform re-scan + tech debt/security/roadmap volumes ​

สถานะ: superseded docs-v1-archive/ ทั้งฉบับ — v1 ครอบคลุมเฉพาะ legacy 5 service (vtrc-api, cu-central-api, centralize-api, vtrc-web, vtrc-rc-backoffice) ส่วน v2 ครอบคลุมทั้ง ~30 repository ใน 7 กลุ่มแพลตฟอร์ม

สิ่งที่ทำ:

  • Re-scan ทุก repo ในเวิร์กสเปซใหม่ทั้งหมด (รวม repo ที่ไม่มีในตอนเขียน v1 เช่นกลุ่ม 2way platform, domain microservices, meeting platform, mobile รุ่นใหม่, OCR/aux) ตอนที่ทุก repo พร้อมอยู่ในเวิร์กสเปซแล้ว
  • เขียนเอกสารระดับ v1-depth ให้ครบทุก repo — แต่ละ repo มี deep-dive volume ของตัวเอง (Vol 3-9) ครอบคลุม stack, entrypoint, port, data store, auth mechanism, integration, deploy config, และ scorecard
  • ขยาย canonical-truths ให้ครอบคลุมทั้ง 7 กลุ่มแพลตฟอร์ม (เดิม v1 ครอบคลุมแค่ legacy core) พร้อมยืนยัน branch topology ของ repo ที่ default branch ว่าง/ไม่ตรงกับ branch production จริง
  • สร้าง Volume 17 · Technical Debt Register — รวบรวมทุก debt item จาก scorecard ของ Vol 3-9 (29 ไฟล์ scorecard) เข้าเป็นทะเบียนกลางเดียว 275 รายการ พร้อมจัดกลุ่มตาม category และ severity
  • สร้าง Volume 18 · Security Review Findings — ขยายรายละเอียด SEC- item ทั้งหมด (Critical 44, High 30) เป็นรายงาน security review เต็มรูปแบบพร้อมผลกระทบและการแก้ไขที่แนะนำ และวิเคราะห์ systemic pattern ที่ปรากฏซ้ำข้ามหลาย repo
  • สร้าง Volume 19 · Modernization Roadmap — จัดทุก debt item เข้า 4 wave ตามความเร่งด่วน พร้อม quick-win list และคำแนะนำระดับสถาปัตยกรรม 10 ข้อที่ไม่ผูกกับ debt ID เดียว
  • สร้าง Volume 20 · Appendices — glossary ของคำศัพท์/acronym ที่ใช้ซ้ำทั้งเล่ม, ดัชนี debt ID แบบ flat พร้อม cross-reference ไปยัง wave, และ changelog ฉบับนี้

ตัวเลขสรุป: 275 debt item จาก 29 repo ที่มี scorecard (จาก ~30 repo ที่มีโค้ดจริง ไม่รวม 8 placeholder repo ที่ยังไม่มีโค้ด และ interns_playground) — Critical 46, High 69, Medium 149, Low 11 — แบ่งเป็น SEC 89, QUAL 99, CORR 30, LEG 22, OBS 24, PERF 11

ผลกระทบต่อผู้อ่าน: หากอ้างอิงเนื้อหาจาก docs-v1-archive/ ให้ตรวจสอบกับ Vol 3 (vtrc-api, cu-central-api) และ Vol 4 (vtrc-web, vtrc-rc-backoffice) ของ v2 ก่อนใช้งาน เพราะบางจุดใน v1 ถูกแก้ไขจาก re-verify รอบนี้ (ดู canonical-truths.md สำหรับรายการที่ยืนยันแล้ว)

v1 — (ก่อนหน้า, ดู docs-v1-archive/) ​

เอกสารต้นฉบับ 17 volume ครอบคลุมเฉพาะ legacy 5 service — เก็บไว้เป็น reference ที่ docs-v1-archive/ ไม่มีการแก้ไขเพิ่มเติมนับจากนี้ เนื้อหาบางส่วนอาจ stale เมื่อเทียบกับ v2