feat: govern knowledge assets and source citations

2026-08-02 01:43:43 +08:00
parent cafb836cda
commit 699cc08050
144 changed files with 17205 additions and 453 deletions
@@ -40,7 +40,7 @@ portless run --name wygj-api ./scripts/dev-backend.sh

 Windows 10/11 + Docker Desktop 不要从 PowerShell 直接执行 `./scripts/dev.sh`：Windows 的 `bash` 可能解析到 WSL，而 WSL 的 Node、Docker 集成和检出文件换行符未必满足脚本要求。使用本文件的 [Windows 10/11 + Docker Desktop](#windows-docker-desktop) 流程。

-本地启动默认关闭管理端图形验证码；需要专门验证验证码链路时设置 `AIHR_DEV_CAPTCHA_ENABLED=true`。生产启动不使用该开发开关，验证码保持开启。
+本地启动默认关闭管理端图形验证码和移动端短信验证码校验；移动端开发页只需输入手机号并同意协议即可登录，无需请求验证码。需要专门验证验证码链路时，后端设置 `AIHR_DEV_CAPTCHA_ENABLED=true`、`AIHR_SMS_VERIFICATION_ENABLED=true`，移动端同时设置 `VITE_SMS_VERIFICATION_ENABLED=true`。生产不复用本地免验证码设置，短信校验默认保持开启。

 重复启动或切换分支时优先使用 `./scripts/dev.sh restart`，停止使用 `./scripts/dev.sh stop`。脚本会递归终止 portless 包装进程及其 Java/Vite 子进程，避免旧后端脱离后继续占用 MySQL 连接池；进程树回归可用 `bash scripts/tests/process-tree.test.sh` 验证。

@@ -65,7 +65,7 @@ AIHR_SMS_LOGIN_TEMPLATE_ID=SMS_xxxxxx
 ALIYUN_SMS_ACCESS_KEY_ID=xxx
 ALIYUN_SMS_ACCESS_KEY_SECRET=xxx
 ALIYUN_SMS_SIGN_NAME=物业AI助手
-# 演示兜底：非空则不真发短信，验证码固定为该值；dev 默认 123456
+# 仅在显式开启短信校验时使用：非空则不真发短信，验证码固定为该值
 AIHR_SMS_DEV_FIXED_CODE=123456
 # prod 默认 false；试点期仅在明确接受固定码风险时与上一项同时开启
 AIHR_SMS_PROD_FIXED_CODE_ENABLED=false
@@ -85,7 +85,7 @@ AIHR_AI_SPEECH_ENABLED=true

 全网检索访问密钥使用数据库表 `aihr_web_ai_secret` 中自动生成的主密钥加密，不依赖环境变量，也不通过通用参数接口回显。数据库迁移、备份和恢复必须同时保留该表；丢失或修改主密钥后需要重新保存提供方密钥。全网检索提供方只接受公网 HTTPS 地址，且每次修改地址或密钥后都必须重新连接测试，测试成功后才能启用。

-`application-dev.yml` 只保留占位和默认值，不提交真实短信密钥。dev 环境不配阿里云短信也能登录移动端：验证码固定 `123456`。
+`application-dev.yml` 只保留占位和默认值，不提交真实短信密钥。dev 默认关闭短信验证码校验；显式开启校验但不配阿里云短信时，可继续使用固定验证码 `123456`。

 <a id="windows-docker-desktop"></a>

@@ -148,7 +148,7 @@ npm --prefix mobile-uni ci
 docker compose -f docker-compose.dev.yml up -d mysql redis qdrant minio minio-init
 ```

-基础开发不要求 `.env.local`：dev 短信验证码默认固定为 `123456`，模型调用失败仍保留 seed fallback。真实短信、外部组织同步或外部 AI 模型联调时，再按前文示例创建被 Git 忽略的 `.env.local`。
+基础开发不要求 `.env.local`：dev 默认免短信验证码，模型调用失败仍保留 seed fallback。需要验证码、真实短信、外部组织同步或外部 AI 模型联调时，再按前文示例创建被 Git 忽略的 `.env.local`。

 ### 3. 启动后端

@@ -263,7 +263,7 @@ docker compose -f docker-compose.dev.yml stop
 - AIHR 真跑测试必须显式关闭父 POM 的默认跳测：`mvn -f backend/pom.xml -pl ruoyi-modules/ruoyi-aihr -am -DskipTests=false test`；普通 `mvn ... test` 只适合编译/打包检查。
 - 前端依赖已安装，Vite 已通过 portless 暴露为 `https://wygj-admin.localhost/`
 - 当前用户侧由 `./scripts/dev.sh` 通过 portless 启动 `mobile-uni`，入口 `https://wygj-mobile-uni.localhost/h5/`；旧移动端兜底仅在 `PORTLESS=0` 调试时启动到 `5174`
- 移动端手机号登录页已接 `/resource/sms/code` 与 `/auth/mobile/sms-login`；未配置真实 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`、`AIHR_SMS_LOGIN_TEMPLATE_ID` 时不会发送阿里云短信；手机号不存在时会自动注册为 `app_user`
+- 移动端手机号登录页已接 `/resource/sms/code` 与 `/auth/mobile/sms-login`；dev 默认隐藏验证码控件并跳过短信校验，手机号不存在时会自动注册为 `app_user`。显式开启验证码后，未配置真实 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`、`AIHR_SMS_LOGIN_TEMPLATE_ID` 时不会发送阿里云短信
 - 移动端员工端“开始训练”已复用 `/api/train/practice/start`、`/turn`、`/finish`；移动端请求需带登录返回的 `Authorization` 与 `clientid`，服务端会强制当前 APP 身份和 `mode=mobile`，完成后才会改变主管端完训人数、“待复盘对练”计数、复盘列表、复盘详情、员工训练历史和能力画像。管理端训练看板的同一路径只允许 `superadmin/hr_operator` 做服务端绑定的 `mode=preview` 运营预览；预览不会冒用员工身份，也不计入上述统计、复盘或试点。
 - 移动端候选人端“开始面试/面试练习”已复用 `/api/recruit/interview/start`、`/answer`、`/finish`；“补充资料”需带移动端 `Authorization` 与 `clientid`，上传后写 `sys_oss` 和 `aihr_candidate_material`，管理端 `/recruit/interview` 可审核为 `已通过/已驳回`
 - `/dev-api/auth/tenant/list` 与 `/dev-api/auth/code` 已通过前端代理返回 `200`
@@ -405,12 +405,12 @@ Android 人工验收每完成一个步骤，用 `.\scripts\capture-android-accep
 - 案例沉淀：进入 `/knowledge/cases`，上传真实语音 → “AI 整理” → “送审” → “入库”，应看到“已完成闭环”和新增案例记录；上传必须先完成 ASR 转写。
 - SOP知识库：进入 `/knowledge/sop`，可上传 txt/md/PDF/Word/Excel/PPT 文档入库；点击“检索” → “生成训练题”，应看到“已完成闭环”、命中数据库 SOP 原文片段和训练题；数据库不可用时页面回退 seed。
 - 资料处理：进入 `/knowledge/processing`，应看到资料总量、解析任务表、处理链路、规则与风险；页面只保留“批量导入”和“刷新”，不应出现“选择目录”“服务端导入”或目录导入任务面板。**批量导入走异步队列**：提交即返回，页面出现“本次批量上传”进度面板（排队/加工中/完成/失败 + 单条重试），后台 worker 并发 2 逐条解析入库；支持多文件和 ZIP，暂存目录默认 `./.data/staging`（`aihr.upload.staging` 覆盖）。
- uni-app 员工端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/user/today/index`，手机号登录（dev 验证码固定 `123456`）。今日页进入问师傅、练习、案例素材和个人页；练习页应能完成开始练习、提交回应、结束评分、每日三题提交，个人页同步训练历史和成长证据包。每日三题正式按组织快照 `hire_date` 判断入职三个月窗口；本地 Demo 若快照尚无该字段，仅由 `dev/local` profile 且 `application-dev.yml` 的 `aihr.practice.allow-legacy-daily-drill-fallback=true` 启用训练次数回退，生产 profile 即使误传环境变量也强制关闭。
+- uni-app 员工端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/user/today/index`，dev 默认只输入手机号登录。今日页进入问师傅、练习、案例素材和个人页；练习页应能完成开始练习、提交回应、结束评分、每日三题提交，个人页同步训练历史和成长证据包。每日三题正式按组织快照 `hire_date` 判断入职三个月窗口；本地 Demo 若快照尚无该字段，仅由 `dev/local` profile 且 `application-dev.yml` 的 `aihr.practice.allow-legacy-daily-drill-fallback=true` 启用训练次数回退，生产 profile 即使误传环境变量也强制关闭。
 - 工作助手确认式统一采集：`/h5/#/pages/user/sop/index` 一级入口只保留“工作助手 / 查全网”，既有文字、ASR、媒体、数据工具和 30 分钟/最近 6 轮短会话链保持不变；显式“记一下/帮我记/保存一下”返回 `DRAFT` 确认卡，位置缺失只作可选提示。确认后写 `aihr_assistant_capture`：`PRIVATE/NOT_REQUIRED` 仅本人可见，`COMPANY/PENDING` 只表示待流转；旧项目记录继续使用 `aihr_service_memory/version`。`/h5/#/pages/user/assistant/memories` 展示待确认候选和本人已确认记录；不依赖新的 Qdrant collection，提醒默认关闭。
 - 上一条只验证当前已部署的确认式采集；项目名称下拉、项目化会话、原始来源绑定、今日工作成果和主管按日汇总仍属[后续迭代](工作助手与今日工作成果迭代计划-20260721.md)，不得在本地回归结果中写成已完成。
 - 移动端登录后若组织快照接口返回 `401/403`，只降级为手动岗位确认，不应清除手机号登录态；岗位确认页仍需允许员工选择“生活顾问”后继续进入业务页。
 - uni-app 主管端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/supervisor/index/index`，应看到团队概览、团队画像、团队预警、指派专项、待复盘和复盘详情；从团队画像派专项后，最近专项应立即回读新记录。
- uni-app 候选人端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/candidate/index/index`，手机号登录（dev 验证码固定 `123456`）→ “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到资料状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。
+- uni-app 候选人端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/candidate/index/index`，dev 默认只输入手机号登录 → “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到资料状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。
 - 真 LLM 激活：在 `/system/model` 给供应商填 api_host/api_key 并启用 `category=chat` 模型后，三角色对练的客户回复与评分即为真实 LLM 生成；再启用 `category=asr/tts` 语音路径生效。阿里云短音频 ASR 使用 `provider_code=dashscope`、`model_name=qwen3-asr-flash` 和北京工作空间的 `/compatible-mode/v1` Base URL；现有 `backend/.env` 中同一工作空间的 `AIHR_QWEN_REALTIME_ENDPOINT` / `AIHR_QWEN_REALTIME_API_KEY` 可作为本地模型管理的配置来源，但应用不会自动把私密变量导入模型表。密钥只通过模型管理或本地私密配置提供，不写入文档、SQL 或受版本控制配置。SiliconFlow SenseVoice/CosyVoice2 仍作为兼容供应商。未配置时全链路自动回退 seed。

 演示前可先跑最小预检：