source: Add rules for AI Coding

base/02. Requirements/05. Architecture/C4_Context.md

@@ -0,0 +1,58 @@
+# Tài liệu Kiến trúc C4 - Mức 1: System Context (Landing Page)
+
+Tài liệu này mô tả bối cảnh hệ thống của **Landing Page dành cho Sales**, tập trung vào việc hỗ trợ nhân viên kinh doanh trình diễn và khởi tạo bảo hiểm.
+
+## 1. Tổng quan hệ thống
+**Landing Page Sales Party** là ứng dụng web giúp nhân viên kinh doanh đăng nhập, quản lý khách hàng (OCR), và tạo bảng minh họa (PDF) cho các sản phẩm bảo hiểm (UVL-IC, UVL-EL) trên đa thiết bị.
+
+## 2. Personas (Tác nhân)
+
+### Nhân viên kinh doanh (Sales Agent)
+- **Loại**: Người dùng duy nhất.
+- **Mô tả**: Sử dụng Laptop hoặc Mobile để tư vấn trực tiếp cho khách hàng.
+- **Mục tiêu**: Nhập liệu nhanh (OCR), cho xem bảng minh họa tức thì, chốt hợp đồng tại chỗ.
+- **Tính năng chính**: Login, Scan CCCD, Chọn sản phẩm, Xem/Tải PDF, Submit hồ sơ.
+
+## 3. Các hệ thống bên ngoài (External Systems)
+
+### API Authentication (Existing)
+- **Vai trò**: Xác thực tài khoản của Sales Agent.
+- **Giao thức**: REST API / OIDC.
+
+### Dịch vụ OCR (OCR Service)
+- **Vai trò**: Trích xuất thông tin khách hàng từ ảnh CCCD.
+- **Giao thức**: REST API.
+
+### API Illustration PDF (PDF Engine)
+- **Vai trò**: Tính toán quyền lợi và kết xuất file PDF minh họa.
+- **Giao thức**: REST API.
+
+### Hệ thống Core Bảo hiểm (Core System)
+- **Vai trò**: Tiếp nhận hồ sơ yêu cầu bảo hiểm (khi Sales submit).
+- **Giao thức**: REST/SOAP API.
+
+## 4. Sơ đồ System Context (C4 Context Diagram)
+
+```mermaid
+C4Context
+    title System Context Diagram - Landing Page Sales Party
+
+    Person(sales_agent, "Nhân viên kinh doanh", "Sử dụng Landing Page để tư vấn và chốt đơn.")
+
+    System(landing_system, "Landing Page System", "Cho phép nhập liệu KH, xem minh họa và nộp hồ sơ.")
+
+    System_Ext(auth_api, "Auth API", "Hệ thống xác thực tài khoản Sales.")
+    System_Ext(ocr_service, "OCR Service", "Trích xuất dữ liệu CCCD.")
+    System_Ext(pdf_engine, "PDF Generator API", "Tạo file PDF bản minh họa.")
+    System_Ext(core_system, "Core Insurance System", "Ghi nhận hợp đồng.")
+
+    Rel(sales_agent, landing_system, "Truy cập, nhập liệu, xem PDF", "HTTPS")
+
+    Rel(landing_system, auth_api, "Xác thực người dùng", "REST/JSON")
+    Rel(landing_system, ocr_service, "Gửi ảnh CCCD", "REST/JSON")
+    Rel(landing_system, pdf_engine, "Gửi data để lấy PDF", "REST/JSON")
+    Rel(landing_system, core_system, "Submit hồ sơ", "REST/JSON")
+```
+
+---
+*Biên soạn bởi: Agent mbl-landing-page-architecture*