Files
CleanArchitecture-template/base/02. Requirements/05. Architecture/C4_Context.md

59 lines
2.7 KiB
Markdown

# 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*