Files
pj0235-eai_agentplatform/eai_agentplatform/PROJECT_STATE.md
T
eaiadminandClaude Code f197dbd206 feat: 工作台外壳收尾 + 冻结旧导航 + 任务延迟创建与最近任务行菜单
外壳收尾
- 后端:内置「通用智能助手」(specialist.state = system)—— 它是任务的默认归属,
  不是可安装的专员,常规列表一律挡掉,只有显式带 state=system 才查得到
- config/nav.js:一级导航、二级 tab、搜索面板共用一份配置,替代原先散在 layout/ 与
  config/workbench.js 里的两套,旧的那批导航导出随之下架
- NavSearch.vue / SectionTabs.vue 组件化;考试 8 个页面收进 ExamTabsView 统一外壳
- 新增 /apps 专员选择页(SpecialistPickerPage.vue)
- ChatInputBar 重构:输入框的 + 拆为独立组件 PlusMenu.vue,新增 update:mode 事件
- 删除 LibraryTabs.vue(已被 SectionTabs 取代)

冻结旧导航(新增 frontend/src/_frozen/ + FROZEN.md 登记表)
- 工作区胶囊条连通知铃铛一起冻:外壳重构后成了冗余的第二套导航。不删代码,
  抽成自包含的 WorkspaceTabs.frozen.vue 归档,将来能原样放回
- 同源孤儿一并收拢:旧 SideNav / SectionTabs / navigation.js / Notification.vue
- 统一加 .frozen 后缀,登记表逐条写明原位置 / 冻结原因 / 外部依赖 / 解冻条件 / 解冻步骤
- 已验:冻结物不进构建产物(dist 里搜不到 wb-tabs),src/ 下无代码引用,
  只有 MainLayout 里指向 FROZEN.md 的指引注释
- 后端通知四接口与 store/api 层保留(BusinessAppPage 仍在用),解冻是纯前端工作量

我的任务
- 任务记录延迟到发出第一条消息时创建:新建任务只回到开场画布,不落库,
  标题取第一句话,专员取输入框 + 里先选的那个(pendingSpecialistKey 暂存,
  建任务时一并提交)。原实现点一次落一条「新任务」,是「最近任务」堆满空行的根因
- 最近任务行菜单:重命名(就地编辑,回车提交 / Esc 取消)、置顶、删除
  (硬删无回收站,确认框写明无法恢复)。新增 worker_task.pinned 字段、
  DELETE /api/worker/my-tasks/:id,列表排序改为 pinned DESC, updated_at DESC;
  el-dropdown 加 :persistent="false"(默认每行留一份隐藏菜单在 DOM 里)
- 对照 ChatGPT / WorkBuddy 后决定不做:分享任务(纯内网)、打开文件夹(Web 无此能力)、
  保存到工作空间(无 workspace 概念)、归档(没有「已归档」入口可找回)
- 当前任务高亮改用 WorkBuddy 绿;空列表给出「发送第一条消息后出现在这里」提示
- PROJECT_STATE.md 补记 D21(冻结机制)/ D22(延迟建任务)/ D23(行菜单)

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-14 16:19:18 +08:00

9.5 KiB
Raw Blame History

项目状态总览(PROJECT_STATE)

单一事实源:新对话默认先读此文件恢复上下文;每次关键决策后必须更新。 最后更新:2026-08-24

1. 项目是什么

eai_agentplatform_app — EAI 数字员工平台(AI Agent Platform)。 纯内网本地化的企业 AI 数字员工平台,围绕数字员工(专员)、知识库底座、自动化工坊、 考试评估与系统管理组织业务能力。配套全局 AI 助手。

2. 当前状态

已完成

  • ✅ PRD V1.1 最终定稿(docs/PRD.md / 设计稿)
  • ✅ 文档架构搭建(docs/ 体系)
  • ✅ 编码规范制定(CODING_RULES.md / CLAUDE.md / PROJECT_STATE.md)
  • ✅ 知识入库体系(BE05)后端代码落地:knowledge_source 表 + 解析/扫描/摄入 + 审批 API + 脚本

