邹方成
cc352d3184
refactor: 优化API路由和响应模型 feat(admin): 添加App用户管理接口 feat(sms): 实现阿里云短信服务集成 feat(email): 添加SMTP邮件发送功能 feat(upload): 支持文件上传接口 feat(rate-limiter): 实现手机号限流器 fix: 修复计算步骤入库问题 docs: 更新API文档和测试计划 chore: 更新依赖和配置
20 lines
2.1 KiB
Markdown
20 lines
2.1 KiB
Markdown
## 目标
|
||
- 将 `scripts/api_smoke_test.py` 的示例负载替换为你提供的完整参数，保持后端现有计算逻辑不变。
|
||
|
||
## 具体改动
|
||
- 替换 `build_sample_payload()` 返回值为你提供的 JSON；字段逐项对齐：
|
||
- `asset_name`、`institution`、`industry`、`annual_revenue`、`rd_investment`、`three_year_income`、`funding_status`、`sales_volume`、`link_views`、`circulation`、`last_market_activity`、`monthly_transaction`、`price_fluctuation`、`application_maturity`、`application_coverage`、`cooperation_depth`、`offline_activities`、`inheritor_level`、`inheritor_age_count`、`inheritor_certificates`、`heritage_level`、`historical_evidence`、`patent_certificates`、`pattern_images`、`patent_application_no`、`heritage_asset_level`、`inheritor_ages`、`implementation_stage`、`coverage_area`、`collaboration_type`、`scarcity_level`、`market_activity_time`、`monthly_transaction_amount`、`platform_accounts`
|
||
- 保留 `platform_accounts`（douyin）作为后端期望的数据源；`online_accounts`（数组）不参与当前计算，保留或忽略均可；默认保留以便后续扩展。
|
||
- `application_coverage`：后端当前使用该字段计算普及分；你的参数中同时有 `coverage_area`，将按优先 `application_coverage` 使用；若 `application_coverage` 为占位（如“0”），建议同步设置为“全球覆盖”（或我在脚本中用 `coverage_area` 回填）。
|
||
- 其余数值以字符串提供，后端已通过 `safe_float` 做转换，无需脚本侧强制转数值。
|
||
|
||
## 兼容与注意
|
||
- 不改计算逻辑；仅更新脚本负载以贴合后端字段期望。
|
||
- 保持 `AdminClient` 输出“后台估值详情”和“后台估值计算步骤”打印，便于你核验。
|
||
|
||
## 验证
|
||
- 启动后端并确保迁移已执行（`step_order` 已支持 Decimal）。
|
||
- 运行脚本：`python scripts/api_smoke_test.py --base http://127.0.0.1:9991/api/v1 --phone 13800138001`
|
||
- 观察输出：用户侧成功提交，后台列表/详情显示完整数据，步骤列表非空。
|
||
|
||
——确认后我将直接更新脚本并提交。 |