docs: 更新项目结构与部署说明(apps/* 布局、monorepo 命令)
This commit is contained in:
35
README.md
35
README.md
@@ -16,6 +16,11 @@
|
||||
| 账单导出 | Excel(汇总+明细双Sheet)、单条PDF账单 |
|
||||
| 教室管理 | 教室信息维护、教室租赁记录 |
|
||||
| 押金管理 | 押金收取与退还 |
|
||||
| 班级/排课 | 班级档案、分班、教室日程与排课 |
|
||||
| 考勤管理 | 手工考勤、钉钉考勤同步、自动匹配 |
|
||||
| 教室租赁 | 租赁订单、合同、租赁日程 |
|
||||
| AI 助手 | 对话式查询、表单/导入向导/图表、业务待办引导 |
|
||||
| 组织/校区 | 组织机构与数据范围 |
|
||||
| 操作日志 | 所有涉及钱的操作自动审计留痕 |
|
||||
| 账号管理 | 用户增删改查、角色区分、启用/禁用、重置密码 |
|
||||
|
||||
@@ -42,7 +47,7 @@
|
||||
### 后端启动
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
cd apps/server
|
||||
cp .env.example .env # 复制并修改环境配置
|
||||
npm install
|
||||
npm run start:dev # 开发模式启动,默认端口 3000
|
||||
@@ -51,46 +56,48 @@ npm run start:dev # 开发模式启动,默认端口 3000
|
||||
### 前端启动
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
cd apps/admin
|
||||
npm install
|
||||
npm run dev # 开发模式启动,默认端口 5173
|
||||
```
|
||||
|
||||
### Docker 部署
|
||||
### 常用命令
|
||||
|
||||
```bash
|
||||
docker-compose up -d # 一键启动 MySQL + 后端 + 前端
|
||||
npm run typecheck # 全仓类型检查
|
||||
npm run lint # 全仓 lint
|
||||
npm run test # 全仓测试
|
||||
npm run build # 全仓构建
|
||||
```
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
├── backend/ # 后端 NestJS 服务
|
||||
├── apps/server/ # 后端 NestJS 服务
|
||||
│ ├── src/
|
||||
│ │ ├── auth/ # 认证模块 (JWT)
|
||||
│ │ ├── ai-chat/ # AI 对话、表单/导入向导/图表
|
||||
│ │ ├── attendance/ # 考勤与钉钉同步
|
||||
│ │ ├── bills/ # 账单模块
|
||||
│ │ ├── classrooms/ # 教室管理
|
||||
│ │ ├── dashboard/ # 数据面板
|
||||
│ │ ├── deposits/ # 押金管理
|
||||
│ │ ├── entities/ # 数据实体
|
||||
│ │ ├── expenses/ # 费用录入
|
||||
│ │ ├── occupancies/# 入住管理
|
||||
│ │ ├── rbac/ # 角色权限
|
||||
│ │ ├── rooms/ # 宿舍管理
|
||||
│ │ ├── students/ # 学生管理
|
||||
│ │ └── tenants/ # 租户管理
|
||||
│ │ └── students/ # 学生管理
|
||||
│ └── .env.example # 环境配置模板
|
||||
├── frontend/ # 前端 React 应用
|
||||
├── apps/admin/ # 前端 React 应用
|
||||
│ └── src/
|
||||
│ ├── api/ # API 请求封装
|
||||
│ ├── components/ # 通用组件
|
||||
│ ├── layouts/ # 布局组件
|
||||
│ └── pages/ # 页面组件
|
||||
├── docker-compose.yml # Docker 编排配置
|
||||
├── packages/ # 共享配置包
|
||||
└── 技术文档.md # 详细技术文档
|
||||
```
|
||||
|
||||
## 环境配置
|
||||
|
||||
复制 `backend/.env.example` 为 `backend/.env`,按需修改:
|
||||
复制 `apps/server/.env.example` 为 `apps/server/.env`,按需修改:
|
||||
|
||||
| 配置项 | 说明 | 默认值 |
|
||||
|--------|------|--------|
|
||||
|
||||
Reference in New Issue
Block a user