1. 项目定位

本仓库是投资沙盘项目 Web 后端，产品侧又称「建投助手」「智电风控管理系统」。核心用户是投资分析、选址与风控运营人员，通过 Web/H5/飞书入口完成场站选址、资产包测算、热力图分析、建站成本与收益测算等工作。

核心业务域一览

2. 模块结构

2.1 nlfc-naas-risk-common

被 aid 与 algorithm 共同依赖，不单独启动。职责包括：

• 统一响应 R<T>、全局异常 GlobalExceptionHandler
• MyBatis-Plus、Redis、Swagger、WebMvc、线程池配置
• 腾讯云 COS 工具、Excel/JSON/IRR 等工具类
• 8 个 OpenFeign 客户端定义（跨服务契约层）
• @RemindDev 切面：定时任务失败邮件告警

2.2 nlfc-naas-risk-aid

主业务服务，启动类 AidApplication，注册名 nlfc-naas-risk-aid。包含 15 个 REST Controller、约 30+ Service、27 个 Mapper，承载沙盘、H5、城市 MAP、飞书、EAD 等全部面向前端的 API。

2.3 nlfc-naas-risk-algorithm

算法与数据同步服务，启动类 AlgorithmApplication，注册名 nlfc-naas-risk-algorithm。维护分析侧底表（热力图五步法、互联互通场站、大屏看板），并通过 Feign 回查 aid 的业务数据。

3. 技术栈

4. 系统架构

架构上存在两层算法依赖，需要区分：

• 内部 algorithm 微服务（Nacos 发现）：城市网格排名、周边场站数、大屏看板、热力图底表 T+1 同步。
• 外部智电研究院（algorithm.host URL 直连）：热力图实时计算、建站测算公式 jz-js-1/2/3、AI 报告、大数据场站同步。

5. 数据流与调用链

5.1 热力图展示（实时）

前端 → GET /sandTable/get/thermalMap
     → SandTableService
     → FinanceMetricsService（智电 executor-server / xndc）
     → 转 GeoJSON FeatureCollection 返回

5.2 热力图底表同步（批处理 T+1）

外部调度器 → GET /job/syncHotMap（algorithm）
          → 五步法：hl_station → rd_station → rd_near_station
                    → grid_centers → rd_city_hot_map
          → 每步通过 AidFeign 从 aid /externalInterface 拉数据

5.3 新建站 AI 分析（异步回调）

前端 → /newStationAiAnalyse/getNewStationAiResult
     → AlgorithmFeign（网格排名 + 周边场站数）
     → FinanceMetricsService（智电异步报告）
     → 智电回调 POST /sandTable/notify/newStationAiResultNotify

6. 基础设施

Nacos

bootstrap-{env}.yml 连接 Nacos，共享配置 application-${profile}.yml（group: naas）。本地默认 register-enabled: false。

Redis

通过 RedisService 封装，用于城市 MAP 缓存、测算中间结果等。

对象存储

主用腾讯云 COS（tx.cos.*），场景包括场站附件、EAD 跑数文件、Excel 导入结果。

数据库

7. 投资沙盘（SandTable）

沙盘是系统最核心的业务域，API 分布在多个 Controller：

核心 Service：SandTableService、SandTableInvestCalculateService、SandTableManagerService、FinanceMetricsService。空间分析使用 Uber H3 六边形网格。

主要表：cs_info、cs_operate_info、sps_info、ess_info、asset_calculate_*、new_station_ai_* 等。

8. 建站测算 H5

入口 /h5/calculate/*（StationCalculateController）。

9. 城市 MAP

相关表：station_city_map、station_city_map_detail、station_newlink_city_map、station_city_policy。

10. 算法服务（algorithm）

对外 API

algorithm 核心底表

hl_station、rd_station、station_distance、rd_city_hot_map、dimensional_data、china_energy_board 等。

11. 其他业务能力

12. aid 控制器全览

Swagger：http://{host}:{port}/swagger-ui.html

13. algorithm 控制器与 Job

14. Feign 集成矩阵

15. 部署与配置

配置层次：bootstrap.yml → bootstrap-{env}.yml → Nacos application-{profile}.yml；本地开发可参考 application-local.yml。

关键配置项

16. 定时任务（外部调度）

代码中无 @Scheduled，所有批处理通过 HTTP GET 由 K8s Cron / XXL-JOB 等触发：

失败时 @RemindDev 触发 MessageNotifyFeign 发送邮件告警。

17. 架构要点与注意事项

1. 双库架构：aid 存业务主数据，algorithm 存分析底表，经 Feign 双向同步。
2. 三层算法：本地计算（H3/DB）+ 内部 algorithm + 外部智电研究院，排障时需先定位调用层。
3. 无 MQ：异步靠 HTTP 回调，集成新异步能力时需评估是否引入消息队列。
4. 外部调度必选：未配置 Cron 则热力底表与场站同步不会自动执行。
5. 构建一致性：核对 parent artifact 与 algorithm 打包 finalName，避免部署错 JAR。

naas-nef-invest · com.newlink · 投资沙盘 Web 后端架构指南