126 lines
4.0 KiB
Markdown
126 lines
4.0 KiB
Markdown
# 学业邑规划 - 多元智能测评小程序
|
|
|
|
基于多元智能理论的学业规划测评系统，帮助学生发现自身优势智能，提供个性化学业规划建议。
|
|
|
|
## 项目概述
|
|
|
|
本项目包含微信小程序端和后台管理系统，提供完整的测评、报告生成、订单管理、分销等功能。
|
|
|
|
## 设计资源
|
|
|
|
- **Figma 设计图**: https://www.figma.com/design/88edYGASUcyID6afiwILdf/项目?node-id=432-1991
|
|
- **切图资源**: `docs/切图/`
|
|
- **设计图截图**: `docs/设计图/`
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
mi-assessment/
|
|
├── docs/ # 文档资料
|
|
│ ├── 需求文档.md # 产品需求说明
|
|
│ ├── 数据库设计文档.md # 数据库设计
|
|
│ ├── 开发文档.md # 开发指南
|
|
│ ├── 开发规范/ # 编码规范
|
|
│ │ ├── 1-编程规约/ # 命名、代码、注释规范
|
|
│ │ └── 2-异常日志/ # 日志、异常处理规范
|
|
│ ├── 设计图/ # UI 设计图截图
|
|
│ ├── 切图/ # UI 切图资源
|
|
│ └── 题库和结论/ # 测评题库与报告模板
|
|
│ ├── 0.参考题库和结论/ # 参考资料
|
|
│ ├── 1.各分析报告对应题目/ # 题目分类
|
|
│ └── 2.分析报告/ # 各类分析报告模板
|
|
│
|
|
├── server/ # 后端服务
|
|
│ ├── MiAssessment/ # .NET 10 后端项目
|
|
│ │ ├── src/
|
|
│ │ │ ├── MiAssessment.Api/ # 小程序 API
|
|
│ │ │ ├── MiAssessment.Admin/ # 后台管理 API + 前端
|
|
│ │ │ ├── MiAssessment.Admin.Business/# 后台业务模块
|
|
│ │ │ ├── MiAssessment.Core/ # 核心业务逻辑
|
|
│ │ │ ├── MiAssessment.Infrastructure/# 基础设施
|
|
│ │ │ └── MiAssessment.Model/ # 数据模型
|
|
│ │ ├── scripts/ # 数据库初始化脚本
|
|
│ │ └── tests/ # 单元测试
|
|
│ └── README.md
|
|
│
|
|
└── uniapp/ # 小程序前端 (UniApp + Vue 3)
|
|
```
|
|
|
|
## 技术栈
|
|
|
|
| 端 | 技术 |
|
|
|----|------|
|
|
| 小程序前端 | UniApp + Vue 3 + TypeScript |
|
|
| 后台管理前端 | Vue 3 + TypeScript + Vite |
|
|
| 后端服务 | .NET 10 + Entity Framework Core |
|
|
| 数据库 | SQL Server 2022 |
|
|
| 缓存 | Redis |
|
|
|
|
## 核心功能
|
|
|
|
### 小程序端
|
|
- 微信授权登录
|
|
- 多元智能测评答题
|
|
- 测评报告查看
|
|
- 学业规划建议
|
|
- 订单支付
|
|
|
|
### 后台管理
|
|
- 用户管理
|
|
- 测评管理 (题库、报告模板)
|
|
- 订单管理
|
|
- 分销管理
|
|
- 规划师管理
|
|
- 系统配置
|
|
|
|
## 快速开始
|
|
|
|
### 后端服务
|
|
|
|
```bash
|
|
cd server/MiAssessment
|
|
dotnet restore
|
|
dotnet build
|
|
|
|
# 启动小程序 API
|
|
dotnet run --project src/MiAssessment.Api
|
|
|
|
# 启动后台管理 API
|
|
dotnet run --project src/MiAssessment.Admin
|
|
```
|
|
|
|
详细说明请参考 [server/MiAssessment/TEMPLATE_README.md](server/MiAssessment/TEMPLATE_README.md)
|
|
|
|
### 后台管理前端
|
|
|
|
```bash
|
|
cd server/MiAssessment/src/MiAssessment.Admin/admin-web
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
### 小程序前端
|
|
|
|
```bash
|
|
cd uniapp
|
|
npm install
|
|
# 使用 HBuilderX 或命令行运行
|
|
```
|
|
|
|
## 文档索引
|
|
|
|
| 文档 | 说明 |
|
|
|------|------|
|
|
| [需求文档](docs/需求文档.md) | 产品功能需求说明 |
|
|
| [数据库设计文档](docs/数据库设计文档.md) | 数据库表结构设计 |
|
|
| [开发文档](docs/开发文档.md) | 开发指南与接口说明 |
|
|
| [后端 README](server/MiAssessment/TEMPLATE_README.md) | 后端服务详细说明 |
|
|
|
|
## 开发规范
|
|
|
|
- [命名风格](docs/开发规范/1-编程规约/1.1-命名风格.md)
|
|
- [代码风格](docs/开发规范/1-编程规约/1.2-代码风格.md)
|
|
- [注释规约](docs/开发规范/1-编程规约/1.3-注释规约.md)
|
|
- [日志规约](docs/开发规范/2-异常日志/2.1-日志规约.md)
|
|
- [异常处理](docs/开发规范/2-异常日志/2.2-异常处理.md)
|