Agent 功能文档¶
代码：
src/agent-system/。端口 5173 /agent.localhost。
1. 定位¶
代理商门户：登录开通、经营看板、客户与交易/分佣、推广链接、结算账户绑定、客户优惠设置与导出。
不含：画布生图、会员购买 UI、提现申请 UI（后端 /api/billing/agents/me/withdraw 存在，本前端未接）。
2. 路由¶
| 路径 | 页面 | 鉴权 | 用途 |
|---|---|---|---|
/ |
AgentLogin | 公开 | 短信登录，as_agent=true，首次可自动开通 |
/login、/register/agent |
重定向 / |
— | 兼容旧入口；独立注册页已下线 |
/r/:referralCode |
LandingPage | 公开 | 兼容跳转到画布主站 /r/{code} |
/agent |
AgentDashboard | JWT | 仪表盘 |
/agent/customers |
AgentCustomers | JWT | 客户列表+导出 |
/agent/customers/:id |
AgentCustomerDetail | JWT | 客户详情与交易 |
/agent/transactions |
AgentTransactions | JWT | 交易明细+导出 |
/agent/commissions |
AgentCommissions | JWT | 分账记录+导出 |
/agent/links |
AgentLinks | JWT | 推荐码与画布推广 URL |
/agent/settlement |
AgentSettlement | JWT | 支付宝/微信扫码或商户资料 |
/agent/settings |
AgentSettings | JWT | 客户优惠比例 0~50% + 汇总导出 |
* |
NotFound | 公开 | 404 |
遗留未挂路由：Home.tsx、AgentRegister.tsx（文档标 legacy）。
3. Feature 能力¶
| Feature | 能力 |
|---|---|
| auth | 手机号验证码登录 |
| dashboard | 客户/分佣/点击统计与月度折线 |
| customers | 搜索、分页、详情下钻 |
| transactions | 充值/消费筛选；分账页 |
| links | 复制 canvas.../r/{agent_code} |
| settlement | 三模式互斥；扫码 2s 轮询；开发 mock-confirm |
| settings | 滑块保存优惠比例；导出汇总 |
| landing | 旧链跳转画布 |
4. 业务规则¶
ProtectedRoute只校验已登录，不前端强制role===agent（身份依赖后端）- 推广落地主路径在 Canvas；Agent 站
/r/:code仅跳转 - Settings 文案「客户优惠」对应 API
PUT /agents/me/commission-rate→ 字段customer_discount_rate - 结算模式切换已绑定时需确认
- 一客一代理绑定发生在画布登录后
POST /landing/{code}/bind
5. 与计费关系¶
查看交易/分佣依赖客户在 Canvas 完成支付。Admin 审批提现后，余额字段变化可在 dashboard/me 体现；本站无提现按钮。