# rgMaster

**Repository Path**: yangmingjava/rg-master

## Basic Information

- **Project Name**: rgMaster
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 人格状态卡 - 开发指南

## 项目结构

```
E:\code\rgMaster\
├── backend/                     # FastAPI 后端
│   ├── app/
│   │   ├── api/                 # API 路由
│   │   │   ├── auth.py          # 认证API (登录、用户信息)
│   │   │   ├── personality.py   # 人格API (生成、列表)
│   │   │   ├── history.py       # 历史API (日历、曲线、统计)
│   │   │   └── user.py          # 用户API (收藏、信息更新)
│   │   ├── models/              # 数据库模型
│   │   │   ├── user.py          # 用户模型
│   │   │   ├── personality.py   # 人格模型
│   │   │   └── history.py       # 历史记录模型
│   │   ├── schemas/             # Pydantic Schemas
│   │   ├── config.py            # 配置
│   │   ├── database.py          # 数据库连接
│   │   └── main.py              # 主入口
│   ├── data/
│   │   └── personalities.json   # 人格库数据 (30个预设人格)
│   ├── requirements.txt
│   └── .env.example
│
├── miniprogram/                 # 微信小程序前端
│   ├── pages/
│   │   ├── index/               # 首页 - 状态选择
│   │   ├── result/              # 结果页 - 人格卡片
│   │   ├── history/             # 人格库 - 日历+统计
│   │   └── mine/                # 我的 - 用户中心
│   ├── utils/
│   │   └── api.js               # API工具函数
│   ├── app.js
│   ├── app.json
│   ├── app.wxss
│   └── project.config.json
│
└── docs/                        # 文档
    └── personality_card_方案文档.md
```

## 快速开始

### 1. 后端启动

#### 方式一：使用启动脚本
```bash
# Windows
双击 start-backend.bat
```

#### 方式二：手动启动
```bash
cd backend

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入微信小程序 AppID 和 Secret

# 启动服务
uvicorn app.main:app --host 0.0.0.0 --port 3000 --reload
```

### 2. 数据库配置

项目默认使用 PostgreSQL，需要：

1. 安装 PostgreSQL 数据库
2. 创建数据库：
```sql
CREATE DATABASE personality_card;
```

3. 修改 `.env` 中的数据库连接字符串：
```
DATABASE_URL=postgresql+asyncpg://用户名:密码@localhost:5432/personality_card
```

### 3. 微信小程序配置

1. 打开微信开发者工具
2. 导入项目：选择 `miniprogram` 目录
3. 修改 `project.config.json` 中的 `appid`
4. 修改 `app.js` 中的 `baseUrl` 为后端地址

## API 文档

启动后端后，访问：
- Swagger UI: http://localhost:3000/docs
- ReDoc: http://localhost:3000/redoc

### 主要 API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/auth/login` | POST | 微信登录 |
| `/api/auth/me` | GET | 获取用户信息 |
| `/api/personality/generate` | POST | 生成人格 |
| `/api/personality/list` | GET | 人格列表 |
| `/api/history/calendar` | GET | 日历数据 |
| `/api/history/statistics` | GET | 统计数据 |
| `/api/user/favorites` | GET | 收藏列表 |

## 功能特性

### ✅ 已完成
- [x] 微信登录认证
- [x] 人格生成算法 (5维度匹配)
- [x] 30个预设人格库
- [x] 每日生成次数限制
- [x] 历史记录存储
- [x] 日历打卡视图
- [x] 统计数据展示
- [x] 用户收藏功能

### 🚧 待开发
- [ ] 人格卡片图片生成
- [ ] 分享海报生成
- [ ] 分享解锁次数
- [ ] 视频广告解锁
- [ ] 推送通知提醒

## 技术栈

### 后端
- Python 3.10
- FastAPI
- SQLAlchemy (异步)
- PostgreSQL
- JWT 认证

### 前端
- 微信原生小程序
- WXSS 样式

## 注意事项

1. **微信小程序 AppID**: 需要在微信公众后台注册小程序并获取 AppID
2. **服务器域名**: 生产环境需要配置服务器域名白名单
3. **HTTPS**: 生产环境后端需要 HTTPS
4. **数据库**: 首次启动会自动创建表和初始化人格数据