Villine/Vantage-promotion

Special Deposit Bonus Request Form

本地测试（可运行状态）

1. 1.Python 3.10+，建议建虚拟环境并安装依赖：

   python -m venv .venv
   .venv\Scripts\activate
   pip install -r requirements.txt

1. 1.配置 Lark：复制 .env.example 为 .env，填入 LARK_APP_ID、LARK_APP_SECRET、LARK_BITABLE_APP_TOKEN、LARK_BITABLE_TABLE_ID（与飞书多维表格一致）。

1. 1.可选：在 .env 中设置 DEFAULT_APPLICANT=Leon Wu（与表中「申请人」列一致，便于测本人 case）；ADMIN_PASSWORD 与后台管理页一致。

1. 1.启动（任选其一）：

• —Windows：双击 `run_local.bat`，或在 PowerShell 执行：.\run_local.ps1
• —命令行：python main.py
• —或：python -m uvicorn main:app --reload --host 127.0.0.1 --port 8000

1. 1.浏览器打开：http://127.0.0.1:8000/

1. 1.确认打的是当前后端：打开 http://127.0.0.1:8000/api/build-info ，应看到 build_id 与 resubmit_requires_admin: false。若没有，说明域名/反代指到了别的服务。

1. 1.接口文档：http://127.0.0.1:8000/docs

1. 1.子路径部署（例如 https://host/promotion/）：在 index.html 里把 window.APP_API_PREFIX 设为 "/promotion"（与反代前缀一致），并保证静态资源路径一致。

1. 1.模拟 H5 带名：http://127.0.0.1:8000/?applicant=Your%20Name

页面加载后会请求 GET /api/me，在无 ?applicant= 时把申请人同步为服务端 DEFAULT_APPLICANT，避免与后端不一致。

一键推送更新到 Hugging Face（以后更新方便）

本项目已适配 Hugging Face Spaces（sdk: docker）。如果你已经创建并首次推送过 Space，后续更新推荐用仓库根目录的一键脚本：

• —PowerShell（推荐）：

  $env:HF_TOKEN="hf_xxx"
  $env:HF_REPO_ID="YOUR_USER_OR_ORG/YOUR_SPACE_NAME"
  $env:HF_REPO_TYPE="spaces"   # spaces | models | datasets（默认 spaces）
  .\push_hf.ps1

若提示 running scripts is disabled（执行策略禁止 .ps1），任选其一：

• —不改策略，单次绕过（推荐先试）：

    powershell -NoProfile -ExecutionPolicy Bypass -File .\push_hf.ps1

• —或双击 / 在 CMD 里运行 push_hf_run.cmd（内部用 Bypass 调用 push_hf.ps1，仍需先在同一窗口设置 HF_TOKEN 等；若在 CMD 里请先 set HF_TOKEN=... 再运行 push_hf_run.cmd）。

• —长期对本用户放开（自行评估安全）：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

• —CMD / 双击：

  set HF_TOKEN=hf_xxx
  set HF_REPO_ID=YOUR_USER_OR_ORG/YOUR_SPACE_NAME
  set HF_REPO_TYPE=spaces
  push_hf.bat

说明：

• —脚本会把当前 `HEAD` 推到 Hugging Face 的 `main`（不会把 token 写进 git remote）。
• —建议先 git commit 再推送；脚本会在工作区不干净时给出提醒。

Spaces 配置说明：<https://huggingface.co/docs/hub/spaces-config-reference>