Daona CPMS v2.0 业务需求文档

02角色与权限模型（RBAC + ABAC）

2.1 12 大角色

2.2 权限模型：RBAC + ABAC + 数据隔离

2.3 权限关键场景

03业务架构总览

3.1 4 域 + AI Agent + 集团驾驶舱 总体架构

3.2 4 域的因果关系

3.3 系统能力指标（v2.0 目标）

04投标域（Bid Domain）

投标域核心目标：把"投不投 / 怎么报 / 标书自动化"3 个核心问题工具化，覆盖从客户画像 → 招标响应 → 报价决策 → 投后跟踪全流程。共 18 个工作台。

4.1 核心功能模块

4.2 投标域工作流（G0 投前 → G1 决策 → G2 投后）

// 投标工作流状态机（Go state machine）
type BidState int
const (
    G0_Identified   BidState = iota  // 客户机会识别
    G1_Qualified                // KYP + 风险扫描通过
    G2_BidPrep                  // 标书准备中（14 模版选择）
    G3_PricingReview            // BOQ 报价决策（沙盘评分）
    G4_RedlineCheck             // S/A/B/D/F 红线校验
    G5_Submitted                // 已投递
    G6_Negotiating              // 谈判中（让步阶梯）
    G7_Won_or_Lost              // 中标/失标
    G8_ContractSigned           // 合同签约（AI 评审通过）
)

4.3 关键 SLA & 业务规则

05执行域（Execution Domain）

执行域核心目标：G0-G7 项目闸门工作流 + 4 类海外合规自动核查 + NCR/RFI 闭环 + 月度毛利告警。共 22 个工作台。

5.1 G0-G7 项目闸门工作流

5.2 4 类海外合规自动核查

5.3 NCR/RFI 闭环（不符合项 / 信息请求）

// NCR 状态机
type NCRState int
const (
    Reported      NCRState = iota  // 现场工程师上报
    Triaged                       // AI 分类（轻/中/严重）
    Assigned                      // 分配责任人
    RootCauseAnalysis             // 根因分析
    CorrectiveAction              // 整改方案
    Verification                  // 验证
    Closed                        // 关闭归档
)
// 已沉淀 50+ 项 NCR/RFI 实例为 AI 训练样本

5.4 关键业务规则

06决策域（Decision Domain）

决策域核心目标：把"集团 CEO 月度 30 天才能拿到子公司报表"压缩到"实时一屏决策"。共 12 个工作台。

6.1 CEO 一屏决策驾驶舱

6.2 CEO 移动端（H5 + 微信小程序）

07资产域（Asset Domain）

资产域核心目标：把 BA/LC/SBLC/BG 银行工具组合 + 货权管理 + 保函全周期 + BOQ 价格库结构化沉淀。共 15 个工作台。

7.1 核心模块

7.2 资金工具池业务规则

08AI Agent 矩阵（8 大 Agent）

8.1 8 大 Agent 全景

8.2 Agent 技术架构（LangChain + Dify）

// AI Agent 工作流编排架构
┌───────────────────────────────────────────────────────────┐
│       前端调用：POST /v1/ai/agent/:agent_id/invoke           │
└─────────────────────────┬─────────────────────────────────┘
                            ↓
┌───────────────────────────────────────────────────────────┐
│   go-zero: ai-agent-api → ai-agent-rpc (orchestrator)     │
└─────────────────────────┬─────────────────────────────────┘
                            ↓
┌───────────────────────────────────────────────────────────┐
│              LangChain + Dify Workflow Engine              │
│   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│   │ Retriever│→ │ Reasoner │→ │ Tools    │→ │ Responder│  │
│   │ (RAG)    │  │ (LLM)    │  │ (Action) │  │ (Format) │  │
│   └──────────┘  └──────────┘  └──────────┘  └──────────┘  │
└─────┬───────────┬───────────┬───────────┬─────────────────┘
       ↓           ↓           ↓           ↓
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ Milvus  │ │  LLM    │ │ Internal│ │ Stream  │
│ Vector  │ │  API    │ │  RPC    │ │ Response│
└─────────┘ └─────────┘ └─────────┘ └─────────┘

8.3 大模型选型

09数据模型（102 类业务数据）

9.1 核心实体 ER（简化版）

// 12 大核心实体（PostgreSQL 主表）

CREATE TABLE tenant ( -- 租户（央企集团）
    id BIGSERIAL PRIMARY KEY,
    name VARCHAR(200),
    code VARCHAR(50) UNIQUE,
    created_at TIMESTAMP
);

CREATE TABLE subsidiary ( -- 海外公司
    id BIGSERIAL PRIMARY KEY,
    tenant_id BIGINT REFERENCES tenant(id),
    country VARCHAR(10), -- ISO 3166-1
    region VARCHAR(50) -- 中东/中亚/东南亚
);

