ข้ามไปที่เนื้อหา

KingMega Back-office Platform — SDLC Blueprint

อัปเดต: 2026-11-17 · เจ้าของ: KingMega

1. ภาพรวมและเป้าหมาย

เอกสารนี้คือ "พิมพ์เขียว" (blueprint) ของระบบหลังบ้าน KingMega / Navamin เพื่อให้ทุกคนในทีม — รวมถึงคนที่เข้ามาทำต่อในอนาคต — เข้าใจและดูแลระบบต่อได้ โดยไม่ต้องพึ่งคนใดคนหนึ่ง

ปัญหาที่แก้: Key-person risk (bus factor)

ระบบที่อยู่ในหัวคนเดียว พอคนนั้นไม่อยู่ ทีมเดินต่อไม่ได้ วิธีแก้คือทำให้ระบบ (1) เป็นโมดูลแยกชัด (2) มีเอกสาร/runbook ครบทุกส่วน (3) มี workflow ที่เห็นภาพและทำซ้ำได้

โครงสร้าง 3 โมดูล + 1 แกน:

  • โมดูล 1 — Operations / Maintenance: ดูแลประจำวัน (backup, config, อัปเดต)
  • โมดูล 2 — Infrastructure / Hardware: VM, server, network, ทรัพยากรหลังบ้าน
  • โมดูล 3 — Internal Developer Platform (IDP): เครื่องมือจัดการหลังบ้านแบบ workflow
  • แกน — Documentation / Runbooks: พาดทุกโมดูล = ตัวจริงที่กัน "ตุย"

2. สถาปัตยกรรม 3 โมดูล

โมดูล หน้าที่ ขอบเขต
1. Operations / Maintenance ทำให้ระบบทำงานต่อเนื่อง backup/restore, config, ต่ออายุ cert, อัปเดต, monitor
2. Infrastructure / Hardware จัดการทรัพยากรและเครื่อง VM/server (GCP + local), DNS/network, storage, hardware, scaling
3. Internal Developer Platform เครื่องมือให้ dev จัดการง่าย dashboard, deploy, ดู log, จัดการ service แบบ workflow orchestration
แกน Documentation / Runbooks ความรู้ที่ทุกคนเข้าถึง architecture docs, runbook ต่อโมดูล, onboarding, change log

หลักการ: แต่ละโมดูลแยกกันชัด ต่อกันผ่าน interface ที่กำหนด (เหมือน microservices) — เปลี่ยน/อัปเกรดทีละส่วนได้โดยไม่ล้มทั้งระบบ

3. กระบวนการพัฒนาแบบ SDLC

ทุกงานในแพลตฟอร์มนี้เดินตาม SDLC 7 เฟส โดยมี Documentation / Training / Change Control วิ่งขวางทุกเฟส

เฟส ชื่อ ทำอะไร ผลลัพธ์ (artifact)
1 Formation ตั้งโจทย์ ประเมินขอบเขต/ต้นทุน ROM, estimate
2 Requirement / Planning เก็บ requirement, วางแผน charter, requirements, SOW
3 Design ออกแบบสถาปัตยกรรม design doc, diagram
4 Construct สร้าง/เขียนโค้ด prototype, code + review
5 Test ทดสอบ test plan, system test
6 Product Release ปล่อยใช้งานจริง acceptance, release note
7 Post-Implementation ดูแล/ปรับปรุง maintenance, enhancement

แกนที่วิ่งขวางทุกเฟส: Documentation (ทิ้งเอกสารไว้ทุกเฟส = กันตุย) · Training (ถ่ายทอดทีม) · Change Control (ทุกการเปลี่ยนแปลงผ่าน change log)

Note

เอกสารฉบับนี้เอง = output ของ SDLC เฟส 1–2

4. สถานะปัจจุบัน (17 พ.ย. 2026)

สิ่งที่สร้างและทำงานจริงแล้ว:

ระบบ รายละเอียด โมดูล เฟส
Strapi CMS cms.kingmega.site — Node 22 + PostgreSQL + PM2 + Nginx + SSL 1, 2 6
Rust service (svc-demo) api.kingmega.site — Axum + PostgreSQL + systemd 2, 3 4
Backup → GCS pg_dump รายวัน 02:30 → bucket + lifecycle (Nearline 30d / ลบ 90d) 1 6
Static IP 136.85.88.8 (DNS ไม่พังตอน restart) 2 6
Documentation Portal docs.kingmega.site — MkDocs (docs-as-code) แกน 4
แยก production strapi-cms-vm แยกจาก agentcore-vm (บอท LINE ไม่กระทบ) 2 6

Info

ทั้งหมดเป็นสคริปต์ reproducible ในโฟลเดอร์ ~/DEV บนเครื่อง Mac

5. Roadmap (เรียงตามความสำคัญ)

  1. Backup Center — หน้าเตือน + ปุ่มดาวน์โหลด backup ให้ครบ 3-2-1 rule — [โมดูล 1 + 3]
  2. Uploads → GCS — ให้ Strapi เก็บไฟล์อัปโหลดลง GCS (durable, ดิสก์ไม่บวม) — [โมดูล 1]
  3. IDP Dashboard v1 — หน้ารวมสถานะ service / VM / DB + ปุ่มจัดการ — [โมดูล 3]
  4. Monthly → local / HDD — download อัตโนมัติ + แจ้งเตือน — [โมดูล 1]
  5. HA / Cloud SQL — ย้าย DB ไป managed + redundancy — [โมดูล 2]
  6. CI/CD + Monitoring — deploy อัตโนมัติ + alert — [โมดูล 3 + 1]

6. Runbooks — วิธีทำต่อ (หัวใจกัน "ตุย")

อะไรอยู่ที่ไหน:

  • Cloud: GCP project ai-secretary-server-512121 (มี billing) / kingmega-erp (ยังไม่มี billing)
  • VMs (zone asia-southeast1-b): strapi-cms-vm = CMS + Rust + backup + docs · agentcore-vm = production (บอท LINE MEGA/NAVA + KingMega API)
  • DNS: GoDaddy โดเมน kingmega.site (cms, api, docs → 136.85.88.8)
  • Backup: GCS bucket kingmega-db-backups-608212006717
  • สคริปต์ทั้งหมด: โฟลเดอร์ ~/DEV บน Mac

งานประจำ:

  • backup รายวันอัตโนมัติ (cron 02:30) → เช็ก bash ~/DEV/verify-backup.sh
  • SSL ต่ออายุเองโดย certbot

พังแล้วแก้เบื้องต้น:

  • Strapi → pm2 restart strapi-cms
  • Rust → sudo systemctl restart svc-demo
  • Nginx → sudo nginx -t && sudo systemctl reload nginx

TODO

เติม runbook ละเอียดต่อโมดูล + ย้าย credential จาก .env ไป secret manager