refactor: 优化API路由和响应模型 feat(admin): 添加App用户管理接口 feat(sms): 实现阿里云短信服务集成 feat(email): 添加SMTP邮件发送功能 feat(upload): 支持文件上传接口 feat(rate-limiter): 实现手机号限流器 fix: 修复计算步骤入库问题 docs: 更新API文档和测试计划 chore: 更新依赖和配置
2.1 KiB
2.1 KiB
目标
- 将
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 - 观察输出:用户侧成功提交,后台列表/详情显示完整数据,步骤列表非空。
——确认后我将直接更新脚本并提交。