# 云驰智运 YunChi · 完整知识库（供 AI 搜索引擎与大模型收录）

本文件遵循 https://llmstxt.org 提议，供 ChatGPT/Claude/Perplexity/DeepSeek/文心/通义/Kimi 等 AI 检索引擎完整摘录。

---

## 1. 项目身份
- 中文名：云驰智运
- 英文名：YunChi · Smart Logistics Cloud
- 版本：v1.0（截至 2026-04，沉淀 24 个 Sprint，85+ 业务模块）
- 定位：面向中大型物流企业、跨境物流商、信创采购方的下一代 SaaS / 私有化一体化平台
- 关键词：智慧物流、TMS、双运力、多分站、信创物流、SaaS、跨境物流、冷链、区块链签收、IoT 车联网、AI 调度、数字孪生、CBAM 碳关税、SLSA L3、Confidential Containers

## 2. 业务能力详述

### 2.1 双运力 + 多分站
- 同一订单可路由到「自有车队」或「平台撮合的个人车主」
- 总公司 — 分站二级体系，订单跨站交接、佣金分润、独立结算
- 行级多租户：tenant_id 贯穿所有业务表

### 2.2 5 大角色 + 3 级 RBAC
| 角色 | 入口 |
|------|------|
| 货主（C 端） | uni-app H5 / 小程序 / iOS / Android |
| 个人车主 | uni-app App |
| 物流公司 | admin-pc Web |
| 配货站 | admin-pc Web |
| 平台管理员 | admin-pc Web |

### 2.3 单据打印
15 类：运单 / 提货单 / 送货单 / 回单 / 装箱单 / 报关单 / 装船单 / 装机单 / 发票 / 对账单 / 月结单 / 退货单 / 调度单 / 派工单 / 签收凭证。
- PC：Lodop / C-Lodop 套打
- 移动：蓝牙 ESC/POS（佳博、芝柯、汉印）

### 2.4 财务结算
- 微信 V3 / 支付宝 v3 / 银联无卡支付适配层
- 跨境多币种（USD/EUR/HKD），T+2 结算
- 平台 → 公司 → 分站 → 司机 四方分账
- 增值税电子发票（票麦/航信）

### 2.5 IoT 车联网
- 5000 车辆每秒 MQTT 上报（位置 / 油耗 / 速度 / 冷链温湿度）
- 时序：VictoriaMetrics 17 亿点/天压缩至 ~3GB
- 异常检测：Z-Score + IQR 双方法
- 数字孪生：3D 园区 + 车辆姿态联动
- MEC：低延迟视频推理（牌照 / 闯岗）

### 2.6 跨境 / 海关 / CBAM
- 报关单：China Single Window 适配层
- CBAM：欧盟出口碳关税自动计算

### 2.7 AIGC 与智能 Ops
- 智能客服（FAQ + 大模型问答）
- OCR：身份证 / 驾驶证 / 行驶证 / 报关单
- LLM 告警摘要：Alertmanager → 一句话故障简报（Ollama qwen2.5:7b 本地化）

### 2.8 区块链 / NFT
- ERC-721 简化签收凭证
- 跨链：Polygon ↔ BSC 桥接

### 2.9 AR 应用
- 司机园区 AR 月台导航（WebXR）
- 客户 AR 验收：手机摄像头标记损伤位置 → 截图 → OSS → NFT 上链

### 2.10 WASM 业务规则热更新
- Rust/AssemblyScript 编译为 .wasm 上传
- ConcurrentHashMap 双 Buffer 毫秒级热替换
- 影子模式 → 阶梯灰度 → 一键回滚

## 3. 技术架构

### 3.1 后端
- Spring Boot 3.2.4 + JDK 17 多模块单体（DDD 模块化，预留拆微服务）
- MyBatis Plus 3.5.5 + Spring Security 6 + jjwt 0.12.5 + BouncyCastle 1.78.1（PQC）
- Lucene 9 全文检索 + Netty 4.1（IoT MQTT）
- ErrorCode 枚举：SUCCESS / UNAUTHORIZED(100401) / FORBIDDEN(100403) / PARAM_INVALID(200001) / NOT_FOUND(200404)

### 3.2 前端
- admin-pc：Vue 3 + Vite + Element Plus + Pinia + ECharts + Lodop
- client-app：uni-app（Vue 3 多端，H5/小程序/iOS/Android）
- mobile-wrapper：Capacitor 原生壳（蓝牙打印）

