System Architecture 系统架构


AI-native global trade intelligence — 8 autonomous agents, 8 ETL pipeline jobs, pgvector-powered RAG KB, and a self-evolving feedback loop.
AI原生全球贸易智能基础设施 — 8个自主AI智能体,8个ETL数据管道作业,pgvector驱动的RAG知识库,持续进化的反馈闭环。

8
AI Agents AI智能体
23
API Modules API模块
52
Frontend Pages 前端页面
192
Test Cases 测试用例
75
Trade Data Records 贸易数据记录
120
Python Modules Python模块

Operational vs In Progress 已运行 vs 开发中

Neon pgvector
DeepSeek v4-pro
8个ETL作业
52页面已部署
110+ API端点
WebSocket/SSE
SHA-256审计链
证书PDF API
飞轮DB持久化
反馈pgvector
Shopify Webhooks
影子管道
租户子图谱
数据脱敏过滤器
批量清单引擎
托管网关
Sentry监控
GitHub CI/CD
192测试
管理10标签页
75条贸易数据
JWT+OAuth认证
Vercel定时任务
裁决注入引擎
EDI报文编排器
OFAC/BIS/EU/UN同步
关税实时同步(WTO+Comtrade)
Neo4j迁移(>5M节点)
企业SLA(商业条款)
28项已运行 2项计划中(非工程项)

Not Shell AI. Compliance Infrastructure. 不是AI套壳。是合规基础设施。

After P0 (Compliance Assertion Engine + Immutable Audit) and P1 (Shadow Graph Pipeline + Tenant Sub-Graphs) enhancements — Aegis is now a full compliance infrastructure platform, not an AI wrapper.
经过P0(合规断言引擎 + 不可变审计链)和P1(影子图谱管道 + 租户子图谱)增强 — Aegis现在是完整的合规基础设施平台,而非AI套壳。

L5 — 表现层 · 52页面 · 管理控制塔(10标签页) · 客户端仪表板 · Shopify应用
L4 — API网络 · 23模块 · 110+端点 · WebSocket/SSE · OpenAPI 3.1
★ P0: 合规断言引擎
15条规则 · 裁决引用 · PDF证书
★ P0: 不可变审计链
SHA-256 · 哈希链 · 防篡改
★ P1: 影子图谱管道
Shopify OAuth → 租户子图谱
L3 — AI智能体 · 8个专业代理 · LangGraph · DeepSeek v4-pro
产品国家货运监管★ 断言引擎监控冲突循环工
★ P1: 审计发现报告 — 首次登录自动生成 · 税收追回估算
L2 — Trade Graph核心 · 5万+节点 · 21.8万+边 · 实体解析 · BFS遍历
★ P1: 租户子图谱·用户权威评分·加权边插入·Golden Set
L1 — 基础设施 · Neon PostgreSQL + pgvector · 8个ETL作业 · Sentry · GitHub Actions
每日: 制裁·每周: 关税·裁决·实体·出口管制·飞轮健康·每月: HS编码
持续反馈闭环 — 用户修正 → 向量化 → Golden Set → 再训练 → 精度提升 · 自进化智能

Full-Stack Architecture — 5 Layers, 8 Agents, 8 ETL Jobs 全栈架构 — 5层架构 · 8个智能体 · 8个ETL作业

End-to-end data flow from ingestion to decision — every layer connected by a continuous feedback loop that vectorizes corrections to pgvector.
从数据摄取到决策输出的端到端数据流 — 每一层都通过持续反馈闭环连接,将用户修正向量化至pgvector。

