simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
72 Commits 13 Branches 7 Tags
db70a3a6a8e21c9406680be0c34b44b3ca957c53
Commit Graph

72 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Simon db70a3a6a8 feat(admin): AuditLogs + RuntimeLogs views + RBAC role management 2026-07-09 13:46:20 +08:00
Simon d480aa4c1d feat(backend): RBAC admin roles + runtime logs service 2026-07-09 13:46:15 +08:00
Simon 7ffc6c8e23 chore: add dist-deploy/ dist-v2/ to .gitignore 2026-07-09 13:46:08 +08:00
Simon adc1933038 chore: align .workbuddy/memory tracking - keep MEMORY.md tracked, untrack scratch daily log 2026-07-09 12:29:05 +08:00
Simon 4c7a8d0278 chore: extend .gitignore for residual scratch/build cache (2026-07-09 cleanup) 
补充忽略 ops-tools/ dist-new/ _tmp_* *.timestamp-*.mjs fix_redis.sh /test/ backend/scripts/create_test_agent.py, 使工作树仅剩工具态 .workbuddy 改动。
 2026-07-09 11:52:08 +08:00
Simon e4e2de47bb docs: test reports + knowledge iteration design + PRDs 
提交 OTP/RBAC/Tier0/Tier1/P0+P2 测试报告、方案A E2E 验证、知识库迭代设计(PRD/mermaid/html 原型)、项目状态看板更新; 根配置 docker-compose.yml/mkdocs.yml。
 2026-07-09 11:50:19 +08:00
Simon 584c975e7f feat(admin): knowledge iteration + ragflow ingestion views 
新增 KnowledgeIteration/RagflowIngestion 视图; api/troubleshooting/admin store 适配; 锁定 pnpm-lock.yaml。
 2026-07-09 11:50:08 +08:00
Simon 018c87e10b feat(agent): approval queue inline card + exclusion panel 
新增 ApprovalQueue 视图、ApprovalInlineCard/AgentExclusionPanel 组件与 useApprovalQueue; 对话/API 适配; public 静态资源。
 2026-07-09 11:50:07 +08:00
Simon 12d89dfb35 feat(h5): confidence gate + triage + image uploader + ws composable 
新增 ConfidenceGateBanner/ImageUploader/TriageCard 组件与 useConfidenceGate; useH5WebSocket 增强; 对话/API 适配。
 2026-07-09 11:49:50 +08:00
Simon 5e53146a9a test(backend): unit/integration tests for automation, otp, neo4j, contract 
新增自动化审批状态机/执行器/意图路由/会话管理、OTP 绑定流程、neo4j 客户端、响应契约、置信度门禁、环境门控、Tier1 API 等测试。
 2026-07-09 11:49:50 +08:00
Simon ead5f83bee feat(backend): knowledge iteration + vision + neo4j + response contract source 
dependencies.py 拆分为 dependencies/ 包; 新增 vision/ragflow_ingestion/neo4j 客户端与 h5_ai_task; alembic 045 图置信度迁移; 响应契约统一收尾。
 2026-07-09 11:47:16 +08:00
Simon f5374fce9b chore: stop tracking build artifacts & env, extend .gitignore 
移除已跟踪的部署 zip / .env.dev / disable_mfa.sql 的版本跟踪(保留磁盘, 全部可逆); .gitignore 新增产物/临时/上传/调试dump/nginx实验/截图忽略规则。
 2026-07-09 11:47:15 +08:00
Simon 50cb946e9a chore(dev): H5 dev-stack fixes + revert temp Dify key 
dev compose: 挂载 public/ (缺 duckula.webp 导致应用无法挂载)、vite proxy 目标改 VITE_PROXY_TARGET (容器内 localhost 非后端)、CSP 增加 ws://localhost:8000 (dev WS 端口)；并还原 Dify key 临时切换 (app-J3s8sHarZQ2SCaNF3xCppliL 经 dify2openai 返回空 SSE，本地 typewriter 主路径需改用 backend/.env 工作 app 才能验证)。
 2026-07-09 09:16:44 +08:00
