wangxin 81b315b4f8 1
2026-11-20 17:03:35 +08:00
2026-11-20 16:51:48 +08:00
2026-11-20 16:51:48 +08:00
1
2026-11-20 16:56:54 +08:00
1
2026-11-20 17:03:35 +08:00
2026-11-20 16:51:48 +08:00
2026-11-20 16:51:48 +08:00
2026-11-20 16:51:48 +08:00
1
2026-11-20 17:00:17 +08:00

养护开发工程

工程里有两个服务:

  • tocc-infra-maint:基础服务,端口 7424,负责 SZ_MAINT 里的表。
  • tocc-system-maint:系统服务,端口 8525,给前端提供接口,通过 Feign 调用基础服务。

源码结构

养护开发工程
├── pom.xml                              # 父工程,统一依赖版本
├── lib                                  # 本机编译用的达梦驱动
│   └── DmJdbcDriver8-8.1.5.60.jar
├── sql                                  # 建表脚本
│   └── sz-maint.sql
├── maint-support                        # 本地开发支撑,交回时不进入公司工程
│   └── src/main/java/.../maint/support
│       ├── Result.java                  # 接口返回体
│       ├── PageResult.java              # 分页结果
│       ├── CurrentUser.java             # 当前用户
│       ├── CurrentUserHolder.java       # 取当前用户
│       └── LocalDevAuthFilter.java      # 本地固定用户,代替统一登录
├── tocc-infra-maint                     # 基础服务
│   ├── tocc-infra-maint-api             # 给系统服务远程调用的接口包
│   │   └── src/main/java/.../infra/maint
│   │       ├── api                      # Feign 接口,如 RoadApi
│   │       ├── model/dto                # 保存参数、分页参数、返回对象
│   │       └── constants                # 服务名与 /rpc-api/maint 前缀
│   └── tocc-infra-maint-biz             # 基础服务启动工程,端口 7424
│       └── src/main/java/.../infra/maint
│           ├── MaintInfraApplication.java
│           ├── api/impl                 # 接口实现,落到达梦
│           ├── mapper                   # MyBatis Mapper
│           ├── model/po                 # 表实体
│           ├── support                  # 各表共用的增删改查
│           └── config                   # 异常处理
└── tocc-system-maint                    # 系统服务
    ├── tocc-system-maint-api            # 给其他服务远程调用的契约,目前只有服务名
    │   └── constants/ApiConstants.java
    └── tocc-system-maint-biz            # 系统服务启动工程,端口 8525
        └── src/main/java/.../system/maint
            ├── MaintSystemApplication.java
            ├── controller               # 给前端的接口
            └── config                   # 调用基础服务时带上当前用户

代码写在哪

库表接口、库表实现、页面业务分三个地方,不要混在一个工程里。

写什么 放在哪
库表 API tocc-infra-maint-api 的 api 包。25 张表已经各有一套,例如道路是 RoadApi,路径 /rpc-api/maint/road/create。入参和返回对象在同模块的 model/dto。
库表实现 tocc-infra-maint-biz 的 api/impl。RoadApiImpl 实现 RoadApi,通过 mapper 和 model/po 写入达梦。这里只做单表增删改查。
业务内容 tocc-system-maint-biz 的 controller。给前端的页面接口写在这里,需要查库时注入 RoadApi 这类 Feign 接口。不要在系统服务里写 Mapper,也不要在基础服务里写页面流程。

tocc-system-maint-api 不放页面业务,也不放库表接口。它留给以后别的微服务远程调用养护系统服务,目前只有服务名。

前端技术栈

  • React 17、Umi 3.5、Ant Design 4.21、Ant Design Pro(@ant-design/pro-layout、pro-table、pro-form)
  • 页面用 JSX,样式用 Less
  • 请求用 umi-request,统一走 src/utils/request.js,请求头带 satoken
  • 路由写在 config/routes.js,菜单权限用路由上的 access,权限码以 maint: 开头
  • 开发代理写在 config/proxy.js。本地把 /api-maint 转到 http://127.0.0.1:8525,页面里请求 /api-maint/maint/...
