Files

金讯达项目手册

这是项目的交接首页。新接手的人先按下面顺序阅读,不要只凭旧文档或聊天记录判断项目状态。

  1. 先读 2026-09-23 项目交接:最新部署状态、风险和接下来的计划。
  2. 再读 项目需求:弄清楚项目要做什么、不能碰什么。
  3. 最新进度和任务清单是精简索引;旧验收记录仅供追溯。

仓库里有什么

  • mobile/:手机端,使用 Flutter,含 Android 和 iPhone 的工程文件。
  • pc-client/:电脑端,使用 Electron,Windows 是当前优先支持的平台。
  • account-service/:公司账号服务,负责工号密码登录、管理员导入和管理名单。
  • docker-compose.yaml、config/、scripts/:OpenIM、语音服务和内网环境的配置及维护脚本。
  • deploy/public/:早期公网部署资料。旧 edge 操作不适用于当前系统 Nginx 统一入口,不要直接执行。
  • docs/:本手册和以前留下的验收、回归、使用说明。

更新规矩

以后每完成、新增、取消或发现一个任务,负责这件事的智能体必须在同一次提交中顺手更新本目录:

  • 改需求或边界时,更新 项目需求.md。
  • 做完功能、修复问题、完成构建或验证时,更新 最新进度.md。
  • 任务状态变化时,更新 任务清单.md 的三栏,并写明依据。
  • 旧文档不能删除;如果它和当前事实不一致,在旧文档开头加“已过时,仅留档备查”提示,再在本目录写新版。

手册只记录已经确认的事实。拿不准的内容要写成“待确认”,不要当成已完成。