# PAF

**Repository Path**: tenpercentengineer/paf

## Basic Information

- **Project Name**: PAF
- **Description**: PAF问卷，flutter+Django
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-24
- **Last Updated**: 2025-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 心理测试应用 (Psychological Assessment Form)

一个基于Flutter + Django的心理测试应用，集成DeepSeek AI进行心理分析。

## 项目结构

```
PAF_demo/
├── PAF_frontend/          # Flutter前端应用
│   ├── lib/              # Flutter源代码
│   ├── pubspec.yaml      # Flutter依赖配置
│   └── .cursorrules      # Flutter开发规则
├── PAF_backend/           # Django后端API
│   ├── psychological_assessment_backend/  # Django项目
│   ├── requirements.txt  # Python依赖
│   ├── env.example       # 环境变量示例
│   └── .cursorrules      # Django开发规则
└── README.md             # 项目说明
```

## 功能特性

- 🎨 治愈系UI设计，对心理健康用户友好
- 📱 移动端Web应用，支持手机访问
- 🤖 集成DeepSeek AI进行心理分析
- 📊 生成专业的心理测试报告
- 🔗 支持短链接分享
- 💾 MVP版本，无需数据库

## API接口

| 接口                   | 方法   | 描述            |
| -------------------- | ---- | ------------- |
| `/api/submit/`       | POST | 提交心理测试答案，返回分析 |
| `/api/result/<uuid>` | GET  | 获取历史分析报告      |
| `/api/shortlink/`    | GET  | 创建短链接（可选）     |

## 快速开始

### 后端设置

1. 进入后端目录：
   ```bash
   cd PAF_backend
   ```

2. 创建虚拟环境：
   ```bash
   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   # 或 venv\Scripts\activate  # Windows
   ```

3. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

4. 配置环境变量：
   ```bash
   cp env.example .env
   # 编辑.env文件，填入DeepSeek API密钥
   ```

5. 运行开发服务器：
   ```bash
   python manage.py runserver
   ```

### 前端设置

1. 进入前端目录：
   ```bash
   cd PAF_frontend
   ```

2. 安装依赖：
   ```bash
   flutter pub get
   ```

3. 运行应用：
   ```bash
   flutter run -d chrome  # Web版本
   ```

## 技术栈

### 前端
- Flutter 3.8+
- Material Design 3
- Provider状态管理
- HTTP网络请求

### 后端
- Django 5.2+
- Django REST Framework
- DeepSeek AI API
- CORS支持

### 开发工具
- VS Code/Cursor
- Flutter DevTools
- Django Debug Toolbar

## 开发规范

- 前端遵循 `.cursorrules` 中的Flutter开发规范
- 后端遵循 `.cursorrules` 中的Django开发规范
- 治愈系UI设计，注重用户心理感受
- 代码注释清晰，易于维护

## 部署说明

### 后端部署
- 设置环境变量
- 配置CORS域名
- 使用Gunicorn或uWSGI

### 前端部署
- 构建Web版本：`flutter build web`
- 部署到静态文件服务器

## 许可证

本项目仅用于学习和开发目的。