Layer 5 — Client Channels 客户端渠道
Website· Dashboard· Shopify· WooCommerce· Zapier
REST API
23 modules · 110+ endpoints 23个模块 · 110+端点
WebSocket / SSE
Real-time push 实时推送
JWT + OAuth
Google · Microsoft · Apple
Rate Limiting
100 req/min · API keys 速率限制
OpenAPI 3.1
Auto-generated SDKs 自动生成SDK
Product
HS + ECCN 产品代理
Party
Sanctions + UBO 方代理
Country
Tariffs + FTA 国家代理
Shipment
Landed Cost 货运代理
Regulatory
CBAM + License 监管代理
Monitoring
Alerts + Drift 监控代理
Conflict
5-Factor Priority 冲突解决
Loop Eng.
Golden Set 循环工程师
Trade Graph Core 贸易图核心
Entity Resolution 实体解析· Graph Traversal 图遍历· Decision Synthesis 决策合成· Fact Checker 事实核查
L1 — Authority 权威数据
WCO · WTO · OFAC · BIS · EU · UN
L2 — National 国家级
TARIC · HTSUS · GACC · HMRC
L3 — Commercial 商业情报
Dow Jones · Refinitiv · D&B
L4 — Trade Flow 贸易流
Panjiva · Comtrade · Freight
L5 — Feedback 反馈闭环
User Corrections · ERP · Shopify
6 — UBO 企业实体
OpenCorporates · Registries
Sanctions 每日
OFAC · BIS · EU · UN
Tariff Live 每日
Comtrade · WTO · TARIC
Tariffs 每周
WTO · USITC · FTA
Rulings 每周
CBP · EU BTI · UK HMRC
Export Control 每周
BIS · ITAR · EU Dual-Use
Entities 每周
OpenCorporates · UBO
HS Codes 每月
WCO · National Extensions
Flywheel 每周
Drift · Golden Set · pgvector
Infrastructure 基础设施
Neon PostgreSQL + pgvector· DeepSeek v4-pro· Vercel· FastAPI· Sentry
Continuous Feedback Loop 持续反馈闭环 — User Corrections → Vectorize → Golden Set → Retraining → Improved Accuracy
Every API call enriches the graph. Every correction is vectorized to pgvector. 每次API调用丰富图谱。每次修正向量化至pgvector。

5-Layer Full Stack Architecture 五层全栈技术架构

From data ingestion to presentation — every layer built for deterministic AI compliance.
从数据摄取到表现层 — 每一层都为确定性AI合规而构建。

L1 — Infrastructure 基础设施
Neon PG + pgvector (HNSW)· 8 ETL Jobs· GitHub Actions CI/CD· Sentry · EU Residency
L2 — Data Core 数据核心
Entity Resolution (4-stage)· Unified Vector Store (6 cat.)· Flywheel Engine· 192 pytest
LangGraph Orchestrator 编排器
8 agents · StateGraph · ComplianceState 8个智能体
DeepSeek v4-pro
Sole AI provider · GRI reasoning 唯一AI提供商
RAG + Fact Checker RAG + 事实核查
pgvector HNSW · Hard-rule · Anti-hallucination 防幻觉
L4 — API Network API网络
23 Modules · 110+ Endpoints·REST + WS + SSE·JWT + OAuth · Rate Limit·OpenAPI 3.1
L5 — Presentation 表现层
52 Static Pages·Next.js 14 + Tailwind·Shopify Embedded App·Admin Control Tower

Trade Graph Core — Not a Database. A Regulatory Reasoning Engine. 不是数据库。是监管推理引擎。

50K+ nodes, 218K+ edges across 5 jurisdictions. Entity resolution (4-stage) → Graph traversal (BFS) → Decision synthesis → Continuous flywheel enrichment.
5万+节点,21.8万+边,覆盖5个司法管辖区。实体解析(4阶段)→图遍历(BFS)→决策合成→持续飞轮丰富。