CREATE TABLE project ( -- 项目（核心业务单元）
    id BIGSERIAL PRIMARY KEY,
    tenant_id BIGINT, subsidiary_id BIGINT,
    name VARCHAR(200), client_id BIGINT,
    status VARCHAR(20), -- G0-G7 + Closed
    contract_amount NUMERIC(18,2),
    currency CHAR(3),
    start_date DATE, expected_end DATE,
    yuj_bound BOOLEAN DEFAULT TRUE -- YUJ 项目流标记
);

CREATE TABLE bid ( -- 投标记录
    id BIGSERIAL, project_id BIGINT,
    state VARCHAR(20), -- G0_Identified ... G8_ContractSigned
    grade CHAR(1), -- S/A/B/D/F
    boq_total NUMERIC(18,2),
    win_probability NUMERIC(5,2) -- AI 预测
);

CREATE TABLE ncr ( -- 不符合项
    id BIGSERIAL, project_id BIGINT,
    severity VARCHAR(10), -- light/medium/critical
    state VARCHAR(20),
    root_cause TEXT, corrective_action TEXT
);

-- 其余 7 张核心表：client, supplier, contract, guarantee, cargo_pledge, ai_agent_call, audit_log
-- 102 类业务数据 = 12 主表 + 90 业务流水/统计/明细表

9.2 数据分层架构

9.3 信创适配（生产环境）

10后端架构：go-zero 微服务（14 个服务）

10.1 微服务清单

10.2 go-zero 项目结构

daona-cpms-backend/
├── gateway/                  # 网关
│   ├── etc/gateway.yaml
│   ├── internal/middleware/  # JWT / 限流 / 日志
│   └── gateway.go
├── services/
│   ├── auth/
│   │   ├── api/              # REST API 层
│   │   │   ├── etc/auth-api.yaml
│   │   │   ├── internal/
│   │   │   │   ├── handler/
│   │   │   │   ├── logic/
│   │   │   │   ├── svc/
│   │   │   │   └── types/
│   │   │   ├── auth.api      # goctl 生成源
│   │   │   └── auth.go
│   │   └── rpc/              # gRPC 层
│   │       ├── etc/auth-rpc.yaml
│   │       ├── internal/server/
│   │       ├── auth.proto    # protobuf 定义
│   │       └── auth.go
│   ├── bid/ (同构)
│   ├── exec/ (同构)
│   ├── decision/ (同构)
│   ├── asset/ (同构)
│   ├── ai-agent/ (同构)
│   └── ...
├── common/                   # 通用包
│   ├── model/                # sqlc / ent 生成的 model
│   ├── errorx/               # 业务错误码
│   ├── middleware/
│   ├── llm/                  # LLM 调用封装
│   └── audit/
├── deploy/
│   ├── docker-compose.yaml
│   ├── k8s/
│   └── helm/
├── scripts/                  # goctl 生成脚本
└── go.mod

10.3 go-zero 关键技术决策

10.4 .api 文件示例（投标域）

// services/bid/api/bid.api
syntax = "v1"

info (
    title:   "Daona Bid Domain API"
    desc:    "投标域 REST 接口"
    version: "v2.0"
)

type BoqQuoteReq {
    ProjectId   int64  `json:"project_id"`
    Currency    string `json:"currency"`
    Items       []BoqItem `json:"items"`
}

type BoqQuoteResp {
    TotalAmount float64 `json:"total_amount"`
    Breakdown   CostBreakdown `json:"breakdown"`
    WinProb     float64 `json:"win_probability"`
}

@server(
    group:      bid
    jwt:        Auth
    middleware: Audit,RateLimit
)
service bid-api {
    @handler BoqQuote
    post /v1/bid/boq/quote (BoqQuoteReq) returns (BoqQuoteResp)
}

11前端架构：React 18 + shadcn/ui

11.1 技术栈

11.2 项目结构

daona-cpms-frontend/
├── src/
│   ├── routes/                  # React Router data routes
│   │   ├── _root.tsx
│   │   ├── auth/login.tsx
│   │   ├── dashboard/index.tsx       # 集团驾驶舱
│   │   ├── bid/                      # 投标域（18 工作台）
│   │   ├── exec/                     # 执行域（22 工作台）
│   │   ├── decision/                 # 决策域（12 工作台）
│   │   ├── asset/                    # 资产域（15 工作台）
│   │   ├── ai-agents/
│   │   └── admin/
│   ├── components/
│   │   ├── ui/                       # shadcn/ui 生成组件
│   │   │   ├── button.tsx
│   │   │   ├── dialog.tsx
│   │   │   ├── table.tsx
│   │   │   └── ...
│   │   ├── domain/                   # 业务组件
│   │   │   ├── bid/BoqEditor.tsx
│   │   │   ├── exec/GateFlow.tsx
│   │   │   ├── decision/Cockpit.tsx
│   │   │   └── asset/GuaranteeCard.tsx
│   │   └── layout/
│   ├── hooks/
│   ├── stores/                  # Zustand stores
│   ├── api/                     # API client (typed via openapi-ts)
│   ├── i18n/
│   └── main.tsx
├── public/
├── tailwind.config.ts
├── components.json              # shadcn/ui 配置
├── vite.config.ts
└── package.json

11.3 shadcn/ui 关键组件使用清单

11.4 关键页面 wireframe（文字版）

// 集团驾驶舱 (dashboard/index.tsx)
┌──────────────────────────────────────────────────────────┐
│ Header: 道纳 CPMS │ 搜索 (Ctrl+K) │ 通知 │ 用户          │
├──────────────────────────────────────────────────────────┤
│ Sidebar      │ 主区                                       │
│ 📊 驾驶舱     │ ┌─────────┐ ┌─────────┐ ┌─────────┐         │
│ 📋 投标       │ │ 今日营收│ │本月毛利 │ │ 现金流  │   KPI   │
│ ⚙️ 执行       │ └─────────┘ └─────────┘ └─────────┘         │
│ 🎯 决策       │                                            │
│ 💎 资产       │ ┌──────────────────────────────────────┐   │
│ 🤖 AI Agent  │ │   项目地图（红/黄/绿）                │   │
│ 👤 我的       │ └──────────────────────────────────────┘   │
│              │                                            │
│              │ ┌─────────────────┐ ┌────────────────┐    │
│              │ │ 中标率漏斗      │ │ AI Agent 通知  │    │
│              │ └─────────────────┘ └────────────────┘    │
└──────────────────────────────────────────────────────────┘

11.5 移动端策略

12API 规范

12.1 REST API 设计原则

12.2 API 请求/响应示例

// POST /v1/bid/boq/quote
// Request
{
  "project_id": 12345,
  "currency": "USD",
  "items": [
    {"sku": "ALU-3MM-2440", "qty": 5000, "unit": "m2"},
    {"sku": "GLASS-12MM-LOW-E", "qty": 3000, "unit": "m2"}
  ]
}

// Response
{
  "code": 0,
  "msg": "ok",
  "data": {
    "total_amount": 1850000.00,
    "breakdown": {
      "material": 1100000,
      "labor": 280000,
      "logistics": 150000,
      "tax": 120000,
      "profit": 200000
    },
    "win_probability": 0.68,
    "grade": "A",
    "ai_insights": ["建议适当下调铝材报价 3%"]
  },
  "request_id": "req_abc123"
}

12.3 错误码规范

12.4 WebSocket / SSE

13非功能需求

13.1 性能

13.2 安全

13.3 合规资质（M12 必须拿到）

13.4 可扩展性

14部署架构与排期

14.1 部署架构

// 生产环境部署拓扑（信创适配 + 多可用区）
┌─────────────────────────────────────────────────────────────┐
│  Internet → WAF (Cloudflare + 国内 CDN) → SLB (阿里 LB)      │
└────────────────────────┬────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│       Kubernetes Cluster (阿里 ACK / 华为 CCE / 自建)        │
│  ┌──────────────────────────────────────────────────────┐   │
│  │ Namespace: gateway                                    │   │
│  │   - gateway (Deployment, 3 replicas, HPA)            │   │
│  └──────────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │ Namespace: services                                   │   │
│  │   - auth, user, bid, exec, decision, asset 等 14 服务 │   │
│  │   - 每服务 3-6 replicas (按流量)                      │   │
│  └──────────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │ Namespace: ai                                         │   │
│  │   - ai-agent-api/rpc + LangChain workers              │   │
│  │   - Dify 工作流编排                                   │   │
│  └──────────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │ Namespace: data                                       │   │
│  │   - PostgreSQL StatefulSet (主 + 2 从)                │   │
│  │   - ClickHouse / Milvus / Redis / RabbitMQ            │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│  外部依赖：LLM API / 银行 API / OFAC 名单 / OSS 文件       │
└─────────────────────────────────────────────────────────────┘

14.2 环境矩阵

14.3 CI/CD（GitLab CI + ArgoCD）

# .gitlab-ci.yml 简化版
stages:
  - lint
  - test
  - build
  - scan          # SAST + SCA + 镜像扫描
  - deploy-dev
  - deploy-sit
  - deploy-uat    # 手动触发
  - deploy-prod   # 手动触发 + 双签

backend-build:
  stage: build
  script:
    - "go build -ldflags '-s -w' -o bin/ ./..."
    - "docker build -t daona/{service}:$CI_COMMIT_SHA ."
    - "docker push registry.daona.com/{service}:$CI_COMMIT_SHA"

frontend-build:
  stage: build
  script:
    - "pnpm install --frozen-lockfile"
    - "pnpm run build"
    - "docker build -t daona/frontend:$CI_COMMIT_SHA ."

14.4 12 个月排期（与 BP 节奏对齐）

14.5 团队配比

14.6 验收标准（Definition of Done）