销冠培养系统 & 社恐培养系统

# 1. 克隆项目
git clone <repository-url>
cd xiaoshou

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填写 DASHSCOPE_API_KEY

# 3. 启动数据库
make db

# 4. 安装依赖
make install

# 5. 运行数据库迁移
make migrate

# 6. 在新终端启动后端
make backend

# 7. 在新终端启动前端
make frontend

./deploy.sh init-db

# 应用配置
APP_ENV=development
DEBUG=true

# 数据库 (开发环境使用 Docker 映射端口 8108/8109)
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:8108/asp_db
REDIS_URL=redis://localhost:8109/0

# JWT 认证
JWT_SECRET=your-super-secret-key-change-in-production
JWT_EXPIRE_MINUTES=1440

# 阿里云百炼 (必填)
DASHSCOPE_API_KEY=sk-xxx
DASHSCOPE_MODEL=qwen3-max
DASHSCOPE_REGION=beijing

# 实时语音对话
REALTIME_MODEL=qwen3-omni-flash-realtime
REALTIME_VOICE=Cherry

# 微信登录 (可选)
WECHAT_APP_ID=
WECHAT_APP_SECRET=
WECHAT_REDIRECT_URI=http://localhost:8110/api/v1/auth/wechat/callback
WECHAT_MP_APP_ID=
WECHAT_MP_APP_SECRET=

NEXT_PUBLIC_API_URL=http://localhost:8111/api/v1

# npm 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# pip 使用清华镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 启动数据库 (PostgreSQL + Redis)
make db

# 启动后端开发服务器 (热重载)
make backend

# 启动前端开发服务器 (热重载)
make frontend

# 运行数据库迁移
make migrate

# 创建新迁移文件
make migrate-new

# 运行测试
make test

# 代码检查 (Linter)
make lint

# 代码格式化
make format

# 清理临时文件
make clean

# 停止所有服务
make stop

cd backend

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

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

# 运行迁移
alembic upgrade head

# 启动开发服务器
uvicorn app.main:app --reload --host 0.0.0.0 --port 8111

cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 运行生产版本
npm run start

# 创建新迁移
cd backend
source .venv/bin/activate
alembic revision --autogenerate -m "描述信息"

# 应用迁移
alembic upgrade head

# 回滚迁移
alembic downgrade -1

# 查看迁移历史
alembic history

# 运行后端测试
cd backend
source .venv/bin/activate
pytest -v

# 运行测试并生成覆盖率报告
pytest --cov=app --cov-report=html

# 运行特定测试文件
pytest tests/test_agents/test_npc.py -v

# 用户注册
POST /api/v1/auth/register
Content-Type: application/json
{
  "phone": "13800138000",
  "password": "password123",
  "nickname": "张三",
  "track": "sales"  # 或 "social"
}

# 用户登录
POST /api/v1/auth/login
Content-Type: application/json
{
  "phone": "13800138000",
  "password": "password123"
}

# 响应
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "user": {
    "id": "uuid",
    "phone": "13800138000",
    "nickname": "张三",
    "track": "sales",
    "role": "user"
  }
}

# 微信登录 - 获取授权URL
GET /api/v1/auth/wechat/login-url?redirect_url=/dashboard&use_mp=false

# 响应
{
  "authorize_url": "https://open.weixin.qq.com/connect/qrconnect?...",
  "state": "abc123..."
}

# 微信登录 - 检查配置状态
GET /api/v1/auth/wechat/config

# 响应
{
  "wechat_enabled": true,
  "wechat_mp_enabled": false
}

# 创建训练会话
POST /api/v1/sessions
Authorization: Bearer <token>
Content-Type: application/json
{
  "scenario_id": "uuid",
  "mode": "train"  # train/exam/replay
}

# 发送消息
POST /api/v1/sessions/{session_id}/message
Authorization: Bearer <token>
Content-Type: application/json
{
  "content": "你好，我想了解一下你们的产品"
}

# 实时语音对话 (WebSocket)
WS /api/v1/realtime/{session_id}

# 1. 克隆项目
git clone <repository-url>
cd xiaoshou

# 2. 配置环境变量
cp .env.production.example .env
# 编辑 .env 文件，填写必要的配置（特别是 DASHSCOPE_API_KEY）

# 3. 完整部署（首次安装）
./deploy.sh full-deploy

# 只启动数据库，不启动应用
# 注意: 这里使用标准端口，如果要与项目 docker-compose.yml 一致，请使用 8108/8109
docker run -d --name postgres16 \
  -p 8108:5432 \
  -e POSTGRES_PASSWORD=postgres123 \
  -e POSTGRES_DB=asp_db \
  postgres:16-alpine

