ZY Action Platform · 全系统技术介绍

项目愿景：Palantir 对标产品矩阵

ZY Action Platform 以 Palantir 的产品矩阵为对标，在 Go 单机优先架构上构建五产品。四条红线贯穿全部设计：R1 语义层是一等资产、R2 治理是 Action 路径内建约束、R3 单机优先即机制浓缩版、R4 共享同一套声明模型（详见 契约与红线）。

V5 七阶段能力总览（2026-08-29/30 升级）

V5 以「S0 平台底座 → S6 生态工程」七个阶段升级全平台：统一调度与异步任务让长耗时操作全部任务化可看进度；数据域补齐数据集 / 质量画像 / 全量增量同步 / 对象化 SQL 工作台；知识域新增实体抽取、决策证据链、CDC、语义标注与多格式解析；协作闭环新增 Notebook / 块式报表 / 实体消解 Fusion / 变更驱动流规则与双因子认证、通知中心；图谱域补齐行级图谱化导入 / 图分区压缩 / 时序图分析；语义互操作落地 13 类标准值类型、本体函数、MCP、安全标记与 OWL/SHACL 导出；生态工程交付组件市场、代码仓库、统一搜索、向量增强、Prometheus 可观测、embed 单二进制与契约一致性。

开发双主线

关键技术决策

• 后端统一 Go（单一二进制，CGO_ENABLED=0 兼容信创）；主力 LLM 为 deepseek-v4-flash，embedding 用 dashscope_embedding。
• 前端 Vue3 / 纯 JS（Vite）；数据库优先 PostgreSQL（chatbi_action_dev），MVP/星上用 SQLite（glebarez 纯 Go 驱动）。
• 向量库 ChromaDB 理念 → 本机实现 milvus/turbovec/disk 三后端自动降级；图存储自研磁盘 JSON（不引外部图库）。
• 单机优先、不过度封装：内部系统调用直白可调试，模块间同步 HTTP/Go 接口。

系统模块总览

点击卡片进入对应模块技术介绍页。每个模块页共用同一套 css/js，顶部导航与左侧目录保持一致的交互。

总体架构

产品层（products/）每个产品 = 一组 REST 路由 + 产品级 service，不重复造底座；底座层（platform/）全产品共享；前端 web/ 按产品前缀分流后端（/api → Foundry、/apollo-api → Apollo、/aip-api → AIP）。

┌────────────────────────────────────────────────────────────────────┐
│ 前端  web/（Vue3 + Vite，端口 5173）  / 网关 gateway（端口 80）       │
│   /api → Foundry(18081)   /apollo-api → Apollo(18082)              │
│   /aip-api → AIP(18080)   /gotham-api → Gotham(18083)              │
│   /swift-api → Swift(18084)                                        │
├────────────────────────────────────────────────────────────────────┤
│ 产品层  products/  aip · foundry · apollo · gotham · swift(仿真 PoC)│
│  每个产品 = REST 路由 + 产品级 service（nlq / ontology / hub / graph…）│
├────────────────────────────────────────────────────────────────────┤
│ 底座层  platform/  （全产品共享 monorepo 单包引用）                   │
│  治理核心：auth · rbac · security(RLS/CLS) · audit(泛化事件) · crypto(国密)│
│  AI 核心：llm(网关降级链) · vector(三后端 + 批量/过滤/删除/计数增强)   │
│  数据核心：connector(allow-list + ExecWrite) · datasource · metadata │
│  调度核心：scheduler(统一调度) · task(异步任务五态) · resource(资源 URI)│
│  V5 新增：cdc(数据变更捕获) · notify(通知中心) · license(授权自检)     │
│  运维核心：config · database(PG/SQLite 自动迁移) · logger · settings │
│  基础类型：ierr · model · domain · repository                        │
├────────────────────────────────────────────────────────────────────┤
│ 持久化：PostgreSQL chatbi_action_dev（优先）→ SQLite 降级             │
│  向量：milvus / turbovec / disk(自动降级)   图：磁盘 JSON（gotham）   │
│  可观测：/metrics（Prometheus 文本格式）· embed 单二进制 · Docker    │
└────────────────────────────────────────────────────────────────────┘

产品间依赖与价值闭环

• 数据 → 智能：Foundry 本体语义层喂给 AIP 的 OAG；AIP 检索结构化对象而非文本块。
• 智能 → 行动：AIP 写工具映射到 Foundry Action Type（唯一写路径），人与 Agent 同约束。
• 行动 → 交付：本体 YAML、网关路由、评测集全部作为 Apollo bundle 制品声明式发布（SM3/SM2 签名）。
• 交付 → 创新：Apollo 的"拉取期望状态 + 版本回退"被 Swift 星上 SSPM 复用；Gotham 图/解析/ABAC 与本体语义对齐。

开发方法论（执行约束）

• Agent 驱动：所有开发通过 agent 完成，一次一个、前台阻塞执行（不并行）；单 agent 上限 500 次工具调用、限时 1 小时。
• 标准流程：调研 → 设计 → 多轮评审 → 执行；每阶段产出可演示、可验收的增量。
• API 优先 + 版本化：任何功能先有 /api/v1/... REST 接口再上 UI；契约冻结于 design_overview 六契约。
• 后端与前端成对交付：后端路由就绪即同步补齐前端页面并注册路由，避免"后端能力远超前端展示"。
• 提交规范：Conventional Commits、中文 message、结尾附 Co-Authored-By: Qian Shou / zytech <pyq@zyinfo.pro>；严禁 git add .。