eaiadminandClaude Code
6194c4733e
改名（对齐 pj0034 的 TOP_ 前缀）： - CODING_RULES.md → TOP_CODING_RULES.md，同步 5 处引用 （CLAUDE.md 目录树与启动仪式、PROJECT_STATE.md 三处、DR03、DR04、文件内 G06 自引用） 补齐通用部分 G09–G18（承接 pj0034 同名文件的通用规则，按本项目 Go / Vue3 / SQLite / Ubuntu 技术栈改写）： - G09 登录态与接口必须无状态化 - G10 配置化优先，禁止写死环境细节 - G11 素材必须可追溯，不可静默修改 - G12 长耗时任务必须异步化 - G13 先跑通主线，再细化和优化 - G14 Git 不抢戏 — 收工时统一提示一次 - G15 禁止通用名启动入口文件，启动逻辑必须在 start_dev_10231_10232.sh - G16 Windows 侧 .ps1 脚本统一 UTF-8 with BOM - G17 脚本内禁止兼容式依赖回退，必须固定单一工具链 - G18 仓库应尽量支持拷贝后直接运行 不抄的（逐条判断本项目不适用）：Python 虚拟环境、Playwright/clickflow E2E、 OSS 多租户、Amazon 平台规范检测；该判断已写进文件头说明。 G04 补第 6–10 条：全绿≠跑通、报告事实而非意图、读清用户的 bug 描述、 修 UI bug 追完整渲染链、跨区移动数据后验另一端完整性。 新增 P06 常见技术陷阱清单（11 条，全部来自本项目真实事故或核过代码的事实）： AutoMigrate 只加不删、探测脚本用完即删、worker_run.status 恒为 done、 seed 只补空字段、禁止按进程名模糊匹配杀进程、Element Plus persistent 留隐藏 DOM、动用户数据前先备份再列清单、hash 路由改 hash 不重载、 gofmt 不要整个目录 -w、git remote 禁嵌明文凭据、禁引第三方受限素材。 顺手修三处不一致：P01 索引名过时（培训平台→通用数字员工平台）、 DR03 引用的编号在重组后指向了错规则（第 6 条→G07）、第二部分标题层级。 版号 V1.0 → V1.1。 Co-Authored-By: Claude Code <noreply@anthropic.com>
114 lines
11 KiB
Markdown
114 lines
11 KiB
Markdown
# 项目状态总览（PROJECT_STATE）
|
||
|
||
> 单一事实源：新对话默认先读此文件恢复上下文；每次关键决策后必须更新。
|
||
> 最后更新：2026-09-16
|
||
|
||
## 1. 项目是什么
|
||
|
||
**eai_agentplatform** — EAI 数字员工平台（AI Agent Platform）。
|
||
纯内网本地化的企业 AI 数字员工平台，围绕数字员工（专家）、知识库底座、自动化工坊、
|
||
考试评估与系统管理组织业务能力。配套全局 AI 助手。
|
||
|
||
## 2. 当前状态
|
||
|
||
### 已完成
|
||
- ✅ PRD V1.1 最终定稿（docs/PRD.md / 设计稿）
|
||
- ✅ 文档架构搭建（docs/ 体系）
|
||
- ✅ 编码规范制定（TOP_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驱动） | 已定 |
|
||
| 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/`。站内通知如需恢复，按当前实现重新设计，不再依赖冻结稿。 | 已更新 |
|
||
| 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 份 | 已定 |
|
||
| D24 | SQLite **定期备份内置进二进制**（不用外部 cron/systemd timer）：启动时补一次 + 每小时查是否到期，默认间隔 24h、保留最近 7 份，落在 `data/backups/`（systemd 是 `ProtectSystem=strict`，只放开了 `data/` 可写）。快照用 `VACUUM INTO` 而非 `cp` 主库 —— 边服务边写时 `cp` 可能拷到写了一半的页。产出自检 SQLite 文件头，不合格即删。另提供 `-backup` 子命令供升级/迁移前手工备一份。**边界**：只防误删/误改/写坏，不防整盘损坏，跨机保存仍需人工 | 已定（见 `deploy/DELIVERY.md` 第 7 节） |
|
||
| D25 | 平台总架构继续采用 6 层，但第 5 层正式升级为 **对象层（Expert / Skill / App）**；新增与“专家 / 技能”并列的第三类一级对象 **App**，其定位是“长程任务运行壳”而非页面或大技能。任务统一定义为“工作实例容器”，可挂载主 `app`、右栏 `expert`、后台 `skill`；消息流降级为对话轨迹，长程状态由 `app_state + app_event + domain_data` 承载。产品一级导航目标态需完整描述为 **新建任务 / 项目 / 专家·技能·连接器 / 长程APP / 知识库 / 后台管理 / 我的**，其中 `知识库` 被确认为组织级默认必装的内建 App，拥有一级直达入口；其它专题型业务主导航后续应优先收敛为 `app` 并归入“长程APP”。文档锚点：`docs/01_System_Overall/SY22_Role_Skill_App_Unified_Task_Architecture.md` | 已定 |
|
||
| D26 | 路由命名正式拆分为三类以避免混同：`ai_route_*` 专指 AI 模型路由；`object_entry_route` 专指 Expert / Skill / App 等业务对象的进入入口；`page_route` 专指普通页面导航。后端 API、前端对象配置与导航配置均按该口径收口；旧 `route / entry_route` 已降为启动时一次性迁移并随后删除的历史列，不再保留为日常兼容字段。 | 已定 |
|
||
|
||
## 4. 文档索引
|
||
|
||
| 文档 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| PRD | `../docs/PRD.md` | 产品需求文档（V1.1 最终版） |
|
||
| 设计稿 | `../docs/eaisalestrain_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 题） |
|
||
| 编码准则 | `../TOP_CODING_RULES.md` | 编码与调试最高准则 |
|
||
| AI 协作锚点 | `CLAUDE.md` | AI 新对话启动仪式 |
|
||
|
||
## 5. 目录结构（当前）
|
||
|
||
```
|
||
pj0235-eai_agentplatform-ubu/ # 工作区根（仓库根）
|
||
├── TOP_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
|
||
│ ├── eaisalestrain_app设计稿.md # 完整 PRD 中文原稿
|
||
│ └── 博昇产品与渠道合作表.md # 知识源权威数据
|
||
└── eai_agentplatform/ # 应用代码
|
||
├── 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
|
||
```
|