chore: 整理项目结构，清理归档文件，更新部署配置

2026-07-04 21:01:39 +08:00
parent 8bd4ab0366
commit 64ff1bf7d5
508 changed files with 43575 additions and 14129 deletions
@@ -0,0 +1,52 @@
+# 企微智能 IT 支持服务台 — 项目全量知识库
+
+> **项目代号**:`wecom_it_smart_desk`
+> **状态**:v0.5.0-beta 内测(2026-06-15),v0.4.x 仍为生产稳定版
+> **目标用户**:公司 6000 员工(企微 IM)
+> **核心痛点**:员工绕过 AI 直接找人工 / AI 转人工需另开窗口 / 无法跨主体共享
+> **核心方案**:自研 IT 服务坐席系统,基于企微自建应用消息 API
+> **演进路径**:M1 消息接管 → M2 AI 接入 → M3 知识库闭环
+> **本文档用途**:Claude 全面接管项目后的"项目大脑" — 完整功能/架构/集成/部署/安全/历史决策清单
+> **最后更新**:2026-06-15(项目从 WB 移交到 Claude 接管)
+
+---
+
+## 0. 项目移交状态(2026-06-15)
+
+| 项目 | 状态 |
+|---|---|
+| 项目控制方 | **Claude 全面接管**(原由 Workbuddy CN 推进,2026-06-15 起停用) |
+| WB 项目目录 | `D:\资料\03-项目开发\wecom_it_smart_desk`(待用户授权后归档封存) |
+| Claude 工作目录 | `D:\资料\03-项目开发\wecom_it_smart_desk-claude`(唯一 active 副本) |
+| 代码托管 | Gitea(自托管 NAS 8418 端口),推送前需重新获 token |
+| 移交决策原因 | WB 1009 上下文冲突 + token 误吊销 + 大量功能信息丢失 |
+| 关联 memory | `project-handover-to-claude` / `gitea-push-permission-revoked-2026-06-15` |
+
+---
+
+## 1. 业务背景
+
+### 1.1 公司规模与用户
+- 6000 员工,全国分子机构
+- 内部 IM:企业微信(企微)
+- 现有痛点:
+  - 员工绕过 AI 直接找人工,AI 筛选率极低
+  - AI 转人工需另开窗口,体验割裂
+  - 企微"员工服务"不支持跨企业应用共享
+
+### 1.2 核心设计理念
+- **并行协作**(非传统串行排队):AI 全程在线 + 人工随时介入 + 员工同一窗口无缝切换
+- **统一入口**(v0.5):企微工作台 → 唯一 OAuth2 认证点 → 角色检测 → 路由到用户端/坐席端/管理端
+- **AI Wingman**(v0.6+):AI 不仅是服务员工的,更是解放坐席的
+
+### 1.3 三步演进路径
+
+| 里程碑 | 周期 | 核心交付 | 状态 |
+|---|---|---|---|
+| **M1** 消息接管 + 极简坐席 | 6-8 周 | 企微 API 链路 · 三栏工作台 · H5 双栏 · 邀请功能 | ✅ 代码完成,部署中 |
+| **M2** AI 机器人接入 | M1 后 4-6 周 | 千问/Dify/RAGFlow · AI 前置筛选 · 排队系统 | 📋 计划中 |
+| **M3** 知识库闭环 | M2 后 4-6 周 | 坐席标注系统 · 千问自动分析 · 知识库自优化 | 📋 计划中 |
+
+---
+
+*注：完整内容已移至 docs/ 目录统一管理*