Bỏ qua

Bản đồ mã nguồn

Tài liệu này ánh xạ các khái niệm trong tài liệu kỹ thuật sang các file mã nguồn cụ thể. Nó giúp AI và các Nhà phát triển nhanh chóng định vị vị trí code dựa trên ngữ cảnh.

Kiến trúc cốt lõi

Khái niệm Đường dẫn File Vai trò
Blockchain (Base) hierachain/core/blockchain.py Lớp cơ sở quản lý chuỗi, thêm block, kiểm tra tính toàn vẹn.
Block Structure hierachain/core/block.py Định nghĩa cấu trúc Block (Index, Hash, Data, Proof).
Main Chain hierachain/hierarchical/main_chain/base.py Chuỗi chính (Layer 1), chỉ lưu Proof và quản lý Sub-chain.
Sub Chain hierachain/hierarchical/sub_chain/base.py Chuỗi con (Layer 2), xử lý dữ liệu Domain và tạo Proof.
Hierarchy Manager hierachain/hierarchical/hierarchy_manager/base.py Điều phối viên quản lý vòng đời Main/Sub-chain.

Đồng thuận & Sắp xếp (Consensus & Ordering)

Khái niệm Đường dẫn File Vai trò
Ordering Service hierachain/consensus/ordering/service.py Tiếp nhận Event, sắp xếp thứ tự trước khi đóng Block.
Block Builder hierachain/consensus/ordering/block_builder.py Dựng khối từ các sự kiện đã được sắp thứ tự.
Block Manager hierachain/consensus/ordering/block_manager.py Quản lý lifecycle của block trong hệ thống ordering.
Proof of Authority hierachain/consensus/proof_of_authority.py Cơ chế đồng thuận PoA (Nội bộ 1 Doanh nghiệp).
Proof of Federation hierachain/consensus/proof_of_federation.py Cơ chế đồng thuận PoF (Liên minh các MainChain đa tổ chức).
BFT Consensus hierachain/consensus/bft/consensus.py Thành phần đồng thuận chịu lỗi Byzantine riêng.

API và giao diện

Khái niệm Đường dẫn File Vai trò
API Server hierachain/api/server.py Điểm khởi chạy FastAPI server.
API Ledger hierachain/api/ledger/router.py Các API cơ bản (Blocks, Chain info).
API Business hierachain/api/business/router.py API nâng cao (Events, Domain).
API Admin hierachain/api/admin/ API hệ thống (Admin, Health).
WebSocket Manager hierachain/api/websocket/manager.py Quản lý kết nối WebSocket thời gian thực.
GraphQL Schema hierachain/api/graphql/schema.py Schema GraphQL cho truy vấn linh hoạt.
IPFS Client hierachain/api/storage/ipfs_client.py Tích hợp lưu trữ Off-chain (AES-256-GCM).
Blockchain Explorer hierachain/api/blockchain_explorer.py Giao diện phân tích và hiển thị chuỗi.
Điểm khởi chạy API server hierachain/__main__.py python -m hierachain khởi chạy API; hrc phân phối lệnh CLI.
SDK Client hierachain/sdk/client.py Thư viện Python để ứng dụng bên ngoài tương tác với Chain.

Bảo mật và danh tính

Khái niệm Đường dẫn File Vai trò
MSP (Membership) hierachain/security/msp.py Quản lý định danh và chứng chỉ thành viên.
ZK Prover hierachain/security/zk_prover.py Mock phát triển; backend production chưa triển khai.
Policy Engine hierachain/security/policy_engine.py Thực thi các quy tắc kiểm soát truy cập.
Key Manager hierachain/security/key_manager.py Quản lý các khóa mã hóa.
Key Provider hierachain/security/key_provider.py Cung cấp khóa cho Node.
Block Verifier hierachain/security/verify/block_verifier.py Xác thực tính toàn vẹn của Block.
Signature Verifier hierachain/security/verify/signature_verifier.py Xác thực chữ ký số.

Lưu trữ và duy trì dữ liệu

Khái niệm Đường dẫn File Vai trò
SQLite Adapter hierachain/adapters/database/sqlite_adapter.py Bộ lưu trữ cơ sở dữ liệu SQLite nhẹ, hiệu năng cao.
Redis Adapter hierachain/adapters/database/redis_adapter.py Bộ lưu trữ Key-Value cho caching và trạng thái đồng thuận.

Mạng và cụm nút

Khái niệm Đường dẫn File Vai trò
Network Client hierachain/network/network_client.py Giao tiếp & Trao đổi dữ liệu giữa các Node.
ZMQ Transport hierachain/network/zmq_transport.py Giao thức truyền tin trên nền ZeroMQ.
Message Crypto hierachain/network/message_cryptographic.py Ký và xác minh thông điệp P2P để kiểm tra tính toàn vẹn, xác thực và replay.
Peer Trust Manager hierachain/network/peer_trust_manager.py Quản lý độ tin cậy Peer-to-Peer.
Secure Connection hierachain/network/secure_connection.py Thiết lập kết nối an toàn giữa các node.
Cross-Chain Sync hierachain/cluster/cross_level_sync.py Đồng bộ dữ liệu liên tầng (Main <-> Sub).

Giám sát và quản lý rủi ro

Khái niệm Đường dẫn File Vai trò
Alert System hierachain/monitoring/alert_system.py Hệ thống cảnh báo thời gian thực.
Performance Monitor hierachain/monitoring/performance_monitor.py Giám sát hiệu năng hệ thống (CPU, RAM, TPS).
Audit Logger hierachain/risk_management/audit_logger.py Ghi nhật ký kiểm toán cho khả năng truy vết.

CLI và cấu hình

Khái niệm Đường dẫn File Vai trò
Lệnh CLI hierachain/cli/ Các lệnh quản trị được phân phối bởi hierachain/cli/__init__.py, bao gồm key.
Configuration hierachain/config/settings.py Quản lý biến môi trường và cấu hình hệ thống.
Logging Config hierachain/config/logging.py Cấu hình hệ thống ghi log tập trung.

Các module nâng cao

Khái niệm Đường dẫn File Vai trò
Error Mitigation hierachain/error_mitigation/ Cơ chế tự phục hồi (Rollback, Journal).
Integration (ERP) hierachain/integration/enterprise.py Kết nối tới các hệ thống doanh nghiệp bên ngoài.
Domains hierachain/domains/ Logic nghiệp vụ đặc thù tên miền (chains, events, utils).
Quản lý phiên bản hierachain/config/version.py Quản lý phiên bản theo semantic versioning.