# AI 手相报告 MVP

原生微信小程序 + Python FastAPI 后端的娱乐型手相报告应用。

## 目录

- `backend/`: FastAPI API、数据库模型、OpenAI 分析服务、图片存储。
- `miniprogram/`: 原生微信小程序页面与请求封装。
- `web/`: Next.js Web App 主产品入口。

## 本地运行后端

```bash
cd backend
python3 -m venv venv
venv/bin/pip install -r requirements.txt
cp .env.example .env
venv/bin/uvicorn app.main:app --reload
```

默认使用 SQLite 和 mock 微信登录，便于本地开发。生产环境配置 `DATABASE_URL` 为 Postgres，配置微信、OpenAI 和对象存储参数。

## 环境变量

见 `backend/.env.example`。

## 小程序

用微信开发者工具打开 `miniprogram/`，把 `utils/config.js` 中的 `API_BASE_URL` 改成后端地址。

## Web App

```bash
cd web
npm install
cp .env.example .env.local
npm run dev
```

默认连接 `http://127.0.0.1:8000/api/v1`。第一版 Web 使用匿名会话，浏览器会自动获取 token 并保存在 `localStorage`。

## Docker Compose 一键部署

```bash
docker compose up --build
```

启动后访问：

- Web App: `http://127.0.0.1:3000`
- 后端 API: `http://127.0.0.1:8000`

Compose 默认读取 `backend/.env` 中的大模型配置，并使用 Docker volume 持久化 SQLite 数据、上传图片和生成文件。

## 免责声明

本项目报告定位为娱乐占卜与自我反思，不构成医学、心理、职业、财务、投资或任何人生决策建议。