Kiến trúc Hệ thống

┌─────────────────────────────────────────────────────┐
│                    CLIENT LAYER                      │
│  Web App (Angular)  │  Mobile App  │  3rd-party API  │
└──────────────┬──────────────────────────────────────┘
               │ HTTPS / REST / WebSocket
┌──────────────▼──────────────────────────────────────┐
│                 API GATEWAY (NestJS)                 │
│     Auth  │  Rate Limiting  │  Load Balancing        │
└──────┬──────────────────────────────────────┬────────┘
       │                                      │
┌──────▼──────────┐                 ┌─────────▼────────┐
│  Contract       │                 │  Signing         │
│  Service        │                 │  Service         │
│  (NestJS)       │                 │  (NestJS)        │
└──────┬──────────┘                 └─────────┬────────┘
       │                                      │
┌──────▼──────────┐                 ┌─────────▼────────┐
│  PostgreSQL DB  │                 │  HSM / CA        │
│  (Hợp đồng,    │                 │  (Chứng thư số,  │
│   Người dùng)  │                 │   Private Key)   │
└─────────────────┘                 └──────────────────┘
       │
┌──────▼──────────┐
│  File Storage   │
│  (MinIO / S3)   │
└─────────────────┘

Người dùng → [Web App] → POST /api/signing/initiate
                              ↓
                    [Signing Service]
                    Tạo hash của PDF
                              ↓
                    Gửi hash → HSM/Token ký
                              ↓
                    Nhận chữ ký số (signature bytes)
                              ↓
                    Nhúng chữ ký vào PDF (PAdES)
                              ↓
                    Lưu PDF đã ký vào Storage
                              ↓
                    Cập nhật trạng thái hợp đồng → DB
                              ↓
                    Thông báo bên ký tiếp theo