Simon bacd34c34d fix(ws): echo WebSocket subprotocol on accept to fix browser handshake 
后端 ws_manager.connect/connect_employee 与 ws.py 调用未回显客户端协商的 Sec-WebSocket-Protocol (bearer.{token})，导致浏览器以 'Sent non-empty Sec-WebSocket-Protocol header but no response' 拒绝握手，H5/坐席 WS 实际一直走 3s 轮询兜底而非流式打字机。现回显 subprotocol 修复握手。验证：dev 真实浏览器 E2E 343 帧 typewriter；生产 docker cp 部署后日志显示 H5/坐席 WS 连接 [accepted] 且 连接建立。
 2026-07-09 09:16:43 +08:00
Simon ba068d3642 feat: H5非企微UA拦截页 + 旧MFA端点标记废弃 + 响应契约审计通过 
- H5 index.html 新增内联UA检测脚本，非企微环境显示拦截页
- CSP 添加 unsafe-inline 以支持拦截脚本
- service_routes.py 标记为 DEPRECATED（实际路由由 router.py 统一注册）
- 响应契约审计：61个端点59个使用 success_response()，2个OAuth例外设计如此
 2026-07-08 22:25:35 +08:00
Simon 9bb080d5f2 fix: 扫码OAuth回调页改为'登录成功'自动确认，不再误导用户等待手动确认 2026-07-08 22:00:17 +08:00
Simon 400ce3ddcb feat: OTP首次绑定 + 三端登录修复 + 管理端权限修复 (2026-07-08) 
OTP首次绑定:
- 新增统一 OTP 路由 /auth/otp-* (otp.py + router.py)
- 坐席端 OTP 绑定面板 (OtpBindPanel.vue)
- 管理端 OTP 管理列表 (MfaManage.vue)
- agent_login 签发半认证 token 支持首次绑定流程

三端登录修复:
- 坐席/管理端去掉'返回扫码登录'按钮
- 管理端改为二维码始终可见+轮询扫码状态
- 员工端 /itdesk/ 改为 alias 直接服务 H5 (不再301重定向)
- docker-compose 添加 h5 volume 挂载

管理端权限修复:
- 扫码登录改用 get_user_roles() 替代写死 roles=['agent']
- get_user_roles() 增加 agents.role 回退
- 新增 GET /admin/roles/user-roles 端点
- 角色管理页加载用户角色分配数据

文档更新:
- OTP PRD + 系统设计文档
- 故障排查手册 v1.1 (新增6案例)
- nginx 生产基准配置
 2026-07-08 21:54:57 +08:00
