source: update Base rule Agent

This commit is contained in:
2026-03-09 18:01:01 +07:00
parent 3003a0ff0b
commit fd9f558fa1
22 changed files with 501 additions and 1426 deletions

View File

@@ -1,58 +1,58 @@
# Tài liệu Kiến trúc C4 - Mức 1: System Context (Landing Page)
# C4 Architecture Document - Level 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.
This document describes the system context of the **Sales Landing Page**, focusing on supporting sales agents in presenting and initiating insurance policies.
## 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ị.
## 1. System Overview
The **Landing Page Sales Party** is a web application that helps sales agents log in, manage customer data (OCR), and generate illustration boards (PDFs) for insurance products (UVL-IC, UVL-EL) across multiple devices.
## 2. Personas (Tác nhân)
## 2. Personas (Actors)
### 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ơ.
### Sales Agent
- **Type**: Primary User.
- **Description**: Uses a Laptop or Mobile device to consult directly with customers.
- **Goal**: Rapid data entry (OCR), instant presentation of illustration boards, and on-the-spot contract closure.
- **Key Features**: Login, Scan ID Card, Select Product, View/Download PDF, Submit Application.
## 3. Các hệ thống bên ngoài (External Systems)
## 3. 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.
- **Role**: Authenticates the Sales Agent's account.
- **Protocol**: 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.
### OCR Service
- **Role**: Extracts customer information from ID Card images.
- **Protocol**: 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.
### Illustration PDF API (PDF Engine)
- **Role**: Calculates benefits and renders the illustration PDF file.
- **Protocol**: 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.
### Core Insurance System (Core System)
- **Role**: Receives the insurance application (upon Sales submission).
- **Protocol**: REST/SOAP API.
## 4. Sơ đồ System Context (C4 Context Diagram)
## 4. System Context Diagram (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.")
Person(sales_agent, "Sales Agent", "Uses the Landing Page to consult and close deals.")
System(landing_system, "Landing Page System", "Cho phép nhập liệu KH, xem minh họa và nộp hồ sơ.")
System(landing_system, "Landing Page System", "Allows customer data entry, viewing illustrations, and submitting applications.")
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.")
System_Ext(auth_api, "Auth API", "Sales account authentication system.")
System_Ext(ocr_service, "OCR Service", "Extracts ID Card data.")
System_Ext(pdf_engine, "PDF Generator API", "Generates the illustration PDF file.")
System_Ext(core_system, "Core Insurance System", "Records the contract.")
Rel(sales_agent, landing_system, "Truy cập, nhập liệu, xem PDF", "HTTPS")
Rel(sales_agent, landing_system, "Accesses, inputs data, views 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")
Rel(landing_system, auth_api, "Authenticates user", "REST/JSON")
Rel(landing_system, ocr_service, "Sends ID image", "REST/JSON")
Rel(landing_system, pdf_engine, "Sends data to fetch PDF", "REST/JSON")
Rel(landing_system, core_system, "Submits application", "REST/JSON")
```
---
*Biên soạn bởi: Agent mbl-landing-page-architecture*
*Authored by: Agent mbl-landing-page-architecture*