# 学业邑规划 - 多元智能测评小程序

基于多元智能理论的学业规划测评系统，帮助学生发现自身优势智能，提供个性化学业规划建议。

## 项目概述

本项目包含微信小程序端和后台管理系统，提供完整的测评、报告生成、订单管理、分销等功能。

## 设计资源

- **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)