Simon 6f0fbbb066 feat(ctrt): 完成 CTRT-01~03 响应契约统一 - 三端拦截器+portal_token清理+调用点适配 2026-07-07 22:56:49 +08:00
Simon d56a9a6079 feat(auth): 完成 AUTH-01~04 后端实现 - IP白名单中间件+mfa.py删除+agents.py重构+conftest修复 2026-07-07 22:54:17 +08:00
Simon fab75760e0 WIP-CHECKPOINT[auth-refactor]: 固化工程师崩溃前部分成果 + 同树其他未提交WIP（仅源码，不含密钥/二进制）-- 待重激活工程师续作 2026-07-07 21:52:11 +08:00
Simon 242c1967ff docs: 合并部署文档 - 创建01-部署指南、02-故障排查、03-版本记录 2026-07-05 17:16:03 +08:00
Simon d6644d4d10 docs: 合并 troubleshooting 目录到 deploy 2026-07-05 17:07:57 +08:00
Simon ca7c6d937a docs: 移动蓝绿部署指南到 troubleshooting 目录 2026-07-05 17:03:36 +08:00
Simon ab90db3d3d docs: 添加蓝绿部署指南文档 2026-07-05 17:02:28 +08:00
Simon 4b20b5c5f2 docs: 更新 CHANGELOG - 添加蓝绿部署功能 2026-07-05 17:00:17 +08:00
Simon 6594431ee8 feat: 添加蓝绿部署配置 - docker-compose-green.yml, switch-blue-green.sh 2026-07-05 16:25:38 +08:00
Simon 64ff1bf7d5 chore: 整理项目结构，清理归档文件，更新部署配置 2026-07-04 21:01:39 +08:00
Simon 8bd4ab0366 docs(B-T10): 添加消息可靠性增强代码评审报告 2026-07-03 12:39:35 +08:00
Simon 6277db3951 feat(C组): C-T1~T13 AI与数据模块完成 
- C-T1 Wingman 辅助面板
- C-T2 Wingman 后端接口
- C-T3 排查流程图编辑器
- C-T4 流程图后端接口
- C-T5 流程图H5端展示
- C-T6 运营数据看板
- C-T7 看板数据接口
- C-T8 全局一致性审查(周2)
- C-T9 坐席绩效报表
- C-T10 绩效数据接口+Excel导出
- C-T11 会话智能标注
- C-T12 全局一致性审查(周3)
- C-T13 代码评审+PR创建
 2026-07-02 19:23:03 +08:00
Simon fc22de7f4d A组认证加固: P0兜底+Token刷新+环境检测+OTP+RBRAC落地+P1日志审计+Token撤销 - 全局一致性审查通过 2026-07-02 19:06:12 +08:00
Simon 78f60c6857 feat(v0.7.1): P0 修复 + 企微 SSO + RBAC 细粒度 + audit_log 
P0 修复:
- /api/ready import 错误 (_get_engine + settings.create_redis_client)
- 删 agent.otp_secret/otp_enabled 双字段 (migration 026)
- 重建 021_rbac migration (IF NOT EXISTS 兼容)

P1 新增:
- 企微 SSO (auth_wecom_sso.py, useWeChatWorkSSO composable, PortalSelect UA 检测)
- RBAC 5 角色 × 4 资源 × 4 操作 × 3 范围 (rbac_service + seed_rbac + require_permission)
- audit_log 模型 + migration 027 + 服务 + API
- 管理后台 RBAC 权限矩阵 UI (PermissionsMatrix.vue)

质量:
- pytest 405 passed / 33 pre-existing failed / 4 xfailed (v0.7.1 引入失败 = 0)
- conftest GBK patch 强制 UTF-8 读 .env
- .gitignore 排除 *.b64 (含 admin token 凭据)
- DEPLOY-v0.7.1.md 7 步 runbook + 4 坑 + 回滚预案
 2026-06-22 17:38:47 +08:00
Simon 2e6ac0f0ab docs: CURRENT-FOCUS 看板 2026-06-22 凌晨 sprint 进展(38→13 测试修复 + MkDocs + patch1 清理 + 4 agent 复核) 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-22 01:19:54 +08:00
Simon 627f4aa924 feat(deploy): v0.7.0 一键上传脚本(Windows PS) + nginx 脱敏脚本 
upload-frontend-v0.7.0.ps1:
- 自动打包 4 端 dist + scp + ssh 解压
- 用户只需在 PowerShell 跑一次

nginx-access-log-redact.sh:
- 自定义 log_format(去掉 Authorization/Cookie)
- 支持 --rollback 回滚
- nginx -t 验证语法 + nginx -s reload 热重载

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 11:56:48 +08:00
Simon e47f750b9e fix(docs): DEPLOY-QUICK-v0.7.0 镜像名修正(横杠不是下划线) 
docker tag/pull 用镜像名(横杠 wecom-it-desk-backend),
docker exec/restart 用容器名(下划线 wecom_it_backend)。

混淆后果:tag wecom_it_backend:latest → No such image。

