Mô hình cấu trúc khối và phân phối đồng thuận PBFT

┌──────────────────────────────────────────────────────────┐
│              Permissioned Blockchain Network              │
│                                                          │
│   ┌──────────────┐      ┌──────────────┐                 │
│   │  Validator 1 │      │  Validator 2 │                 │
│   │  Sở KH&CN HN ├──────┤  Operator A  │                 │
│   └──────┬───────┘      └──────┬───────┘                 │
│          │   PBFT Consensus    │                         │
│          └─────────┬───────────┘                         │
│                    │                                     │
│           ┌────────┴────────┐                            │
│           │   Validator 3   │                            │
│           │   Operator B    │                            │
│           └─────────────────┘                            │
│   Finality < 2s  │  f=1 fault tolerance                  │
└──────────────────────────────────────────────────────────┘
          │  Block Store           │  DID Registry
 ┌────────┴──────────┐   ┌────────┴──────────┐
 │   EPCIS Events    │   │  did:nda:hn:*     │
 │   (immutable)     │   │  VC Store         │
 └────────┬──────────┘   └────────┬──────────┘
          └──────────┬────────────┘
                     │
          ┌──────────┴───────────┐
          │  Blockchain Relay    │
          │  (L2 Microservice)   │
          └──────────────────────┘

Biểu đồ SVG quy trình định danh và xác minh W3C DID/VC (On-chain vs Offline)

JSON Mẫu sự kiện EPCIS 2.0 (EPCIS Event JSON Example)

{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/",
  "type": "ObjectEvent",
  "eventTime": "2026-06-01T08:00:00+07:00",
  "epcList": ["urn:epc:id:sgtin:0841234.500123.LOT2026Q1"],
  "action": "OBSERVE",
  "bizStep": "stt95:Growing",
  "readPoint": {"id": "urn:epc:id:sgln:0841000.000015.0"},
  "ilmd": {
    "farmId": "did:nda:hn:farm:001",
    "pesticideTest": "PASSED",
    "harvestDate": "2026-06-01"
  }
}

Đặc tả khóa định danh GS1 (GS1 Spec Table)

Mẫu tài liệu DID Document (did:nda:hn:org:0841234)

{
  "@context": "https://www.w3.org/ns/did/v1",
  "id": "did:nda:hn:org:0841234",
  "verificationMethod": [{
    "id": "did:nda:hn:org:0841234#key-1",
    "type": "Ed25519VerificationKey2020",
    "controller": "did:nda:hn:org:0841234",
    "publicKeyMultibase": "zH3C2AVvLMv6gmMNam3uVAjZpfkcJCwDwnZn6z3wXmqPV"
  }]
}

Danh sách API Endpoints Blockchain Core

Chỉ số hiệu năng cam kết

Sơ đồ luồng Pipeline AI/ML từ Nguồn dữ liệu đến Superset BI

 Data Sources              Processing              Serving
 ┌───────────┐            ┌──────────┐           ┌──────────┐
 │PostgreSQL │──ETL───►   │ Feature  │──Train──► │  Model   │
 │Elastic    │  nightly   │  Store   │  weekly   │ Registry │
 │Kafka MQ   │            └────┬─────┘           └────┬─────┘
 │Zalo API   │                 │                      │
 └───────────┘            ┌────▼─────┐           ┌────▼─────┐
                           │ MLflow   │           │ FastAPI  │
                           │Training  │           │Inference │
                           │Pipeline  │           │  API     │
                           └──────────┘           └────┬─────┘
                                                        │
                                             ┌──────────▼──────────┐
                                             │   PH-01 Dashboard   │
                                             │  Apache Superset BI  │
                                             └─────────────────────┘

Biểu đồ SVG mô phỏng Độ chính xác qua các vòng lặp huấn luyện (Model Precision Curve)

Bảng cấu trúc kiến trúc các mô hình sử dụng

Lịch trình cập nhật và tái huấn luyện mô hình