已完成(Go 后端)

  • ✅ 后端重写为 Go 完成:认证 / CRUD / 考试 / 素材媒体 / 知识入库 / AI PathCoach / 系统管理
  • ✅ 交付形态落地:单二进制 + systemd + Clonezilla 清理清单(backend-go/deploy/)
  • ✅ 岗位与知识对应能力(P0):Position / PositionKnowledge 表 + 岗位 CRUD + 知识映射 + 用户设岗(user.position_id)+ 岗位驱动组卷(exam_paper.position_id → pickQuestions 岗位过滤分支); 前端「岗位管理」页 + 映射编辑面板 + 用户/考试关联岗位下拉
  • ✅ 岗位能力闭环(P1 + P2):学员「我的岗位应学清单」(/api/my/position)+ 成绩按岗位聚合(/api/system/exam-stats-by-position)+ 岗位考试蓝图(position_exam_blueprint); 错题本(mistake_record)+ 简答题 LLM 评分(essay 题型 + essay_grade 能力)+ 后端自动化测试(_test.go,go test ./... 全绿)
  • ✅ 学员成长体系(对标竞品,突破「极简/禁止学情分析」边界):学习积分 + 排行榜(point_event + user.learning_points);考试合格证书(certificate,正式通过自动颁发);学习档案/能力雷达 (/api/my/profile,按域掌握度 + 薄弱域 + 成绩趋势);前端新增「我的学习档案 / 我的证书 / 学习排行榜」页
  • ✅ 组织架构 + 消息通知:部门字典(department)+ 按部门学情统计(/api/system/department-stats); 站内通知(notification,考试发布/考试通过发证/设岗三事件推送)+ 侧栏铃铛角标; 社交社区/讨论区定死不做

待开始

  • ⬜ 按 docs/01_System_Overall/SY19_Universal_Digital_Worker_Product_Planning.md 将当前项目从“已有专员雏形”进一步收口为“通用数字员工平台 V1.0”

3. 已拍板决策

# 决策 状态
D01 前端:Vue3 + Vite + Element Plus 已定
D02 后端:Go + Gin + GORM + SQLite(modernc 纯Go驱动,接口留 MySQL 兼容) 已定
D03 认证:JWT(golang-jwt)+ bcrypt 已定
D04 文档转换:LibreOffice(裸进程)+ pdftotext 已定
D05 AI 底座:内网 OpenAI 兼容接口(非公网) 已定
D06 视频仅预览、不提取文本、不进 AI 已定
D07 知识检索:混合检索(向量 brute-force + 关键词兜底),数据量小无需 ANN 已定
D08 审批通过后异步转换/提取 已定
D09 视频 > 100MB 分片上传 + 断点续传 已定
D10 题库 + 组卷配置(随机/固定抽题) 已定
D11 角色:employee / admin 两级,无复杂权限 已定
D12 结构化知识源通道:backend-go/knowledge_source/ md → knowledge_source 表审批 → 摄入 product/question/chunk 已定
D13 向量检索:brute-force 余弦 + Ollama bge-m3 embedding(单容器双模型,随盘交付) 已定
D14 交付形态:裸进程 + systemd + Clonezilla 整盘克隆,Go 单二进制无源码交付 已定
D15 岗位与知识对应:Position/PositionKnowledge 表 + 用户单岗位(user.position_id)+ 岗位驱动组卷 已定(P0 落地)
D16 岗位考试蓝图:position_exam_blueprint 按「域 + 题型」抽样(题目无级别字段,不做级别加权);蓝图存在时优先于岗位映射抽题 已定(P1 落地)
D17 错题本(学员自助,非学情分析,自测/正式均写)+ 简答题 LLM 评分(essay 题型,复用 title_gen 路由,essay_grade 不扣点) 已定(P2 落地)
D18 突破原「极致极简/杜绝学情分析」边界:新增学员成长体系 = 学习积分+排行榜(游戏化)+ 考试证书(认证)+ 学习档案/能力雷达(学情,学员自助视角);积分规则集中常量可调 已定(V1.6 落地)
D19 部门组织架构(department 字典表,用户以 department 字符串归属、改名同步)+ 按部门学情统计;站内消息通知(考试发布/通过发证/设岗三事件);社交社区/讨论区定死不做 已定(V1.7 落地)
D20 当前阶段产品路线收口为「先通用、后定制」:先做标准化通用数字员工产品包,不直接追 WorkBuddy 的高自由度路线;第一批优先沉淀知识运营、培训考试、内容生成、任务推进 4 个通用数字员工,后续再长行业包与企业半定制 已定(见 docs/01_System_Overall/SY19_Universal_Digital_Worker_Product_Planning.md)
D21 前端建立「冻结归档」机制:停用代码不删除,集中到 frontend/src/_frozen/(统一 .frozen 后缀 + FROZEN.md 登记表,逐条记录原位置/冻结原因/外部依赖/解冻条件/解冻步骤)。首批冻结:工作区胶囊条(外壳重构后成了冗余的第二套导航)及外壳重构遗留的四个孤儿文件。D19 的站内通知只冻前端 UI —— 后端四个接口保留,store/api 层保留(BusinessAppPage 仍在用),解冻为纯前端工作量 已定(见 frontend/src/_frozen/FROZEN.md)
D22 任务记录延迟到发出第一条消息时创建(对齐 WorkBuddy:新建任务只是导航动作,不落库)。「新建任务」只做「回到 /home 开场画布 + 清空当前任务」,任务标题由第一句话决定、专员取输入框 + 里先选的那个(pendingSpecialistKey 暂存,建任务时作为 specialist_key 一并提交,后端已支持)。不允许存在没聊过天的空任务 —— 原实现点一次落一条 新任务,是「最近任务」堆满空行的根因 已定(V1.8 落地)
D23 侧边栏「最近任务」的行菜单(对齐 ChatGPT 悬停 ⋯ + WorkBuddy 任务卡「更多」):重命名(就地编辑,回车提交/Esc 取消)、置顶(新增 worker_task.pinned,排序 pinned DESC, updated_at DESC)、删除(新增 DELETE /api/worker/my-tasks/:id,硬删、无回收站,确认框写明「无法恢复」)。对照后不做:分享任务(纯内网无意义)、打开文件夹(Web 无此能力)、保存到工作空间(项目无 workspace 概念)、归档(没有「已归档」入口可找回,等于软删陷阱)。el-dropdown 加 :persistent="false" —— 默认每行留一份隐藏菜单在 DOM 里,50 条任务就是 50 份 已定

