# 如昼商机助手后端 Java 21 / Spring Boot 4.1.2 / MySQL 8。前端位于相邻的 `rz-GB-web`。 D1–D4 代码已实现:会话登录、公司档案、分页检索与获客、平台市场聚合、匹配度及摘要快照、检索方案、八状态关注与标签、任务/SSE、实际调用和证据账本。新增单/双企业情报、项目快速/完整研判、投标文件解析与视觉、主体确认和预算恢复。D4 已补充持久化会话、单项目/整批快照问答、清理与恢复验收。2026-10-29 已接入本地指定的 MySQL 8.0.27,验证 V1–V7 迁移、健康检查、管理员登录及档案读取;104 项本地测试通过。供应商凭证及真实业务联调仍待补充,数据库重启持久化未在本次验证。 ## 配置与启动 1. 创建空的 MySQL 8 数据库 `rz_gb`,字符集 `utf8mb4`。应用账号需具备该库的建表、索引和读写权限;Flyway 会按版本迁移,不需要手动逐个执行 SQL。 2. 数据库和管理员初始信息直接维护在 `src/main/resources/application.yaml` 的 `spring.datasource` 与 `rz.admin-password` 中,打包后随 JAR 加载。部署前核对数据库地址和账号;初始密码不限制最小长度,但不能为空,UTF-8 不超过 BCrypt 的 72 字节上限;`admin` 已存在时重启不会重置密码。 3. 其余参数直接修改 `src/main/resources/application.yaml`。只有 `ZLBX_API_KEY`、`DEEPSEEK_API_KEY` 使用终端或 IDE 的环境变量;可以暂不设置,先运行登录和档案功能。 4. 从后端项目根目录启动,无需加载 `.env`: ```sh export JAVA_HOME=$(/usr/libexec/java_home -v 21) mvn spring-boot:run ``` 运行 JAR 不再依赖工作目录中的 `application-local.yaml`,修改主 YAML 后需要重新打包部署。源码主 YAML 和 JAR 均包含数据库及管理员初始化凭证,应限制访问。若需外部覆盖,可按 `application-local.example.yaml` 填写文件,再通过 `--spring.config.additional-location=file:/绝对路径/application-local.yaml` 显式加载。旧 `.env` 的数据库及其他参数不再由本项目读取。 服务默认 `http://localhost:8240`;`GET /actuator/health` 用于就绪检查。生产同源 HTTPS 部署时将主 YAML 中 `server.servlet.session.cookie.secure` 改为 `true`,反向代理 `/api` 到后端,并关闭 SSE 缓冲、设置足够的读超时。会话保存在当前实例内存,后端重启后需要重新登录;档案、任务、关注保存在数据库中。 ## 前端 ```sh cd ../rz-GB-web npm ci npm run dev ``` 默认 `http://localhost:3000`,Vite 已代理 `/api` 到 `8240`。先登录后填写公司档案,进入“服务验证”逐项测试。对话调研已接入四个真实任务入口、主体选择与预算暂停;未配置真实供应商时明确等待,不生成演示结果。 ## 测试 ```sh export JAVA_HOME=$(/usr/libexec/java_home -v 21) mvn -Djava.awt.headless=true verify ``` 自动测试仅使用 test 作用域 H2 和本地 HTTP 模拟服务,不使用真实密钥,不产生外部费用。生产不包含 H2,不会自动降级到内存库。MySQL 重启持久化和真实服务验证需补充连接/凭证后执行,参见 `docs/D1实施与验收.md`。 D3 工作流、文件矩阵与验收见 [D3 实施与验收](docs/D3实施与验收.md)。D2 接口、快照、预算及验收见 [D2 实施与验收](docs/D2实施与验收.md);基础会话、事件与配置见 [D1 实施与验收](docs/D1实施与验收.md)。需求与四天计划保持在 [docs](docs/README.md)。 D4 结果、102 项本地测试、格式/异常矩阵和真实验收待办见 [D4 实施与验收](docs/D4实施与验收.md);构建、V1–V7 初始化、部署和新增接口见 [接口契约与运行交付](docs/接口契约与运行交付.md)。