3 处修正:
- line 53: docker tag ... → wecom-it-desk-backend:latest
- line 71: docker pull → wecom-it-desk-backend:v0.7.0
- line 116: 回滚 tag 同样修正

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 10:27:41 +08:00
Simon ffbe01e04d docs: CURRENT-FOCUS.md 清理已撤销的旧 Gitea token 记录 
旧 token 5ad83d3 已 revoke 并用 14a883d 替代,不再出现在看板。

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 09:56:15 +08:00
Simon e6c85d572e docs: CURRENT-FOCUS.md 刷新到 v0.7.0 release 收尾状态 
看板从 2026-06-16 11:10(还是 v0.5.6) → 2026-06-21 v0.7.0 收尾:
- 一句话总览:v0.7.0 完成 + 等用户部署 + 撤销 Gitea token
- in_progress:#29 集成测试
- P1 新增 3 项:部署 + 修 64 pre-existing + v1.0 IP 收窄
- P2 新增 3 项:部署拍板 + 清理包 + 清理备份
- 最近搞定:2026-06-21 凌晨 sprint 7 commits + tag v0.7.0

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 07:23:14 +08:00
Simon 8e748d1ea0 docs: CHANGELOG.md 添加 v0.7.0 release 节(2026-06-21) 
记录 v0.7.0 全部变更:
- 新增:扫码登录 / MFA 二次认证 / 高危操作守卫
- 修复:WS arg / messages UUID / wordfilter API / SQLite 编译
- 安全:OTP 30 分钟过期 + WS 签名 + nginx access_log 脱敏
- 文档:E2E 验收清单 + 一键部署 + nginx 路由 + 用户手册
- 测试:78 新增全过 + 修 5 处 pre-existing

格式基于 Keep a Changelog,链接到 v0.6.0..v0.7.0 compare。

Co-Authored-By: Claude <noreply@anthropic.com>
v0.7.0 		2026-06-21 07:16:51 +08:00
Simon 1255e95a73 docs: v0.7.0 一键部署操作包(分步命令+回滚+预计时间) 
给生产运维一站到底的部署指南:
- 步骤 1-6 顺序:备份 → migration → 重启 → 上传 4 端 → nginx → 验证
- 每步带回滚命令(任意一步失败立即回滚)
- 预计时间 15 分钟
- 容器名纠错:wecom_it_nginx(下划线不是横杠)
- RO bind mount 陷阱提醒
- Gitea token 撤销+重签+push+立刻删除流程

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 06:19:05 +08:00
Simon c33abb6ac0 fix(tests): h5_client 用 127.0.0.1 跳过企微 UA 检测 
pre-existing 失败:test_h5_oauth.py 26 个测试因为 httpx client 用 'test' 作 host,
被 h5._require_wework_ua() 拒绝(4003 请在企微中访问)。

修复:base_url 改 http://127.0.0.1,触发 _require_wework_ua 的本地开发豁免。

效果:26 failed → 18 failed(修 8 个,剩 18 是 WecomService DI 注入问题需更大改动)。

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 05:21:50 +08:00
Simon a9b97deacd fix(tests): wordfilter API 适配 + SQLite ARRAY/JSONB 补丁 + 事务隔离 
3 处 pre-existing 失败修复,测试通过率 +19:

1. content_moderation_service.py wordfilter API 适配
   - wordfilter.init() / wordfilter.add() / wordfilter.contains() 旧 API 失效
   - 改为 Wordfilter() 实例 + addWords() + blacklisted() 新 API
   - 解锁 15 个 test_content_moderation.py 测试
   - 备注: 此文件之前未 git add,本次一起纳入版本控制

2. conftest.py SQLite ARRAY/JSONB 编译补丁
   - ORM 用 PostgreSQL ARRAY(quiz.keywords)和 JSONB(themes.palette, feedbacks.images)
   - SQLite 不能直接编译 DDL,加 @compiles 降级为 JSON
   - 修复 setup 阶段 quiz_questions.keywords 的 CompileError

