7.6 KiB
7.6 KiB
项目状态总览（PROJECT_STATE）
单一事实源：新对话默认先读此文件恢复上下文；每次关键决策后必须更新。 最后更新：2026-08-24
1. 项目是什么
eaisalestrain_app — 博昇内部培训平台。 纯内网本地化、内部专属员工培训系统，用于新人入职培训、公司认知、产品知识学习、 销售能力培训、统一考试验收。配套全局 AI 助教 PathCoach。
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） |
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 题） |
| 编码准则 | ../CODING_RULES.md |
编码与调试最高准则 |
| AI 协作锚点 | CLAUDE.md |
AI 新对话启动仪式 |
5. 目录结构（当前）
pj0231-eaisalestraining/ # 工作区根（仓库根）
├── 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 # 知识源权威数据
└── eaisalestrain_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