Data Sources — 6 Categories 数据源 — 6大类
Authority DB·National·Commercial·Trade Flow·Feedback
1
Blocking 分块
Token-based candidate generation 令牌候选生成
2
Scoring 评分
Weighted similarity (name 0.35 + address 0.25) 加权相似度
3
Merging 合并
Transitive closure · score >= 0.85 auto-merge 传递闭包
4
Canonicalization 规范化
Single canonical record + audit trail 单一规范记录
Graph Traversal Engine (BFS) 图遍历引擎
Multi-hop (10)·Weighted Risk Scoring·Ownership Chains·Sanctions Exposure
HS + ECCN 归类
GRI 1-6 · CCL 10x5
Tariff + FTA 关税
MFN · FTA · AD · VAT
Sanctions Risk 制裁风险
OFAC · BIS · EU · UN
License Req. 许可证
NLR · STA · ITAR
Fact Checker 事实核查
Hard-rule · Anti-hallucination
HS Codes 商品编码
147 docs
Tariffs 关税
30 docs
Sanctions 制裁
5 docs
Export Ctrl. 出口管制
25 docs
Rulings 裁决
4+ docs
Feedback 反馈
User corrections
Continuous Feedback Loop 持续反馈闭环 — Corrections → Golden Set → Retraining → pgvector → RAG KB

Multi-Agent Orchestration Pipeline 多智能体编排管道

8 autonomous AI agents orchestrated via LangGraph StateGraph — input flows through 5 compliance agents, then 3 flywheel agents close the loop.
通过LangGraph StateGraph编排的8个自主AI智能体 — 输入流经5个合规智能体,再由3个飞轮智能体关闭循环。

Product 产品代理
HS GRI 1-6 · ECCN CCL 10x5
Party 方代理
Sanctions · UBO · FP Reduction
Country 国家代理
MFN · FTA · VAT · AD
Shipment 货运代理
Landed Cost · Route Risk
Regulatory 监管代理
CBAM · AD Order · License
Fact Checker — Hard-Rule Interceptor — Anti-Hallucination 硬规则拦截器 · 防幻觉
Monitoring 监控代理
Change Detection · Drift · Freshness
Conflict 冲突解决
5-Factor Priority · Audit Trail
Loop Eng. 循环工程师
Enrich · Retrain · Golden Set
Continuous Feedback Loop — Corrections → Vectorize → Golden Set → Retrain

Enterprise Security & Compliance 企业安全与合规

Zero Trust 零信任
JWT+bcrypt · OAuth · HMAC
Data Protection 数据保护
TLS 1.3 · EU Residency · Zero Retention
Injection Defense 注入防御
12 regex · Sanitization · Gitleaks
Audit 审计
Reasoning trace · AuditLog · 91% ready
Threat Prevention 威胁防护
Zero Trust · Rate Limit · Prompt Defense
Continuous Monitoring 持续监控
Sentry · ETL Health · Drift · Alerts
Regulatory Readiness 监管就绪
GDPR · EU AI Act · SOC 2 path

Not Shell AI. Compliance Infrastructure with Irreversible Moats. 不是AI套壳。是不可逆护城河的合规基础设施。

1. 零摩擦冷启动 Zero-Friction Onboarding

Shopify OAuth → 影子管道拉取12个月订单。AI归类每个产品。注册60秒内即可看到合规健康报告和预估税收追回。即时价值,零手动输入。

2. 法律级可辩护输出 Legally Defensible

每次分类15条合规断言,每条附带海关裁决数据库引用。不可变审计链(SHA-256)证明无篡改。PDF证书可用于海关稽查。你卖的是证据,不是猜测。

3. 自进化智能 Self-Evolving Intelligence

每次用户修正向量化至pgvector。专业报关员反馈获5倍权重。Golden Set自动晋升验证分类。精度随每次API调用叠加。竞争对手面临日益加深的冷启动难题。

4. 多司法管辖区覆盖 Multi-Jurisdiction

180+国家。5大监管体系。50+制裁名单。8个ETL作业每日/每周/每月同步。Trade Graph连接5万+节点,21.8万+边。无单一管辖区产品能与此广度竞争。

5. API优先基础设施 API-First Infrastructure

110+ REST端点。WebSocket实时推送。OpenAPI 3.1自动SDK。Shopify webhooks、WooCommerce插件、Zapier连接器。为嵌入而生,非仅供访问。

6. 数据网络效应(核心护城河)Data Network Effects

每次分类丰富Trade Graph。租户子图谱反哺全球图谱。更多用户→更多边→更高精度。专业报关员修正叠加。图谱无法从公共数据复制。这是不可逆的护城河。

Aegis V4.0 — 不是ChatGPT套壳。不是数据库。是合规推理引擎。

8个AI智能体 · 110+ API端点 · 8个ETL作业 · 15条合规断言 · SHA-256审计链 · 5万+图谱节点 · 租户隔离 · PDF证书

Four Critical Gaps — Closed. Enterprise-Ready. 四项关键差距 — 已关闭。企业级就绪。

Addressing dual-track privacy, durable execution, agentic ETL, and human-in-the-loop routing.
解决双轨隐私、持久化执行、智能化ETL和人机协同路由 — 世界500强采购的四大结构性前提。

★ Gap 1: 双轨隐私架构 Dual-Track Privacy

问题: 零数据留存保证与反馈飞轮冲突——原始产品描述永久存储。解决: DataMaskingFilter在图谱存储前剥离PII。Track A临时保险库72小时后清除。Track B仅保留语义特征。GDPR第17条硬清除端点。

backend/app/services/data_masking.py

★ Gap 2: 持久化执行层 Durable Execution

问题: 5万SKU清单因网络故障丢失全部进度——无检查点、无恢复。解决: BatchManifestEngine每个SKU独立状态机,每100个SKU检查点保存,指数退避重试,速率限制感知,暂停/恢复,部分成功完成。

backend/app/services/batch_manifest_engine.py

★ Gap 3: 智能化ETL管道(已激活)Agentic ETL

问题: 8个ETL作业中5个是桩代码返回processed=0。解决: 裁决同步连接到实时CBP CROSS、EU BTI、UK HMRC抓取器。制裁同步调用OFAC SDN CSV下载。管道监控器在数据过期>30小时时告警。新裁决自动向量化。

backend/app/etl/rulings_sync.py → 实时API调用

★ Gap 4: 人机协同托管网关+Bug修复 HITL Escrow

问题: FlywheelEngine缺少get_validation_queue()方法——GET /flywheel/queue崩溃。无置信度门控审查路由。解决: EscrowGateway将<85%置信度项目路由至人工审查工作台。状态机: PENDING→IN_REVIEW→APPROVED/CORRECTED。24小时SLA追踪。审查者权威权重反馈至Flywheel。修复了FlywheelEngine的bug。

backend/app/trade_agent/escrow_gateway.py

91% Complete — 29/32 Gaps Resolved 91%完成 — 29/32项差距已解决

Completed — AI/ML (7/7) 已完成 — AI/ML

8智能体编排 · Golden Set管理 · 金丝雀评估 · 提示注入防御 · 成本追踪 · 模型评估 · pgvector反馈嵌入

Completed — Intl. Trade (9/9) 已完成 — 国际贸易

原产地引擎 · 退税优化 · FTZ支持 · 6大数据源集成 · 180+国家 · 8个ETL作业 · 实时关税 · 裁决抓取 · 75条贸易数据

Completed — Intl. Legal (8/8) 已完成 — 国际法务

法律免责声明 · GDPR隐私政策 · 管辖法律 · EU数据驻留 · 隐私盾 · DPA · ToS/ToU · 零数据保留

5/8 Complete — Intl. Business 5/8完成 — 国际商务

✅ Stripe计费 · 分层定价 · 双语界面 · 52页面 · SEO
剩余3项: 10个付费客户 (Q3-Q4 2026) · E&O保险 $2-5M (Q4 2026-Q1 2027) · 报关行合作 3-5家 (Q4 2026-Q2 2027)
For detailed Gantt chart and EU AI Act conformity assessment, see English version.
详细甘特图和EU AI Act合规评估请查看英文版本。

Ready to Explore the Architecture? 准备探索架构?


Deploy the full AI compliance stack. Start free, no credit card required.
部署完整的AI合规技术栈。免费开始,无需信用卡。