4. 文档索引

文档 路径 说明
PRD ../docs/PRD.md 产品需求文档(V1.1 最终版)
设计稿 ../docs/eai_agentplatform_app设计稿.md 完整 PRD 中文原稿
DB Schema ../docs/db_schema.md 9 张核心表字段设计
API 文档 ../docs/api.md API 接口定义
部署文档 ../docs/deploy.md 部署架构与步骤
变更日志 ../docs/changelog.md 版本变更记录
知识入库体系 ../docs/04_Backend/BE05_Knowledge_Ingest_Module.md 上传→生成→审批→入库总设计
知识源目录 backend-go/knowledge_source/ 结构化知识源 md(5 份,28 产品 + 20 题)
编码准则 ../CODING_RULES.md 编码与调试最高准则
AI 协作锚点 CLAUDE.md AI 新对话启动仪式

5. 目录结构(当前)

pj0231-eai_agentplatforming/                # 工作区根(仓库根)
├── CODING_RULES.md                     # 编码与调试最高准则
├── start_dev_10231_10232.sh            # 开发启动脚本
├── docs/                               # 设计文档(项目级,与代码分离)
│   ├── 00_AI_Context/                  # AI 协作上下文
│   ├── 01_System_Overall/              # 系统总览
│   ├── 02_Architecture/                # 架构设计
│   ├── 04_Backend/                     # 后端设计与 API
│   ├── 06_Product_Lines/               # 产品线与前端设计
│   ├── 08_Design_Rules/                # UI/UX 设计规范
│   ├── PRD.md / db_schema.md / api.md / deploy.md / changelog.md
│   ├── eai_agentplatform_app设计稿.md       # 完整 PRD 中文原稿
│   └── 博昇产品与渠道合作表.md          # 知识源权威数据
└── eai_agentplatform_app/                  # 应用代码
    ├── backend-go/                     # Go 后端(正式,唯一后端,已完成)
    │   ├── cmd/ internal/              # Go 源码
    │   ├── knowledge_source/           # 知识源 Markdown(运行时数据)
    │   ├── data/                       # 运行时数据(db+media,git 忽略)
    │   └── deploy/                     # 交付物(systemd/env/清理脚本/DELIVERY.md)
    ├── frontend/                       # 前端代码
    ├── CLAUDE.md
    ├── PROJECT_STATE.md
    └── .gitignore