HaHafeng
19f9c5ea93
Summary of fixes: - Fix service discovery address (change .sae domain to internal IP) - Unify timezone configuration (Asia/Shanghai for all services) - Enhance ECS security group configuration (Redis/Weaviate port binding) - Add image pull strategy best practices - Add Python service memory management guidelines - Update Dify API Key deployment strategy (avoid deadlock) - Add SSH tunnel for RDS database access - Add NAT gateway cost optimization explanation Modified files (7 docs): - 00-部署架构总览.md (enhanced with 7 sections) - 03-Dify-ECS部署完全指南.md (security hardening) - 04-Python微服务-SAE容器部署指南.md (timezone + service discovery) - 05-Node.js后端-SAE容器部署指南.md (timezone configuration) - PostgreSQL部署策略-摸底报告.md (timezone best practice) - 07-关键配置补充说明.md (3 new sections) - 08-部署检查清单.md (service address fix) New files: - 文档修正报告-20251214.md (comprehensive fix report) - Review documents from technical team Impact: - Fixed 3 P0/P1 critical issues (100% connection failure risk) - Fixed 3 P2 important issues (stability and maintainability) - Added 2 P3 best practices (developer convenience) Status: All deployment documents reviewed and corrected, ready for production deployment
AI临床研究平台 - Frontend V2
版本： V2.0
创建日期： 2025-11-12
技术栈： React 18 + TypeScript + Vite + Ant Design + Tailwind CSS
📋 项目说明
这是AI临床研究平台的全新前端架构，采用模块化设计，支持：
- ✅ 顶部导航布局
- ✅ 模块化架构（5个业务模块）
- ✅ 动态模块加载
- ✅ 懒加载和代码分割
- ✅ 统一的开发规范
🚀 快速开始
安装依赖
npm install
启动开发服务器
npm run dev
构建生产版本
npm run build
预览生产构建
npm run preview
📁 项目结构
src/
├── framework/ # 框架层（平台级基础设施）
│ ├── layout/ # 布局系统
│ ├── modules/ # 模块注册系统
│ ├── router/ # 路由系统
│ ├── permission/ # 权限控制
│ └── config/ # 全局配置
│
├── modules/ # 业务模块（完全独立）
│ ├── asl/ # AI智能文献
│ ├── aia/ # AI智能问答
│ ├── pkb/ # 个人知识库
│ ├── rvw/ # 审稿系统
│ └── dc/ # 数据清洗
│
├── shared/ # 共享资源
│ ├── components/ # 通用组件
│ ├── hooks/ # 通用Hooks
│ ├── utils/ # 工具函数
│ └── api/ # API客户端
│
├── pages/ # 页面组件
│ └── HomePage.tsx # 首页
│
├── App.tsx # 应用根组件
└── main.tsx # 应用入口
🎯 模块说明
已实现
- ✅ 框架层：顶部导航、主布局、模块注册
- ✅ 占位页面：5个模块的占位展示
- ✅ 首页：模块入口和统计信息
开发中
- 🚧 ASL模块：Week 3 开发（AI智能文献）
待开发
- 📋 AIA模块：AI智能问答（后续重写）
- 📋 PKB模块：个人知识库（后续重写）
- 📋 RVW模块：审稿系统（后续重写）
- 📋 DC模块：数据清洗（占位）
🔧 开发规范
命名规范
- 组件文件：PascalCase（
TopNavigation.tsx） - Hooks文件：camelCase + use前缀（
useAuth.ts） - 工具函数：camelCase（
formatDate.ts） - 类型定义：PascalCase（
types.ts）
路径别名
使用 @/ 作为 src/ 的别名：
import TopNavigation from '@/framework/layout/TopNavigation'
import Placeholder from '@/shared/components/Placeholder'
模块开发
每个新模块需要：
- 在
src/modules/[模块名]/创建目录 - 创建
index.tsx作为模块入口 - 在
moduleRegistry.ts中注册模块 - 实现模块的
ModuleDefinition接口
📚 相关文档
🔗 API代理
开发环境下，所有 /api/* 请求会被代理到后端服务器：
Frontend: http://localhost:3000
Backend: http://localhost:3001
📝 TODO
- 实现权限控制系统
- 添加用户认证流程
- 实现面包屑导航
- 添加全局状态管理
- 完善错误处理
- 添加单元测试
维护者： 开发团队
最后更新： 2025-11-12