Kiến trúc kết nối ứng dụng (Integration Architecture)

 ┌──────────────────────────────────────────────────────────┐
 │                    Zalo Platform                          │
 │   ┌─────────────────────────────────────────────┐        │
 │   │          Zalo Mini App (React-based)         │        │
 │   │  ┌─────────┐  ┌────────┐  ┌─────────────┐  │        │
 │   │  │  QR/    │  │ Search │  │  Report     │  │        │
 │   │  │  Scan   │  │ Panel  │  │  Violation  │  │        │
 │   │  └────┬────┘  └───┬────┘  └──────┬──────┘  │        │
 │   └────────┼──────────┼──────────────┼──────────┘        │
 │            │  WebRTC  │  REST        │  POST              │
 └────────────┼──────────┼──────────────┼───────────────────┘
              │          │              │
 ┌────────────▼──────────▼──────────────▼───────────────────┐
 │                  BFF (Backend-for-Frontend)               │
 │              Node.js/Fastify · Redis cache 5min           │
 └─────────────────────────────┬────────────────────────────┘
                               │  Internal API
 ┌─────────────────────────────▼────────────────────────────┐
 │           L2 Platform — API Gateway (Kong)               │
 │  PH-02 Trace · PH-03 ATTP · PH-09 Public API           │
 └──────────────────────────────────────────────────────────┘

 ┌───────────────────────────────────────────────────────┐
 │              iHanoi Open API Integration              │
 │  OAuth 2.0 SSO ◄──► iHanoi · Push Notification OA   │
 └───────────────────────────────────────────────────────┘

Biểu đồ SVG luồng xử lý tương tác qua cổng API Gateway (Sequence diagram)

Danh sách API Endpoint công khai

Mô hình sơ đồ cấu trúc cơ sở dữ liệu và DR Site

 Production DC (Hà Nội)              DR Site
 ┌─────────────────────┐        ┌──────────────────┐
 │  PostgreSQL 16       │  WAL  │  PostgreSQL 16   │
 │  Primary (R/W)      ├───────►  Standby (R/O)   │
 │  Patroni + etcd     │  sync  │  Hot standby     │
 └─────────┬───────────┘        └──────────────────┘
           │ Streaming replication
 ┌─────────▼───────────┐
 │  PostgreSQL 16       │
 │  Replica 2 (R/O)    │
 │  Read-heavy queries  │
 └─────────────────────┘

 ┌─────────────────────┐        ┌──────────────────┐
 │  Elasticsearch 8    │        │  MinIO S3        │
 │  3-node cluster     │        │  Erasure 4+2     │
 │  Shard RF=2         │        │  Multi-site sync │
 └─────────────────────┘        └──────────────────┘

 ┌─────────────────────┐        ┌──────────────────┐
 │  Redis 7 Cluster    │        │  TimescaleDB     │
 │  3M + 3R sentinel   │        │  Time-series ext │
 │  Session/Rate limit │        │  Chunk TTL 2yr   │
 └─────────────────────┘        └──────────────────┘

Biểu đồ SVG cơ chế nhân bản (Replication Topology & DR Site sync)

Bảng cấu trúc lưu trữ và cấu hình an toàn dữ liệu

Sơ đồ liên kết Microservices và Trục Kafka MQ

 ┌───────────────────────────────────────────────────────────┐
 │                API Gateway (Kong)                          │
 │     Rate limiting · JWT validation · Routing              │
 └──┬──────┬──────┬──────┬──────┬──────┬──────┬─────────────┘
    │      │      │      │      │      │      │
 auth  org  product trace cert inspect report  ...
  svc   svc   svc    svc   svc    svc    svc

 ┌────────────────────────────────────────────────────────────┐
 │                 Apache Kafka                                │
 │  attp.trace.events · attp.cert.lifecycle                   │
 │  attp.inspection.results · attp.alerts · attp.audit        │
 │  20+ topics · DLQ per consumer · Consumer groups          │
 └──────────────────────────┬─────────────────────────────────┘
                            │
    ┌───────────────────────┼─────────────────────┐
    │                       │                     │
 ┌──▼──────────┐   ┌────────▼───────┐   ┌────────▼────────┐
 │  Blockchain  │   │  Camunda BPM  │   │   AI Inference  │
 │  Relay Svc   │   │  Workflow Eng │   │   FastAPI       │
 └──┬──────────┘   └────────────────┘   └─────────────────┘
    │
 ┌──▼──────────────────────────────────────┐
 │         Blockchain EPCIS Nodes          │
 │  Validator 1 · Validator 2 · Validator 3│
 └─────────────────────────────────────────┘

Biểu đồ SVG phân bổ Message Broker Kafka (Producers, Topic, Consumers, DLQ)

Danh sách 15 vi dịch vụ cốt lõi

Ma trận kênh truy cập theo người dùng

Biểu đồ SVG quy trình đồng bộ dữ liệu ngoại tuyến (Offline Sync Queue Flow)

Mô hình liên thông dữ liệu qua LGSP

 ┌──────────────────────────────────────────────────────────┐
 │              L4 Integration Layer                        │
 │                                                          │
 │  ┌────────────────────────────────────────────────────┐  │
 │  │          API Gateway + ESB (LGSP TP HN)           │  │
 │  └──┬──────────┬─────────┬──────────┬────────────────┘  │
 │     │          │         │          │                    │
 │   P0:        P0:       P1:        P1:                   │
 │ check.hanoi  LGSP TP  Sở NN&MT  Sở Công Thương        │
 │ (14.635 QR) (data hub) (SX/GLN)  (DN thực phẩm)       │
 │                                                          │
 │     P1: iHanoi API   P1: BYT Cục ATTP   P2: RAR        │
 │     (push/SSO)       (GCN liên thông)   (pháp nhân DN) │
 └──────────────────────────────────────────────────────────┘

Biểu đồ SVG kiến trúc chuyển hướng mã QR cũ sang GS1 (Redirect Proxy workflow)

Kế hoạch di trú 4 giai đoạn

Sơ đồ phân phối hạ tầng cụ thể trên Kubernetes

 Production DC (Hà Nội Tier III)      DR Site (≥15km away)
 ┌──────────────────────────┐         ┌──────────────────────┐
 │  Kubernetes Cluster      │         │  Kubernetes Cluster  │
 │  6–10 worker nodes       │         │  3–5 standby nodes   │
 │  ┌────────────────────┐  │  Repl.  │  ┌────────────────┐  │
 │  │  App Namespaces    │  ├────────►│  │  Passive App   │  │
 │  │  (microservices)   │  │         │  │  (cold standby)│  │
 │  └────────────────────┘  │         │  └────────────────┘  │
 │  ┌────────────────────┐  │  WAL    │  ┌────────────────┐  │
 │  │  PostgreSQL Primary│  ├────────►│  │  PG Standby    │  │
 │  │  Redis Primary     │  │         │  │  Redis Replica │  │
 │  └────────────────────┘  │  MinIO  │  └────────────────┘  │
 │  ┌────────────────────┐  ├────────►│  ┌────────────────┐  │
 │  │  MinIO S3 (4+2 EC) │  │  sync   │  │  MinIO Mirror  │  │
 │  └────────────────────┘  │         │  └────────────────┘  │
 └──────────────────────────┘         └──────────────────────┘
               │                               │
               └──────── WAN (VPN/MPLS) ───────┘

Biểu đồ SVG đường ống CI/CD tự động phát hành và triển khai (CI/CD Pipeline flow)

Bảng tiêu chuẩn kiểm soát an toàn thông tin cấp độ 3

Sơ đồ quy trình (Flowchart ASCII) ghi nhận BulkLotEvent

Xe hàng nông sản vào cổng chợ đầu mối
    │
Cán bộ trạm cổng scan mã QR xe → Nhập dữ liệu trên Mobile App:
    [Loại thực phẩm][Khối lượng (Kg)][Nguồn gốc xuất xứ][Mã GLN NCC]
    │
Hệ thống tự sinh BulkLotID: BL-CHO001-20270601-0045
    │
Đẩy dữ liệu BulkLotEvent (EPCIS 2.0) bất biến lên Blockchain
    │
In mã QR sticker tại trạm cổng → Giao cho sạp tiểu thương dán
    │
┌───────────────────────────────────────┴───────────────────────────────────────┐
│                                                                               │
Người tiêu dùng scan QR tại sạp:                                Cán bộ kiểm tra scan QR sạp:
→ Tra cứu thông tin nguồn gốc lô hàng                           → Tra cứu lịch sử nhập hàng của sạp

Cấu trúc dữ liệu JSON-LD mẫu cho BulkLotEvent (EPCIS 2.0)

