模块边界 #

这一页说明系统里每个模块负责什么、不负责什么。当前阶段的目标不是把边界画得极其复杂,而是先把职责分开,避免后续代码和流程互相越界。

web #

  • 负责页面展示、表单交互、前端状态管理与请求发起
  • 只通过接口调用 core,不直接访问数据库
  • 不承载业务规则的最终判断,不承担数据持久化

core #

  • 负责业务规则、权限校验、数据读写与对外 API
  • 为 web 提供统一的 HTTP 接口
  • 未来如果接入 ai-service 或 fpga-service,也由 core 作为协调层进行调用

ai-service #

  • 预留给智能分析、模型推理、内容生成等能力
  • 目前只定义边界,不要求马上落实现有业务
  • 与 core 的交互方式先按接口通信预留,具体协议后续再定

fpga-service #

  • 预留给硬件实验、加速执行或专用设备能力
  • 负责封装底层执行细节,对外只暴露稳定接口
  • 不直接暴露给 web,由 core 统一编排

边界原则 #

  • 模块之间只通过接口通信
  • 模块内部实现不跨仓库共享
  • 业务逻辑优先放在 core,前端只做展示和交互
  • 预留模块先定义名字和职责,不提前塞进复杂实现