|
|
@@ -9,6 +9,7 @@
|
|
|
| 2.3 | 2025-09-20 | 根据实际项目结构更新测试架构和共享目录 | Winston |
|
|
|
| 2.4 | 2025-09-20 | 完善BMAD全栈架构规范，添加高层架构图、API规范、安全架构 | Winston |
|
|
|
| 2.5 | 2025-09-24 | 根据项目实际情况更新技术栈信息，修正数据库类型为MySQL | Winston |
|
|
|
+| 2.6 | 2025-09-27 | 添加移动端应用架构信息，更新前端组件结构 | Winston |
|
|
|
|
|
|
## 介绍
|
|
|
|
|
|
@@ -370,6 +371,46 @@ src/client/
|
|
|
│ │ └── WordPreview.tsx # Word预览页面
|
|
|
│ ├── routes.tsx # 路由配置 (18个路由)
|
|
|
│ └── index.tsx # Home应用入口
|
|
|
+├── mobile/ # 移动端应用 (股票训练系统)
|
|
|
+│ ├── components/ # 移动端专用组件
|
|
|
+│ │ ├── Classroom/ # 课堂相关组件
|
|
|
+│ │ │ ├── ClassroomLayout.tsx # 课堂布局
|
|
|
+│ │ │ ├── ClassroomProvider.tsx # 课堂状态管理
|
|
|
+│ │ │ ├── TeacherClassControlButton.tsx # 老师课堂控制
|
|
|
+│ │ │ ├── StudentHandUpButton.tsx # 学生举手
|
|
|
+│ │ │ ├── MessageList.tsx # 消息列表
|
|
|
+│ │ │ ├── MessageBubble.tsx # 消息气泡
|
|
|
+│ │ │ └── useClassroom.ts # 课堂Hook
|
|
|
+│ │ ├── Exam/ # 考试相关组件
|
|
|
+│ │ │ ├── ExamIndex.tsx # 考试首页
|
|
|
+│ │ │ ├── ExamAdmin.tsx # 考试管理
|
|
|
+│ │ │ ├── ExamCard.tsx # 考试卡片
|
|
|
+│ │ │ └── hooks/useSocketClient.ts # Socket客户端Hook
|
|
|
+│ │ ├── stock/ # 股票相关组件
|
|
|
+│ │ │ ├── stock_main.tsx # 股票主组件
|
|
|
+│ │ │ └── components/stock-chart/ # 股票图表组件
|
|
|
+│ │ │ ├── StockChart.tsx # 股票图表
|
|
|
+│ │ │ ├── TradePanel.tsx # 交易面板
|
|
|
+│ │ │ ├── DrawingToolbar.tsx # 绘图工具栏
|
|
|
+│ │ │ └── hooks/useStockSocketClient.ts # 股票Socket Hook
|
|
|
+│ │ ├── ErrorPage.tsx # 错误页面
|
|
|
+│ │ ├── NotFoundPage.tsx # 404页面
|
|
|
+│ │ └── ProtectedRoute.tsx # 路由保护组件
|
|
|
+│ ├── hooks/ # 移动端Hooks
|
|
|
+│ │ └── AuthProvider.tsx # 认证状态管理
|
|
|
+│ ├── layouts/ # 布局组件
|
|
|
+│ │ └── MainLayout.tsx # 主布局
|
|
|
+│ ├── pages/ # 页面组件
|
|
|
+│ │ ├── ClassroomPage.tsx # 课堂页面
|
|
|
+│ │ ├── StockHomePage.tsx # 股票首页
|
|
|
+│ │ ├── XunlianPage.tsx # 训练页面
|
|
|
+│ │ ├── AuthPage.tsx # 认证页面
|
|
|
+│ │ ├── MemberPage.tsx # 会员页面
|
|
|
+│ │ ├── VideoReplayPage.tsx # 视频回放页面
|
|
|
+│ │ ├── VideoPlayerPage.tsx # 视频播放页面
|
|
|
+│ │ └── WechatCallbackPage.tsx # 微信回调页面
|
|
|
+│ ├── routes.tsx # 路由配置 (15+个路由)
|
|
|
+│ └── index.tsx # 移动端应用入口
|
|
|
├── components/ # 共享UI组件
|
|
|
│ └── ui/ # shadcn/ui组件库（50+组件）
|
|
|
│ ├── button.tsx # 按钮组件
|
|
|
@@ -391,6 +432,10 @@ src/client/
|
|
|
- **构建工具**: Vite 7.0.0
|
|
|
- **样式**: Tailwind CSS 4.1.11
|
|
|
- **HTTP客户端**: 基于Hono Client的封装 + axios适配器
|
|
|
+- **实时通信**: Socket.IO客户端 (课堂和股票实时数据)
|
|
|
+- **音视频**: 阿里云RTC SDK (实时音视频通信)
|
|
|
+- **图表**: ECharts (股票图表展示)
|
|
|
+- **日期处理**: dayjs (中文日期格式化)
|
|
|
|
|
|
### 后端组件架构
|
|
|
|
|
|
@@ -659,6 +704,13 @@ d8d-starter/
|
|
|
│ │ │ ├── pages/ # 页面组件 (14个功能页面)
|
|
|
│ │ │ ├── routes.tsx # 路由配置 (18个路由)
|
|
|
│ │ │ └── index.tsx # Home应用入口
|
|
|
+│ │ ├── mobile/ # 移动端应用 (股票训练系统)
|
|
|
+│ │ │ ├── components/ # 移动端组件 (课堂、考试、股票图表等)
|
|
|
+│ │ │ ├── hooks/ # 移动端Hooks (AuthProvider)
|
|
|
+│ │ │ ├── layouts/ # 布局组件 (MainLayout)
|
|
|
+│ │ │ ├── pages/ # 页面组件 (课堂、训练、视频等)
|
|
|
+│ │ │ ├── routes.tsx # 路由配置 (15+个路由)
|
|
|
+│ │ │ └── index.tsx # 移动端应用入口
|
|
|
│ │ ├── components/ # 共享UI组件
|
|
|
│ │ │ └── ui/ # shadcn/ui组件库 (50+组件)
|
|
|
│ │ ├── hooks/ # 共享Hooks
|
|
|
@@ -1037,8 +1089,8 @@ interface ApiError {
|
|
|
|
|
|
---
|
|
|
|
|
|
-**文档状态**: ✅ 已更新至生产就绪状态
|
|
|
-**下次评审**: 2025-10-24 (每月评审)
|
|
|
+**文档状态**: ✅ 已更新至生产就绪状态（包含移动端应用）
|
|
|
+**下次评审**: 2025-10-27 (每月评审)
|
|
|
|
|
|
**项目状态总结**:
|
|
|
D8D全栈管理后台启动模板已达到生产就绪状态，具备以下特点：
|
|
|
@@ -1046,7 +1098,11 @@ D8D全栈管理后台启动模板已达到生产就绪状态，具备以下特
|
|
|
✅ **技术架构成熟**: Node.js 20.19.2 + Hono 4.8.5 + React 19.1.0 + TypeORM 0.3.25 + MySQL 8.0.36
|
|
|
✅ **业务模块完整**: 10个业务模块，涵盖用户管理、文件系统、支付、会员、模板、解决方案等
|
|
|
✅ **开发体验优秀**: 通用CRUD服务、类型安全API、shadcn/ui组件库、完整测试覆盖
|
|
|
-✅ **前端应用完整**: 管理后台和用户前台应用均已实现，包含18个页面路由和完整的用户认证流程
|
|
|
+✅ **前端应用完整**: 管理后台、用户前台和移动端应用均已实现
|
|
|
+ - **管理后台**: 完整的管理功能，包含用户管理、文件管理等
|
|
|
+ - **用户前台**: 14个功能页面，18个路由，完整的用户认证流程
|
|
|
+ - **移动端应用**: 股票训练系统，包含课堂、考试、训练、视频回放等功能
|
|
|
+✅ **实时功能强大**: Socket.IO实时通信，阿里云RTC音视频，股票实时数据推送
|
|
|
✅ **AI驱动开发**: BMAD方法论完整集成，Roo框架开发规范，AI代理工作流支持
|
|
|
✅ **生产就绪**: 多八多云端开发容器环境，Docker Compose部署，端口8080统一访问
|
|
|
|
yourname