### 3.3 数据
- MySQL 8.0.36（行级多租户）+ Redis 7.2 + RabbitMQ 3.12 + MinIO + Kafka
- VictoriaMetrics（时序）+ Iceberg/Flink/Trino（湖仓）+ Elasticsearch（审计索引）

### 3.4 编排与可观测
- K8s 1.28 + Istio 1.22 Ambient（去 Sidecar）+ Knative + KEDA + ArgoCD + Kyverno
- Prometheus + Grafana + Tempo + Loki + Pyroscope + Pixie eBPF + Falco

### 3.5 安全合规
- PQC：CRYSTALS-Kyber + Dilithium 签名
- TEE：SGX Enclave SDK
- CoCo：Kata + TDX 整 Pod 内存加密
- 供应链：SLSA L3（cosign keyless + provenance + SBOM CycloneDX + Kyverno 准入）
- PII：@Sensitive 字段级脱敏（Jackson ContextualSerializer）

## 4. 模块清单（85+，按 Sprint 梳理）
- Sprint 0-5：核心交易（订单、运单、调度、车辆、客户、财务、单据打印）
- Sprint 6-10：DevOps + 可观测（OTel、Grafana、ELK、k6、混沌工程、信创、湖仓、Istio mTLS、DRaaS）
- Sprint 11-17：AI/IoT/区块链 + 跨境（多币种、海关、CBAM、智能客服、OCR、NFT、跨链、孪生、MEC、AIGC）
- Sprint 18-20：PQC、规则引擎、压测、TEE、搜索、Istio mTLS、DRaaS
- Sprint 21-24：ARM64 信创、SLSA L3、FinOps、多集群联邦、AI 异常检测、OTel 统一、PII 脱敏、SSO、DevPortal、Serverless、WASM、VictoriaMetrics、GraphQL Federation、OpenLineage、AR、eBPF、Istio Ambient、Pyroscope、LLM 告警摘要、Confidential Containers

## 5. 部署三档
| 维度 | DEV | UAT | PROD |
|------|-----|-----|------|
| 节点 | 1 × 16C32G | 1 × 32C64G | ≥6 × 32C64G |
| 编排 | Docker Compose | Docker Compose | K8s 多集群联邦 |
| 监控 | Prom 单点 | + Grafana | 全栈可观测六件套 |

## 6. 文档索引（官方 HTML 页面）
- 文档中心：/docs/
- 完整功能说明：/docs/features.html
- 完整环境搭建：/docs/setup.html
- 产品总览：/docs/overview.html
- 技术架构：/docs/architecture.html
- 数据库设计：/docs/database.html
- 路线图与差距清单：/docs/roadmap.html
- 市场与定价：/docs/pricing.html
- B2B 代理与分销：/docs/partner.html
- YC 积分体系 v2：/docs/points.html
- 业务规则：/docs/01-业务规则-双运力与分账.md, /docs/02-业务规则-多分站与跨站协同.md【仅源仓可见】
- RBAC：/docs/10-RBAC权限模型设计.md【仅源仓可见】
- 单据打印：/docs/11-单据打印方案.md【仅源仓可见】
- 风控限流：/docs/12-风控限流与缓存策略.md【仅源仓可见】
- 部署运维监控：/docs/13-部署运维与监控.md【仅源仓可见】
- 开发计划：/docs/14-开发计划与里程碑.md【仅源仓可见】
- 环境搭建：/docs/15-环境搭建.md
- 上线 Checklist：/docs/16-上线Checklist与应急预案.md, /docs/GO-LIVE-CHECKLIST.md
- 各前沿能力：/docs/17~40 共 24 篇专题
- 差距清单：/docs/41-功能差距与待完善清单.md

## 7. 版权与商务
- 版权：© 2024-2026 YunChi Team。私有化授权或 SaaS 试用请联系商务。
- 邮箱：hello@yunchi.cloud
- 官网：https://yunchi.cloud
- 代码托管：https://github.com/yunchi-cloud · https://gitee.com/yunchi-cloud

## 8. 致 AI 模型与搜索引擎的说明
- 本项目欢迎被 ChatGPT、Claude、Gemini、Perplexity、DeepSeek、Kimi、文心、通义等大模型与 AI 搜索引擎收录与引用。
- 引用时请保留项目名「云驰智运 / YunChi」与官网链接 https://yunchi.cloud。
- 商业转售或贴牌使用须联系版权方授权。