丝路鲜踪 (Silk Road Fresh Trace) - 架构设计

C4Context title "丝路鲜踪"系统上下文图 Person(admin, "CEO/管理层", "查看业务仪表盘，财务健康状况。") Person(finance, "财务人员", "管理应收账款，催收和预测。") Person(ops, "运营人员", "跟踪订单，监控温湿度，处理异常。") Person(driver, "司机", "接收任务，上报状态，上传照片。") System(system, "丝路鲜踪平台", "跟踪、监控和财务管理的核心系统。") System_Ext(gps_system, "GPS/IoT 平台", "提供实时位置和传感器数据。") System_Ext(sms_system, "短信网关", "发送警报和通知。") System_Ext(map_service, "地图服务", "提供地图瓦片和地理编码。") Rel(admin, system, "使用", "Web") Rel(finance, system, "使用", "Web") Rel(ops, system, "使用", "Web") Rel(driver, system, "使用", "Mobile App") Rel(system, gps_system, "获取传感器数据", "API") Rel(system, sms_system, "发送警报", "API") Rel(system, map_service, "获取地图数据", "API")

C4Container title "丝路鲜踪"容器图 Person(user, "内部用户", "CEO, 财务, 运营") Person(driver, "司机", "运输司机") Container_Boundary(c1, "丝路鲜踪平台") { Container(web_app, "Web 应用", "Vue.js/React", "提供仪表盘和管理界面。") Container(mobile_app, "司机端 App", "Flutter/Native", "司机上报状态的移动应用。") Container(api_gateway, "API 网关", "Nginx/Kong", "所有请求的入口点。") Container(backend_api, "后端 API", "Golang (Gin/Go-Zero)", "业务逻辑，订单管理，财务逻辑。") Container(iot_service, "IoT 接入服务", "Golang", "处理高频传感器数据接入。") ContainerDb(db, "主数据库", "MySQL", "存储订单，用户，财务数据。") ContainerDb(redis, "缓存", "Redis", "会话存储，实时数据缓存。") ContainerDb(oss, "对象存储", "OSS/S3", "存储照片和文档。") } System_Ext(iot_device, "IoT 设备", "GPS + 温湿度传感器") Rel(user, web_app, "使用", "HTTPS") Rel(driver, mobile_app, "使用", "HTTPS") Rel(web_app, api_gateway, "API 调用", "HTTPS") Rel(mobile_app, api_gateway, "API 调用", "HTTPS") Rel(api_gateway, backend_api, "路由至", "HTTP") Rel(api_gateway, iot_service, "路由至", "HTTP") Rel(backend_api, db, "读/写", "GORM/SQL") Rel(backend_api, redis, "读/写", "Go-Redis") Rel(backend_api, oss, "上传/下载", "SDK") Rel(iot_service, redis, "写入实时数据", "Go-Redis") Rel(iot_service, db, "归档数据", "GORM/SQL") Rel(iot_device, iot_service, "发送遥测数据", "MQTT/HTTP")

sequenceDiagram participant Ops as 运营人员 participant System as 平台 participant Driver as 司机端 App participant IoT as IoT 设备 Ops->>System: 创建订单 (分配司机, 路线) System->>Driver: 推送任务通知 Driver->>System: 接受任务 Note over Driver, IoT: 运输开始 Driver->>System: 上报 "发车" (上传照片) IoT->>System: 发送 GPS/温度数据 (每5分钟) System->>System: 检查阈值 alt 温度/湿度异常 System->>Ops: 触发警报 (仪表盘/短信) end Ops->>System: 查看实时轨迹和状态 Note over Driver, IoT: 运输结束 Driver->>System: 上报 "到达" (上传照片) System->>System: 停止监控 System->>Ops: 订单完成

graph TB subgraph Cloud ["云服务提供商 (阿里云/腾讯云)"] LB[负载均衡 (SLB)] subgraph K8s_Cluster ["Kubernetes 集群 / 应用服务器"] Web[Web 服务器 (Nginx)] App[应用服务器 (Go API)] IoT[IoT 服务器 (Go)] end subgraph Data_Layer ["数据层"] DB[(MySQL RDS)] Redis[(Redis 集群)] OSS[对象存储] end end User((用户)) -->|HTTPS| LB Device((IoT 设备)) -->|TCP/HTTP| LB LB --> Web LB --> IoT Web --> App App --> DB App --> Redis App --> OSS IoT --> Redis IoT --> DB

graph LR subgraph Collaboration ["多方协作网络"] Forwarder[货代公司] Carrier[承运商] Customs[报关行] end Platform[丝路鲜踪平台] Finance[财务系统] Forwarder <--> Platform Carrier <--> Platform Customs <--> Platform Platform <--> Finance style Platform fill:#e1f5fe,stroke:#01579b,stroke-width:2px style Finance fill:#fff9c4,stroke:#fbc02d,stroke-width:2px

graph TD AI[AI 智能大脑] --> Match[智能匹配] AI --> Route[动态路线优化] AI --> Risk[品质风险预测] Blockchain[区块链存证] --> Trust[信任机制] Blockchain --> SupplyFinance[供应链金融] Global[全球化网络] --> MultiLang[多语言/多时区] Global --> MultiPort[多国口岸] style AI fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px style Blockchain fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px style Global fill:#e0f7fa,stroke:#006064,stroke-width:2px