From 1992232fda86ba6f5c60b7ef8939593419612e29 Mon Sep 17 00:00:00 2001 From: HaHafeng Date: Sun, 16 Nov 2025 15:44:28 +0800 Subject: [PATCH] docs: add testing guides and phase summaries - Add AI quick start guide (START-HERE-FOR-AI.md) - Add Phase 1-3 testing guides and summaries - Add feature testing documentation (review, citation) - Add environment check scripts - Add one-click startup script - Add test user initialization scripts - Add testing records and issue tracking --- START-HERE-FOR-AI.md | 107 +++++++++++++++++++++++++++++++++++++++ stop-all-services.bat | 113 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 220 insertions(+) create mode 100644 START-HERE-FOR-AI.md create mode 100644 stop-all-services.bat diff --git a/START-HERE-FOR-AI.md b/START-HERE-FOR-AI.md new file mode 100644 index 00000000..fc776d75 --- /dev/null +++ b/START-HERE-FOR-AI.md @@ -0,0 +1,107 @@ +# 🤖 AI对话快速入口 + +> **欢迎新的AI对话！** 👋 +> **本文档是您的快速入口，3分钟了解项目全貌** + +--- + +## 📍 从这里开始 + +### 第一步：阅读核心对接文档 ⭐⭐⭐ + +**必读文档（5-10分钟）：** + +📄 **`docs/[AI对接] 项目状态与下一步指南.md`** + +这个文档包含： +- ✅ 项目概况和技术栈 +- ✅ 当前架构状态（前后端、数据库） +- ✅ 已完成的工作 +- ✅ 下一步明确任务 +- ✅ 必读文档清单 +- ✅ 关键技术信息 +- ✅ 常见问题速查 + +--- + +## 🚀 快速上手路径 + +### 如果是全新AI对话 + +``` +阅读顺序： +1️⃣ 本文档（3分钟） +2️⃣ docs/[AI对接] 项目状态与下一步指南.md（5-10分钟） +3️⃣ docs/08-项目管理/下一阶段行动计划-V2.2-完整版.md（15分钟） +4️⃣ docs/00-系统总体设计/前后端模块化架构设计-V2.md（10分钟） +``` + +**总计：** 30-40分钟全面了解项目 + +--- + +### 如果是继续某个具体任务 + +**直接跳转到：** +- **开发ASL模块？** → 读 ASL需求分析文档 + CloseAI集成指南 +- **前端开发？** → 读 前后端模块化架构设计-V2.md（前端章节） +- **后端开发？** → 读 前后端模块化架构设计-V2.md（后端章节） +- **数据库设计？** → 读 Schema隔离架构设计文档 + +--- + +## 🎯 当前状态速览 + +| 项目 | 状态 | 说明 | +|------|------|------| +| **数据库** | ✅ 已完成 | 10个Schema隔离，11个表迁移完成 | +| **后端** | ✅ 功能正常 | Prisma配置完成，API正常工作 | +| **前端** | ✅ 框架完成 | Frontend-v2创建，6个模块占位 | +| **下一步** | 🎯 进行中 | Week 2 Day 7 - 模块注册完善 | +| **重点任务** | 📋 Week 3-4 | ASL模块开发（4个LLM文献筛选） | + +--- + +## 📞 获取帮助 + +**遇到问题时：** + +1. **技术问题** → 查阅 `docs/07-运维文档/` +2. **架构疑问** → 查阅 `docs/00-系统总体设计/` +3. **任务不明** → 查阅 `docs/08-项目管理/下一阶段行动计划-V2.2-完整版.md` +4. **代码规范** → 查阅 `docs/00-系统总体设计/前后端模块化架构设计-V2.md` + +--- + +## 🌟 核心文档清单 + +### 必读文档（⭐⭐⭐） +1. `docs/[AI对接] 项目状态与下一步指南.md` - **从这里开始！** +2. `docs/08-项目管理/下一阶段行动计划-V2.2-完整版.md` - 详细计划 +3. `docs/00-系统总体设计/前后端模块化架构设计-V2.md` - 架构设计 + +### 重要文档（⭐⭐） +4. `docs/09-架构实施/01-Schema隔离架构设计（10个）.md` - 数据库设计 +5. `docs/02-通用能力层/01-LLM大模型网关/03-CloseAI集成指南.md` - LLM配置 + +### 参考文档（⭐） +6. `docs/03-业务模块/AIA-AI智能问答/02-技术设计/01-数据库设计.md` +7. `docs/03-业务模块/PKB-个人知识库/02-技术设计/01-数据库设计.md` +8. `docs/01-平台基础层/06-前端架构/01-前端总体架构设计.md` + +--- + +## ⚡ 一句话总结 + +**我们正在构建一个模块化的AI临床研究平台，已完成数据库Schema隔离和前端框架搭建，下一步是完善前端模块机制，然后在Week 3-4开发AI智能文献模块（支持4个LLM的文献筛选）。** + +--- + +**文档路径：** `AIclinicalresearch/START-HERE-FOR-AI.md` +**最后更新：** 2025-11-12 18:00 + +**🤖 祝新的AI对话顺利！** 🚀 + + + + diff --git a/stop-all-services.bat b/stop-all-services.bat new file mode 100644 index 00000000..57c343f8 --- /dev/null +++ b/stop-all-services.bat @@ -0,0 +1,113 @@ +@echo off +echo ======================================== +echo Stop All Services +echo ======================================== +echo. + +echo [1] Stopping backend service (port 3001)... +for /f "tokens=5" %%a in ('netstat -aon ^| findstr :3001') do ( + set PID=%%a + echo Found process: PID=%%a + taskkill /F /PID %%a >nul 2>&1 + if errorlevel 1 ( + echo ERROR: Cannot terminate process %%a + ) else ( + echo OK: Process %%a terminated + ) +) + +echo. +echo [2] Stopping frontend service (port 5173)... +for /f "tokens=5" %%a in ('netstat -aon ^| findstr :5173') do ( + set PID=%%a + echo Found process: PID=%%a + taskkill /F /PID %%a >nul 2>&1 + if errorlevel 1 ( + echo ERROR: Cannot terminate process %%a + ) else ( + echo OK: Process %%a terminated + ) +) + +echo. +echo [3] Stopping Python service (port 8000)... +for /f "tokens=5" %%a in ('netstat -aon ^| findstr :8000') do ( + set PID=%%a + echo Found process: PID=%%a + taskkill /F /PID %%a >nul 2>&1 + if errorlevel 1 ( + echo ERROR: Cannot terminate process %%a + ) else ( + echo OK: Process %%a terminated + ) +) + +echo. +echo [4] Terminating all Node processes... +tasklist | findstr node.exe >nul +if not errorlevel 1 ( + echo Found Node processes, terminating... + taskkill /F /IM node.exe >nul 2>&1 + if errorlevel 1 ( + echo ERROR: Cannot terminate Node processes + ) else ( + echo OK: All Node processes terminated + ) +) else ( + echo INFO: No running Node processes +) + +echo. +echo [5] Terminating Python processes (uvicorn)... +tasklist | findstr python.exe >nul +if not errorlevel 1 ( + echo Found Python processes, terminating... + taskkill /F /IM python.exe >nul 2>&1 + if errorlevel 1 ( + echo ERROR: Cannot terminate Python processes + ) else ( + echo OK: All Python processes terminated + ) +) else ( + echo INFO: No running Python processes +) + +echo. +echo ======================================== +echo Cleanup Complete! +echo ======================================== +echo. +echo All services stopped. You can restart them now. +echo. +pause + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +