Skip to main content

Chic Car Rent — System Manual

เอกสารนี้รวบรวมคู่มือระบบ Chic Car Rent (CCR) สำหรับทีม Dev, QA, BA, Support และผู้ดูแลระบบ โดยจัดรูปแบบเดียวกับเอกสาร TMSTH: มีภาพรวมระบบ, flow สำคัญ, API, database, testing และ operations

เอกสารชุดนี้อ้างอิงจาก code ปัจจุบัน, OpenAPI JSON ใน ccr-architect-design/api-specification, PlantUML sequence diagrams, Auth0/APIM notes, permission list, Playwright test suite และ BRD ใน _docs

ระบบนี้เชื่อมกันอย่างไร​

ภาพรวมหลักของระบบคือ: ลูกค้าค้นหารถและทำ booking ผ่าน Customer Web → Booking Service สร้างรายการจอง → Payment Service รับชำระเงิน → Backoffice ใช้ดูแล booking, refund และ master data

System Overview

จำง่าย ๆ

ถ้าตามหา “รถ ราคา สาขา โปรโมชัน add-on” ให้เริ่มที่ Catalog Service
ถ้าตามหา “รายการจอง แก้ไข booking ยกเลิก refund” ให้เริ่มที่ Booking Service
ถ้าตามหา “user, role, customer, consent” ให้เริ่มที่ User Service
ถ้าตามหา “payment transaction, webhook, QR, card” ให้เริ่มที่ Payment Service

บริการในระบบ​

Booking Service

แกนหลักของ booking lifecycle ตั้งแต่สร้าง booking, ดูรายละเอียด, แก้ไข, ยกเลิก และ refund

  • Customer booking และ backoffice booking
  • Booking status และ booking history
  • Refund status workflow
  • Email queue และ running number
เปิดเอกสาร

Catalog Service

จัดการข้อมูลที่ใช้ค้นหาและขายรถเช่า เช่น car, branch, add-on, fuel, promotion และ one-way rental

  • Public search และ price quote
  • Master data สำหรับ backoffice
  • Signed URL สำหรับรูปภาพ
  • ข้อมูล sync จาก CarPro
เปิดเอกสาร

User Service

ดูแล identity ฝั่ง backoffice และ customer รวมถึง role permission, consent และข้อมูลติดต่อ

  • Users, Roles, Permissions
  • Customers, Groups, Tiers
  • Register Policy consent
  • Auth0 / APIM integration
เปิดเอกสาร

Payment Service

จัดการ payment transaction, payment method, webhook และ real-time payment subscription

  • Initiate payment
  • Omise webhook
  • Payment by booking
  • Bank master data
เปิดเอกสาร

วิธีใช้เอกสารนี้​

สำหรับ Dev

เริ่มจาก Architecture Overview เพื่อเห็น service boundaries แล้วอ่าน domain ที่กำลังแก้ เช่น Booking หรือ Catalog ก่อนลงรายละเอียด API/database

สำหรับ QA

เริ่มจาก Testing เพื่อดู test suite ที่มีอยู่ และใช้ flow document ใน Booking / Frontend เป็น baseline สำหรับออก test case เพิ่ม

สำหรับ Support / BA

เริ่มจาก Frontend Menu & Permission และ Customer Booking Flow เพื่อเข้าใจหน้าจอและขั้นตอนที่ผู้ใช้เจอจริง