simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
01e070c8ef6a352814965aa4fafca4cd57aa3303
wecom_it_smart_desk/docs/08-历史归档/wecom_it_smart_desk-清理报告.md
T
Simon 44e77dcb0e chore(docs): docs/ 目录全面重新编号 + 重组 
**重构前**（旧编号 02-11）：
- docs/02-产品需求/      → 00 产品规划/PRD
- docs/03-技术架构/      → 01-05 子目录散落
- docs/04-原型设计/      → 01-02 产品设计（HTML 原型）
- docs/05-原型设计/      → screens/
- docs/06-测试素材/      → 02-E2E / 03-功能 / 04-版本测试
- docs/07-项目管理/      → 任务说明书/日报/计划
- docs/08-安全审计/      → 审计报告
- docs/09-堡垒运维/      → toolbox / deploy
- docs/10-项目管理/      → 任务说明书（重复）
- docs/11-历史归档/      → deploy-nas-archived

**重构后**（新编号 00-07，语义化）：
- docs/00-产品开发流程与文档管理规范.md
- docs/00-版本迭代总览.md
- docs/01-产品文档/      （PRD/原型/认证/会话/AI 服务/坐席/集成）
- docs/02-技术文档/      （技术方案/架构图/重构记录/前端改造/实现配置）
- docs/03-测试文档/      （E2E/功能用例/版本报告/缺陷单）
- docs/04-运维文档/      （部署运维/运维指南）
- docs/05-运营文档/      （品牌推广/用户手册）
- docs/06-安全审计/      （审计报告）
- docs/07-项目管理/      （任务说明书/日报/计划/看板）

**净收益**：
- 目录编号与产品文档管理规范对齐（按文档阶段 01-07 编号）
- 消除 02-产品需求 与 10-项目管理 的编号重叠
- 子目录按文档类型分组（如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录）
- 把运维/安全/项目管理从 0X 散落改为 04/06/07

合计 494 文件 + 78495 行 / - 14076 行
2026-08-03 18:46:55 +08:00

8.2 KiB
Raw Blame History

wecom_it_smart_desk 目录清理报告

执行时间：2026-06-06 23:50
执行人：AI Assistant
确认方式：用户确认「全部执行（推荐）」

一、清理前后对比

指标 清理前 清理后 释放
总大小 ~524 MB ~25 MB ~499 MB (95%)
根目录文件数 102 个 ~25 个 -77 个
子目录数 6 个 6 个（结构不变） —

二、已删除文件清单

✅ 类别 A：可重生成缓存/构建产物（~519 MB）

路径 大小 说明
itdesk-images.tar 222.74 MB Docker 镜像，可重新 build
itdesk.tar.gz 1.50 MB 项目归档，已过期
frontend-agent/node_modules/ ~125 MB npm install 重装
frontend-h5/node_modules/ ~77 MB npm install 重装
backend/venv/ ~94 MB python -m venv 重建
frontend-agent/dist/ ~1.6 MB npm run build 重建
frontend-h5/dist/ ~0.3 MB npm run build 重建
backend/__pycache__/ ~0.03 MB Python 字节码缓存
frontend-agent/src/__pycache__/ 少量 Python 字节码缓存
backend/.pytest_cache/ ~0.03 MB pytest 缓存

✅ 类别 B：空文件（0 字节，~10 个）

文件 说明
api_test_agent_conv.json 空文件
backend_stderr.txt 空文件
backend_stdout.txt 空文件
npm_result.txt ~ npm_result3.txt 空文件 x3
py_test.txt ~ py_test3.txt 空文件 x3
syntax_check.txt 空文件

✅ 类别 C：根目录重复诊断/测试脚本（~50 个 .py）

删除了根目录下所有临时诊断/测试脚本，仅保留以下 5 个有用脚本并归档至 scripts/archive/：

保留并归档至 scripts/archive/：

  • simulate_wecom_enhanced.py — 企业微信模拟（增强版）
  • simulate_wecom.py — 企业微信模拟
  • import_knowledge_base.py — 知识库导入
  • start_8001.py — 启动 8001 端口
  • analyze_report.py — 报告分析

已删除（重复/临时诊断脚本）：

  • diagnose.py, diagnose2.py, diag3.py
  • check_db.py, check_deps.py, check_syntax.py, check_tables.py
  • fix_messages_table.py, fix_sqlite_schema.py
  • run_tests.py, run_tests_v2.py, run_tests_direct.py, run_tests_temp.py, run_to_tests.py, run_final.py, run_inline.py, run_compact.py, run_pytest_inline.py, run_report.py
  • restart_and_test.py, restart_v4.py, restart_backend.ps1, start_and_test.py, start_backend.bat
  • test_api_debug.py, test_db_debug.py, test_direct.py, test_fe_build2.py, test_fe_build3.py, test_frontend_build.py, test_imports.py, test_install_ws.py, test_route.py, test_ws_check.py, test_ws_full.py, test_ws_functional.py, test_ws_prereq.py, test_ws_prereq2.py, test_ws_v3.py, test_ws_verification.py
  • extract_docx.py, kill_port.py, quick_test.py, import_test.py

✅ 类别 D：后端根目录诊断脚本（~20 个 _*.py）