docker run -d --name redis7 \
  -p 8109:6379 \
  redis:7-alpine

# macOS (Homebrew)
brew install postgresql@16 redis
brew services start postgresql@16
brew services start redis

createdb asp_db

# Ubuntu
sudo apt update
sudo apt install postgresql postgresql-contrib redis-server
sudo systemctl start postgresql redis-server
sudo -u postgres createdb asp_db

cd backend

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

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

# 创建环境变量文件
cat > .env << 'EOF'
# 应用配置
APP_ENV=development
DEBUG=true

# 数据库 (端口统一使用 8108/8109)
DATABASE_URL=postgresql+asyncpg://postgres:postgres123@localhost:8108/asp_db
REDIS_URL=redis://localhost:8109/0

# JWT 认证
JWT_SECRET=your-super-secret-key-change-in-production
JWT_EXPIRE_MINUTES=1440

# 阿里云百炼 (必填)
DASHSCOPE_API_KEY=sk-xxx
DASHSCOPE_MODEL=qwen3-max
REALTIME_MODEL=qwen-omni-turbo-latest
REALTIME_VOICE=Cherry
EOF

# 创建数据库表
python -c "
import asyncio
from app.db.session import engine
from app.db.base import Base
import app.models

async def create_tables():
    async with engine.begin() as conn:
        await conn.run_sync(Base.metadata.create_all)
    print('Tables created!')

asyncio.run(create_tables())
"

# 创建管理员账号
python -c "
import asyncio
from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
from sqlalchemy.orm import sessionmaker
from sqlalchemy import select
from app.config import settings
from app.core.security import get_password_hash
from app.models.user import User

async def create_admin():
    engine = create_async_engine(settings.database_url)
    async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
    async with async_session() as db:
        result = await db.execute(select(User).where(User.phone == '13800000000'))
        if not result.scalar_one_or_none():
            db.add(User(phone='13800000000', hashed_password=get_password_hash('admin123'), nickname='管理员', role='admin', track='sales', level='expert'))
            await db.commit()
            print('Admin created: 13800000000 / admin123')
        else:
            print('Admin already exists')

asyncio.run(create_admin())
"

# 初始化场景数据
python -m scripts.seed_scenarios_full

# 启动后端服务
uvicorn app.main:app --reload --host 0.0.0.0 --port 8111

cd frontend

# 安装依赖
npm install

# 创建环境变量文件
echo "NEXT_PUBLIC_API_URL=/api/v1" > .env.local

# 开发模式启动
npm run dev

# 或生产模式
npm run build
npm run start

# 检查后端健康状态
curl http://localhost:8111/health

# 检查前端
curl http://localhost:8110

# 测试登录
curl -X POST http://localhost:8111/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800000000","password":"admin123"}'

# 安装 certbot
apt install certbot python3-certbot-nginx

# 申请证书
certbot --nginx -d yourdomain.com -d ws.yourdomain.com

# 自动续期
certbot renew --dry-run

# 后端
APP_ENV=production
DEBUG=false
JWT_SECRET=<强随机字符串，至少32位>
DATABASE_URL=<生产数据库地址>
REDIS_URL=<生产Redis地址>

# 后端 - 使用 Gunicorn
pip install gunicorn
gunicorn app.main:app \
  --workers 4 \
  --worker-class uvicorn.workers.UvicornWorker \
  --bind 0.0.0.0:8111

# 前端 - 使用 PM2
npm install -g pm2
pm2 start npm --name "frontend" -- start
pm2 save
pm2 startup

# 检查 Docker 服务是否运行
docker ps

# 重启数据库
make db

# 检查端口占用 (开发环境使用 8108)
lsof -i :8108

# 检查数据库连接
cd backend
source .venv/bin/activate
python -c "from app.db.session import engine; print('OK')"

# 重置迁移 (危险操作！仅开发环境)
alembic downgrade base
alembic upgrade head

npm config set registry https://registry.npmmirror.com
npm install

WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret
WECHAT_REDIRECT_URI=https://yourdomain.com/api/v1/auth/wechat/callback

# 测试 WebSocket 连接 (需要安装 wscat)
npm install -g wscat
wscat -c "wss://ws.yourdomain.com/api/v1/ws/health"

# 检查 Nginx 配置
nginx -t

# 查看后端日志
docker-compose logs -f backend | grep -i websocket