people-reading/README.md

赛博先生 Web App

面向 Web 的 AI 命理娱乐应用，当前支持手相、面相、八字三类报告生成。产品定位为“娱乐占卜 + 自我反思”，不做确定性人生判断。

目录

• backend/: FastAPI API、数据库模型、OpenAI 分析服务、图片存储。
• web/: Next.js Web App 主产品入口。

本地运行后端

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 和匿名 Web 登录，便于本地开发。生产环境可配置 DATABASE_URL 为 Postgres，并配置 OpenAI 和对象存储参数。

环境变量

见 backend/.env.example。

Web App

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 一键部署

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 数据、上传图片和生成文件。

免责声明

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