文件模式 说明
_check_models.py, _crud_test.py, _debug_uuid.py ... 后端诊断脚本全部删除

✅ 类别 E：过期日志/输出文件（~20 个 .txt）

文件 说明
backend_log_8001.txt, backend_log.txt 后端日志（已过期）
fe_build_final.txt, fe_build_out.txt, fe_build_out2.txt 前端构建输出
node_check.txt, node_test.txt, node_test2.txt Node 检查输出
test_api_debug_results.txt, test_db_debug_results.txt 测试结果输出
test_prereq_results.txt, test_ws_final_results.txt, test_ws_results.txt, test_ws_v3_results.txt 测试结果输出
uvicorn_check.txt, uvicorn_exe_check.txt, uvicorn_ver.txt, uvicorn_ver2.txt Uvicorn 检查输出

✅ 类别 F：遗留系统代码（~2.3 MB）

路径 说明
docs/existing_system_code/ 旧 Django 系统代码（本项目要替换的目标系统，非当前项目组成部分）

三、保留文件清单

根目录（配置文件 + 文档 + 有用脚本）

文件 大小 说明
.env 2.8 KB 根环境变量（docker-compose 用）
.env.example 2.7 KB 环境变量模板
.env.production 1.9 KB 生产环境变量
docker-compose.yml 6.7 KB Docker Compose 配置
README.md 7.4 KB 项目说明
ARCHITECTURE.md 79.9 KB 架构文档
PRD.md 36.0 KB 产品需求文档
QA_TEST_REPORT.md 11.3 KB QA 测试报告（最新）
TESTING_CALL_AGENT.md 3.6 KB 呼叫坐席测试文档

backend/ 目录（核心后端代码）

子目录 说明
app/api/ 15 个 API 路由模块
app/models/ 12 个 SQLAlchemy 模型
app/schemas/ 10 个 Pydantic schema
app/services/ 11 个业务逻辑服务
alembic/versions/ 3 个数据库迁移
tests/ 15 个 pytest 测试文件
it_smart_desk.db SQLite 数据库（304 KB）
.env, .env.example, requirements.txt 后端配置

frontend-agent/ 目录（坐席前端 Vue3）

子目录 说明
src/views/ Login.vue, Workspace.vue
src/components/chat/ 12 个聊天相关组件
src/components/assistant/ 6 个 AI 辅助面板组件
src/stores/ 5 个 Pinia store
src/api/ 8 个 API 模块
src/data/ 快速回复数据（qrData.ts）

frontend-h5/ 目录（员工 H5 前端 Vue3 + Vant）

子目录 说明
src/views/ Login.vue, ChatView.vue
src/components/chat/ 5 个聊天组件
src/stores/ 2 个 Pinia store

docs/ 目录（项目文档）

文件 说明
01-项目总览与部署手册.md 部署手册
团队沟通文档-架构消息知识库.md 架构设计
摇人-多坐席协作-技术方案.md 协作方案
正式环境独立部署架构方案.md 生产部署
ARCHITECTURE-v53-incremental.md 增量架构
PRD-v53-incremental.md 增量 PRD
*.mermaid 5 个架构图表
现有系统交接文档内容.txt 遗留系统交接说明

scripts/ 目录（构建/部署脚本）

文件 说明
build.sh 构建脚本
deploy.sh 部署脚本
read_docx.py docx 读取工具
archive/ 5 个归档脚本

nginx/ 目录

文件 说明
nginx.conf 反向代理配置

四、迁移注意事项

✅ 迁移前需要重新生成的内容

内容 生成方式
frontend-agent/node_modules/ cd frontend-agent && npm install
frontend-h5/node_modules/ cd frontend-h5 && npm install
backend/venv/ cd backend && python -m venv venv && .\venv\Scripts\activate && pip install -r requirements.txt
frontend-agent/dist/ cd frontend-agent && npm run build
frontend-h5/dist/ cd frontend-h5 && npm run build

⚠️ 迁移后需要检查/重新配置的项

  1. .env 文件：数据库连接、Dify API Key、企业微信配置等敏感信息需要重新填写
  2. backend/.env：后端环境变量需要重新配置
  3. docker-compose.yml：服务器 IP、端口映射等可能需要调整
  4. nginx/nginx.conf：服务器域名/IP 可能需要调整

📦 建议迁移方式

方式一：直接复制清理后的目录（推荐）

# 清理后只剩 ~25 MB，直接打包迁移
cd C:\Users\simon
Compress-Archive -Path wecom_it_smart_desk -DestinationPath wecom_it_smart_desk_clean.zip

方式二：Git 克隆（如果已推送到远程仓库）

git clone <repo_url> wecom_it_smart_desk_new

五、清理验证

执行以下命令验证清理结果：

# 查看总大小
Get-ChildItem "C:\Users\simon\wecom_it_smart_desk" -Recurse -File -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum | Select-Object @{n="TotalMB";e={[math]::Round($_.Sum/1MB,2)}}

# 查看根目录文件（应该只剩配置文件+文档）
Get-ChildItem "C:\Users\simon\wecom_it_smart_desk" -File | Format-Table Name, @{n="SizeKB";e={[math]::Round($_.Length/1KB,1)}}, LastWriteTime

清理报告结束

Reference in New Issue View Git Blame Copy Permalink