3. conftest.py autouse 业务表清理
   - 部分 service 内部 await self.db.commit() 绕过 db_session 的 begin_nested 回滚
   - 导致 test_feedback 列表数量测试间数据残留
   - 加 cleanup_test_data autouse fixture,每个测试 yield 后清空所有业务表

4. conftest.py wecom mock 默认 name 不覆盖 body.name
   - 默认 mock 返回 name="用户{user_id}",覆盖 agent_login body.name
   - 导致 test_conversation_grab N+1 测试期望"坐席1"失败
   - 改为返回 name="",让 body.name 保持原值

测试结果:
  - 修前: 570 ERROR (collection 阶段就挂)
  - 修后: 462 passed, 4 xfailed, 72 failed (从错误减为业务失败)
  - 失败的 72 个是 pre-existing 测试设计问题(无 token/无 UA),不阻塞部署

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 04:55:49 +08:00
Simon e96fbb2475 docs: v0.7.0 E2E 验收清单(扫码+MFA+P0 回归+回滚预案) 
35 项验收项,7 大类:
1. 扫码登录(6 项)
2. MFA 绑定(3 项)
3. MFA 验证(高危守卫,8 项)
4. P0/P1 合规(4 项)
5. 端到端业务流(3 项)
6. 性能稳定性(4 项)
7. 回滚预案

每项给预期结果 + 验证方法 + 失败处理。
部署完 v0.7.0 后逐项打勾,任何一项 ❌ 立即回滚。

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 03:12:33 +08:00
Simon bf872da8bb feat(merge): 4 个 worktree 合入 main(扫码+MFA+高危+P0) 
合入内容:
- worktree-A (auth_qrcode): 13 测试 ✅ — Phase 1.1 后端扫码登录
- worktree-B (mfa): 21 测试 ✅ — Phase 2.1 MFA TOTP + User 字段
- worktree-C (high_risk_guard): 28 测试 ✅ — Phase 1.3 高危守卫
- worktree-D (p0-fixes): 16 测试 ✅ — P0/P1 合规(WS 签名+UUID+access_log)

合并方式: 各 worktree 提取 format-patch → 只 apply 新增文件 → 手动合并 router.py/dependencies.py 冲突

新文件 (16):
  backend/alembic/versions/022_qrcode_login.py
  backend/alembic/versions/023_mfa_fields.py
  backend/alembic/versions/025_messages_id_uuid.py
  backend/app/api/auth_qrcode.py
  backend/app/api/high_risk_routes.py
  backend/app/api/mfa.py
  backend/app/schemas/mfa.py
  backend/app/schemas/qrcode.py
  backend/app/services/high_risk_guard.py
  backend/app/services/mfa_service.py
  backend/app/services/qrcode_service.py
  backend/scripts/nginx-access-log-sanitize.sh
  backend/tests/test_auth_qrcode.py (13)
  backend/tests/test_high_risk_guard.py (28)
  backend/tests/test_mfa.py (21)
  backend/tests/test_messages_uuid.py
  backend/tests/test_ws_endpoints.py
  backend/tests/test_ws_push_to_employee.py (xfail 4)

修改 (4):
  backend/app/api/router.py — 注册 auth_qrcode/high_risk_routes/mfa 3 个 router
  backend/app/dependencies.py — 加 HIGH_RISK_OPERATIONS + require_high_risk_otp
  backend/app/models/agent.py — mfa_secret/mfa_enabled/mfa_bound_at/mfa_last_verified_at
  backend/tests/conftest.py — create_test_conversation 接 db_session

测试结果(新增 78 + xfail 4):
  tests/test_auth_qrcode.py      13 passed
  tests/test_high_risk_guard.py  28 passed
  tests/test_mfa.py              21 passed
  tests/test_messages_uuid.py     8 passed
  tests/test_ws_endpoints.py      8 passed
  tests/test_ws_push_to_employee.py 4 xfailed (端点路径不一致,pre-existing)

4 端 frontend build 全部通过(agent/portal/admin/h5)

