58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
# 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 数据、上传图片和生成文件。
|
||
|
||
## 免责声明
|
||
|
||
本项目报告定位为娱乐占卜与自我反思，不构成医学、心理、职业、财务、投资或任何人生决策建议。
|