src
├── app.jsx                 # 启动时取当前用户和权限
├── access.js               # 按权限码控制菜单
├── assets                  # 图片等静态资源
├── components              # 多个页面共用的组件
├── pages                   # 按业务分子目录,一个页面一个目录
│   └── RoadManage
│       ├── index.jsx       # 页面
│       ├── index.less      # 样式
│       ├── service.js      # 本页接口,只调用系统服务
│       └── components      # 本页弹窗、表单
├── services                # 登录用户、权限等公共接口
└── utils
    └── request.js          # 统一请求
config
├── config.js               # Umi 配置
├── routes.js               # 菜单和路由
├── proxy.js                # 本地代理到系统服务
└── defaultSettings.js      # 布局标题、主题

页面只调系统服务 8525,不直接调基础服务 7424。列表、查询、弹窗写在 pages 里;接口地址集中在该页的 service.js。

环境

  • JDK 8
  • Maven 3.6+
  • 本机达梦,端口 5236。把 tocc-infra-maint-biz 的 application.yml 里数据源口令改成本机达梦口令。

建库:用达梦管理工具执行 sql/sz-maint.sql,执行前先建模式并切过去:

CREATE SCHEMA SZ_MAINT AUTHORIZATION SYSDBA;
SET SCHEMA SZ_MAINT;

脚本是 UTF-8。用 disql 时先转成 GBK 再执行,否则中文注释会把后面的列吃掉。

启动

在本目录执行:

mvn -pl tocc-infra-maint/tocc-infra-maint-biz -am spring-boot:run

另开一个终端:

mvn -pl tocc-system-maint/tocc-system-maint-biz -am spring-boot:run

先起基础服务,再起系统服务。

库表接口

tocc-infra-maint-api 里已经按 25 张表各写了一套接口,路径在 /rpc-api/maint 下面。每张表都有新增、按主键查询、修改、删除、分页。例如道路是 /rpc-api/maint/road/create。

系统服务直接注入对应的 Feign 接口,例如 RoadApi,不要在系统服务里写 Mapper。主键是字符串,新增时不传 id 会自动生成。创建人和修改人取当前请求用户。

基础服务文档 http://127.0.0.1:7424/doc.html 能看到全部表接口。

当前用户用 CurrentUserHolder.get()。本地没有登录,过滤器会填一个固定用户:养护开发 / 师宗公路分局。系统服务调用基础服务时会把这个用户放进请求头。

协作开发约定

协作方按本工程把养护业务做全即可,不必做登录、Token、UAA、角色权限、网关鉴权。本地 Swagger 不要求鉴权是正常现象。权限与统一认证交回后由我方接入。

交付范围

  • 需要交付:页面、系统服务业务接口、基础服务库表能力(含必要的新表/新接口)。
  • 不需要交付:自建登录、权限体系、改公司网关/UAA。

分层(不要混)

写什么 放在哪 禁止
库表 CRUD tocc-infra-maint(api + biz) 不要写页面业务流程
页面业务接口 tocc-system-maint-biz 的 controller 不要写 Mapper、不要直连库
前端页面 前端工程 pages,只调系统服务 8525 不要直接调基础服务 7424

已有 25 张表的 CRUD 可直接注入对应 XxxApi。系统服务调基础服务时用:

xxxApi.xxx(...).getCheckedData()

不要用裸 .getData(),否则基础服务失败会被当成成功。

当前用户

业务里用 CurrentUserHolder.get() 取创建人、机构。本地由 LocalDevAuthFilter 填固定用户(养护开发 / 师宗公路分局)。

  • 不要自己写登录。
  • 不要改 maint-support、LocalDevAuthFilter(交回时该模块会去掉)。

前端约定

  • 技术栈、目录结构见上文「前端技术栈」。
  • 路由权限码预留 maint: 前缀即可,不必接真实权限系统。
  • 请求走 /api-maint/...,由代理转到系统服务。

请不要做的事

  • 不要在系统服务连库。
  • 不要自建权限/登录体系。
  • 不要改父工程依赖版本,不要引入公司内网才能用的包。
  • 不要把复杂业务逻辑写进基础服务的单表 CRUD 层。

交回

交回整个源码目录。公司合并时采用:

  • tocc-infra-maint 和 tocc-system-maint 里新增的接口、实现、Mapper、实体,以及前端业务页面。
  • maint-support、LocalDevAuthFilter 不进入公司工程。公司侧改为网关传入的用户,并接入 UAA 统一权限。
S
Description
No description provided
Readme 1.7 MiB
Languages
Java 100%