后续 TODO (用户操作):
1. 撤销 Gitea token 5ad83d... via Web UI
2. 跑 alembic upgrade head(生产 PG,025 messages UUID)
3. 应用 nginx access_log 脱敏(进容器改 conf)
4. 部署 backend + 4 端 dist + nginx reload

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-06-21 03:08:54 +08:00
Claude f564d0e42a feat(mfa-ui): 前端 MFA UI - 绑定+验证+高危弹窗+管理 (Phase 2.4 task #20) 2026-06-21 01:16:36 +08:00
Simon c1ac9b936c docs: 扫码登录+OTP 用户手册 + Phase 1+2 部署手册 (task #21 初稿) 
- docs/USER-GUIDE-QRCODE-MFA.md — 员工/坐席/管理员三端用户指南
  - 扫码登录流程
  - OTP 绑定步骤
  - 高危操作 OTP 弹窗
  - 蜂鸟 SMS 备用通道
  - 丢手机兜底(管理员后台重置)
  - 常见问题 FAQ

- docs/DEPLOY-LOGIN-MIGRATION-v0.7.0.md — 运维部署手册
  - 部署前检查(依赖/migration/配置/域名)
  - 部署步骤(后端→前端 4 端→nginx→migration→验收)
  - RO bind mount 陷阱提示
  - 容器名坑(nginx 用 wecom_it_nginx)
  - 回滚方案
  - 已知风险与缓解

后续:task #21 E2E 验收 + 集成测试会在代码合入后补充
 2026-06-21 01:14:59 +08:00
Simon c3899594d0 feat(portal): 扫码登录 + 角色自动分发 (Phase 1.3 task #16) 
- 新建 frontend-portal/src/api/qrcode.ts — /api/auth_qrcode/* API 适配
- 新建 frontend-portal/src/composables/useQrcodeLogin.ts — 扫码核心逻辑
- 新建 frontend-portal/src/views/QrcodeLogin.vue — Portal 扫码登录 UI
  - 扫码成功后按角色自动跳:
    - 只有 admin    → /itadmin/
    - 只有 agent    → /itagent/
    - admin+agent   → /itportal/select(多角色)
    - 默认 user     → /itdesk/
- 改 frontend-portal/src/router/index.ts — 默认 / → /qrcode-login
  (原 PortalSelect.vue 保留作多角色 fallback)
- 新建 docs/NGINX-DOMAIN-ROUTING.md — 运维域名分发配置模板

build: ✅ frontend-portal vue-tsc + vite build 通过
       QrcodeLogin chunk 4.82 kB
 2026-06-21 01:06:47 +08:00
Simon 8c609e72ba feat(agent): 扫码登录前端 UI (Phase 1.2 task #15) 
- 新建 src/api/qrcode.ts — 后端 /api/auth_qrcode/* API 适配层
- 新建 src/composables/useQrcodeLogin.ts — 扫码登录核心逻辑
  (create → poll 2s 间隔 → 120s 倒计时 → 状态机 waiting/scanned/confirmed/expired)
- 重写 src/views/Login.vue — 企微扫码 UI 替代原用户名表单
  - 展示后端返回的二维码 PNG(base64)
  - 倒计时 + 自动过期
  - 扫码成功后跳 /workspace
  - 管理员 OTP 场景预留按钮(Phase 2.4 集成)

build: ✅ vue-tsc + vite build 通过 (Login chunk 4.91 kB)
 2026-06-21 00:46:50 +08:00
Simon 8bfd0cfdc3 fix: v0.5.6 require_role 装饰器 signature + 3 个 schema 同步 migration 
🛠️ Bug 修复:
- backend/app/dependencies.py: 修 require_role 装饰器
  问题:@wraps 让 FastAPI 看到 __wrapped__ 签名,Depends 默认值未被解析,
        current_user 实际是 Depends 对象 → 'Depends' object has no attribute 'roles'
  修法:用 inspect 合并签名 + 手动设 wrapper.__signature__,
        把 current_user 加进 FastAPI 看到的参数列表
  影响:所有用 @require_role 的 endpoint 在生产都受影响,修后正常

📦 Dependencies:
- backend/requirements.txt: pydantic 2.7.4
  原因:2.7.5 被 PyPI yank,清华源不缓存,build 失败
  (本次不进生产,但合并时一起跟)

🗃️ Alembic migrations(3 个,生产必跑):
- 010_add_agent_otp: agents.otp_secret + agents.otp_enabled
  背景:Agent 模型加了 OTP 字段但没建 migration,坐席登录报
        'column agents.otp_secret does not exist'
  字段:otp_secret VARCHAR(64) NULL, otp_enabled BOOLEAN DEFAULT false
  安全:nullable + default,现有坐席不受影响

- 011_add_conversation_impact: conversations 3 个评估字段
  背景:坐席发消息 500 报 'column conversations.impact_scope does not exist'
  字段:impact_scope INT DEFAULT 0, is_blocking BOOL DEFAULT false,
        emotion_state VARCHAR(20) DEFAULT 'normal'
  安全:都有 default,现有会话自动填默认值

- 012_sync_remaining_fields: 模型 vs DB 剩余漂移
  背景:dev-check-schema-drift 找到 4 个 dev 模式下没暴露的字段
  字段:conversations.dify_conversation_id VARCHAR(128) NULL,
        employees.it_level VARCHAR(20) DEFAULT 'silver',
        employees.it_level_source VARCHAR(20) DEFAULT 'system',
        employees.notes JSON DEFAULT '{}'
  安全:都有 default,现有数据自动填默认值

部署:
  cd /app && python -m alembic upgrade head
  docker compose restart backend
  验证:curl http://10.90.5.110:8000/health → 200
v0.5.6 v0.7.0-alpha 		2026-06-16 19:24:27 +08:00
Simon eee2bcc071 feat(dev): 本地开发工具集 v0.5.6-dev-tooling 
包含本地 dev 链路完整跑通的工具集(不进生产):

backend:
- dev_auth.py: /api/dev/login Mock 企微 OAuth(/dev/* 路由)
- messages.py: dev 模式短路企微推送,避免 invalid corpid 噪音
- main.py: dev 模式启动时建 5 条 demo conversation,让前端有数据可测

frontend:
- PortalSelect.vue: dev 模式 enterRole 跳完整 URL(5173/5174/5175 端口),生产仍走相对路径

infrastructure:
- docker-compose.dev.yml: dev compose(包含 backend/postgres/redis)

scripts(Windows PowerShell):
- dev-frontend-install.ps1: 一次性装 4 个前端依赖
- dev-frontend-start.ps1: 后台起 4 个前端 dev server
- dev-check-schema-drift.ps1: 对比 SQLAlchemy 模型 vs Postgres schema,漂移 exit 1

docs:
- CURRENT-FOCUS.md: 项目状态看板(每次 session 维护)
 2026-06-16 19:24:02 +08:00
Simon cec5607c45 feat(admin): Flowcharts.vue JSON 在线编辑 + 9 套排查模板种子数据 
为管理后台'排查流程图'模块加 JSON 在线编辑能力 + 提供 9 套
办公 IT 常见故障排查模板种子数据(账号/系统/企微/VPN/邮箱/网络/
打印机/软件/硬件),管理员可基于此学习、筛选、修改、新增。

## 选型(按'优选开源'原则)
- @codemirror/lang-json / state / theme-one-dark / view
- codemirror(核心)
- vue-codemirror(Vue 3 集成)
- vue-json-pretty(JSON 树形预览)
全部为社区成熟开源组件,非自行开发

## 改动
- frontend-admin/package.json: 加 6 个 npm 依赖
- frontend-admin/src/api/troubleshooting.ts(新): TS 类型 +
  5 个 API client(listTemplates / getTemplate / createTemplate /
  updateTemplate / deleteTemplate) + formatJson/validateJson/
  countNodes/countDecisions 工具函数
- frontend-admin/src/components/flowchart/FlowchartEditorDialog.vue(新):
  双面板编辑器(左 CodeMirror + 右 vue-json-pretty),
  实时 JSON 校验 + 节点/决策统计 + 格式/复制/导出按钮
- frontend-admin/src/views/Flowcharts.vue(改): 列表 + 导入/导出/
  新建按钮 + EditorDialog 集成 + 文件上传 + 删除确认

## 9 套种子数据
- 01-account-password.json 账号密码
- 02-pc-system.json        电脑系统
- 03-wecom.json            企微问题
- 04-vpn.json              VPN 接入
- 05-email.json            邮箱
- 06-network.json          网络
- 07-printer.json          打印机
- 08-software.json         软件
- 09-hardware.json         硬件
每套 ~150-200 行,结构:name / category / description /
estimated_time / difficulty / tags / root_node(决策树)

## 工具脚本
- data/seed-templates/build_all.py: 合并 9 个 JSON 成 00-all.json
v0.5.6-dev-tooling 		2026-06-16 14:30:09 +08:00
Simon caf9b7ed85 feat(dev): 本地开发环境(docker-compose + Mock OAuth + 一键脚本) 
解决改代码 30-60min 才能看到结果的痛点。本地拉起完整 stack,
改代码 → 1-2min 看到结果,无需服务器。

## 交付物

### Docker stack (docker-compose.dev.yml)
- postgres:16-alpine 端口 5432
- redis:7-alpine 端口 6379
- backend 端口 8000,代码 volume mount + uvicorn --reload

### Dev 镜像 (backend/Dockerfile.dev)
- 单阶段(无需 gcc / libpq-dev)
- apt 源换阿里云(公司内网)
- 装 pytest pytest-asyncio httpx watchfiles
- CMD: uvicorn --reload

### 配置 (.env.dev, 强制 add 因 .env.* 在 .gitignore)
内容是 dev 占位符,无任何真实密钥:
- DEV_MODE=true (启用 Mock OAuth)
- WECOM_* 全部 dev_xxx 占位
- 集成系统 API 全 dev_ 占位(调用会失败但不影响主流程)

### Mock OAuth (backend/app/api/dev_auth.py)
- GET /api/dev/login?userid=xxx&name=xxx&role=xxx
  走完全真实的 TokenService.create_token(不绕过业务逻辑)
- GET /api/dev/users 列出 6 个预设 dev 用户
- GET /api/dev/health dev 模式状态自检
- 6 预设用户覆盖所有角色(user/agent/supervisor/security/admin/多角色)
- 每个端点 _dev_mode_enabled() 二次校验,生产环境访问 403

### 集成改动
- backend/app/main.py: 加 _is_dev_mode() + DEV_MODE=true 时条件挂载
  dev_auth 路由 + 启动时大声警告
- backend/app/config.py: Settings 加 dev_mode / dev_default_userid /
  dev_default_name / dev_default_dept 字段

### PowerShell 脚本
- scripts/dev-start.ps1: 5 步验证(检查 Docker / .env / compose / 健康
  / dev health),首次 2-5min build,后续秒起
- scripts/dev-stop.ps1: 停止,支持 -v 清数据卷
- scripts/dev-test.ps1: 一键跑 pytest(可选 -Frontend 跑 vitest)

## 阶段
- ✅ Phase 0 基础(本 commit)
- ⏳ Phase 1 pytest(任务 #90) - 500 bug 回归测试已就绪
- ⏳ Phase 2 vitest
- ⏳ Phase 3 playwright E2E

## 安全保证
- DEV_MODE 三个地方都校验(环境变量/settings/端点内)
- 生产环境 /api/dev/* 端点根本不存在(未挂载)
- .env.dev 是 dev 占位符,无敏感,可入 git
 2026-06-16 14:28:51 +08:00