// Khai báo sự kiện nhập lô hàng rời tại cổng chợ Đồng Xuân
{
  "@context": "https://ref.gs1.org/standards/epcis/2.0.0/",
  "type": "ObjectEvent",
  "eventTime": "2027-06-01T06:30:00+07:00",
  "action": "ADD",
  "bizStep": "attp:MarketEntry",
  "readPoint": { "id": "urn:epc:id:sgln:0841000.CHO001.CONG1" },
  "ilmd": {
    "bulkLotId": "BL-CHO001-20270601-0045",
    "commodityType": "vegetable",
    "weightKg": 50,
    "originGLN": "urn:epc:id:sgln:0841234.FARM.001",
    "sapGLN": "urn:epc:id:sgln:0841000.CHO001.SAP0123",
    "gateOfficer": "did:nda:hn:officer:cho001-gv"
  }
}

Bảng cấu trúc hệ thống định danh GLN sạp chợ

Sơ đồ quy trình định vị check-in an toàn

Người bán hàng rong mở Zalo Mini App → Nhấn "Bắt đầu bán hôm nay"
    │
Hệ thống lấy tọa độ GPS của thiết bị đúng 1 lần (Opt-in)
    │
Hệ thống đối chiếu: Tọa độ có nằm trong vùng Polygon hành chính (quận/phường) được cấp phép?
    ├─── Đúng ──► Sinh mã QR check-in ngày: QR-20270601-VD009
    └─── Sai  ──► Cảnh báo vi phạm vùng hoạt động / Không kích hoạt QR hôm nay
    │
┌───┴──────────────────────────────────────────────────┐
│                                                      │
Người dân quét mã QR trên xe đẩy:       Cán bộ kiểm tra quét mã QR:
→ Xác thực tên người bán                → Xác định hạn giấy phép lưu động
→ Loại mặt hàng đăng ký                 → Vùng polygon được hoạt động hôm nay
→ Nguồn gốc nguyên liệu sạch            → Lịch sử vi phạm (nếu có)

Đặc tả các trường dữ liệu mở rộng của Giấy phép lưu động

Sơ đồ liên kết chuỗi cung ứng ngược & Đánh giá nguy cơ AI

  [Sóng 1] Vùng sản xuất ──► [Sóng 1] Kho lạnh phân phối ──► [Sóng 1] Siêu thị tiêu dùng
                                      │
                                      ▼ (Mở rộng Sóng 2 qua PH-15 NCC)
                             [Sóng 2] Nhà hàng / Khách sạn
                                      │
                         ┌────────────┴────────────┐
                         │   Recipe Linkage (PH-13)│
                         │   Món ăn A chế biến từ: │
                         │   → Thịt bò (GTIN lô X) │
                         │   → Rau cải (GTIN lô Y) │
                         └────────────┬────────────┘
                                      │
                          [Menu Labeling điện tử]
                          QR Menu quét xem món ăn chế biến từ nguồn nông sản sạch nào
                                      │
  [AI Event Risk Scoring] ◄───────────┘
  Khách khai báo: Tiệc cưới quy mô 300 khách → Risk += 2 (quy mô đông người)
  Phương thức: Buffet                        → Risk += 1 (rủi ro tự phục vụ)
  → Hệ thống tự động đẩy cảnh báo kiểm tra ưu tiên lên Dashboard cho cán bộ

Bảng PH-15 — Cổng API NCC thực phẩm

Public API cho food delivery

GET /api/v1/public/restaurant/{gln}/certificate
→ Trả về: GCN ATTP còn hạn + ngày cấp + Sở cấp
→ Badge "GCN ATTP HN ✓" trên Grab Food / ShopeeFood
Rate limit: 1.000 req/phút/app
Auth: API key đăng ký qua PH-09 (Public API từ Sóng 1)
Cache: 24h

// JSON trả về mẫu:
{
  "restaurantGLN": "0841234500099",
  "restaurantName": "Nhà hàng Sen Tây Hồ",
  "certificateStatus": "VALID",
  "certificateNo": "245/2025/ATTP-HN",
  "issueDate": "2025-10-15",
  "expiryDate": "2028-10-15",
  "issuingAuthority": "Chi cục An toàn vệ sinh thực phẩm Hà Nội",
  "lastInspectionDate": "2027-04-10",
  "riskClassification": "LOW"
}