财富潜力测试(小红书销售版)开源开发仓库。

• 已完成文档系统落地(docs/)。
• 已完成测评主链路(验单 -> 会话 -> 作答 -> 报告)。
• 已完成运营后台检索(订单/会话/报告)。
• 已完成双档题量(快速版 8 题 / 标准版 24 题)与置信度输出。
• 已完成"情境冲突型"题库与可晒标签(主标签+副标签+分享文案)。

1. 安装依赖:npm install
2. 复制环境变量:cp .env.example .env.local
3. 启动开发:npm run dev
4. 页面入口:/, /assessment, /admin

• 后台支持"账号密码登录 -> cookie 会话",也支持 token 直传(x-admin-token 或 Authorization: Bearer <token>)
• 可配置环境变量:
  • ADMIN_LOGIN_USERNAME(默认 admin)
  • ADMIN_LOGIN_PASSWORD(为空时回退使用 ADMIN_TOKEN)
  • ADMIN_VIEWER_TOKEN
  • ADMIN_OPERATOR_TOKEN
  • ADMIN_ADMIN_TOKEN
  • ADMIN_TOKEN(兼容单 token,按 admin 角色处理)
• 推荐本地设置:ADMIN_LOGIN_USERNAME=admin + ADMIN_LOGIN_PASSWORD=admin + ADMIN_TOKEN=admin

1. 创建数据库:wealth_test
2. 执行脚本:db/schema.sql
3. 设置 .env.local:
   • MYSQL_ENABLED=true
   • MYSQL_HOST/MYSQL_PORT/MYSQL_USER/MYSQL_PASSWORD/MYSQL_DATABASE

默认 MYSQL_ENABLED=false,将使用内存仓储用于本地快速开发。

• POST /api/v1/xhs/order/validate
• POST /api/v1/assessment/session/create
• GET /api/v1/assessment/questions
• POST /api/v1/assessment/submit
• GET /api/v1/report/:reportId
• POST /api/v1/share-card/generate
• GET /api/v1/admin/dashboard
• GET /api/v1/admin/orders
• GET/POST /api/v1/admin/redeem-codes
• GET /api/v1/admin/sessions
• GET /api/v1/admin/reports
• GET /api/v1/admin/reports/export
• GET /api/v1/admin/trace/:id
• GET /api/v1/admin/monitor
• GET /api/v1/admin/audits
• POST /api/v1/admin/xhs/diagnose
• POST /api/v1/report/export
• GET /api/v1/report/export/download
• GET /api/v1/health
• POST /api/v1/redeem-code/validate

• 快速烟测:npm run smoke
• 发布门禁自检:npm run release:check -- http://localhost:3000 ORDER-10001 admin
• 小红书映射探测:./scripts/xhs_live_probe.sh http://localhost:3000 ORDER-10001 admin
• 小红书样本回放:npm run xhs:replay
• 单元测试基线:npm test

• XHS_MODE=live
• XHS_APP_KEY=...
• XHS_APP_SECRET=...
• XHS_OPEN_BASE_URL=https://open.xiaohongshu.com
• XHS_ORDER_VALIDATE_PATH=/your/path
• XHS_TIMEOUT_MS=8000
• XHS_RETRY_COUNT=1
• XHS_SIGN_HEADER=x-sign
• XHS_RESPONSE_SIGN_HEADER=x-sign
• XHS_VERIFY_RESPONSE_SIGN=false

1. POST /api/v1/xhs/order/validate 获取 validationToken
2. POST /api/v1/assessment/session/create(可传 tier=quick|standard)获取 sessionId
3. GET /api/v1/assessment/questions?tier=quick|standard 获取题目
4. POST /api/v1/assessment/submit(传 tier)获取 reportId
5. 打开 /report/{reportId} 查看报告

1. 小红书虚拟商品自动发卡密(兑换码)
2. 用户进入 /assessment,选择"兑换码"校验
3. 前端调用 POST /api/v1/redeem-code/validate 获取 validationToken
4. 前端调用 POST /api/v1/assessment/session/create 开测
5. 后台 GET /api/v1/admin/redeem-codes 可追踪码状态/会话绑定

• 样本目录:fixtures/xhs/*.json
• 回放命令:npm run xhs:replay
• 用途:在未接入 live 网关前,先验证字段映射与签名校验逻辑。

• 启动服务后执行:./scripts/smoke.sh
• 可传参:./scripts/smoke.sh http://localhost:3000 ORDER-10001

• docs/README.md