zhzhy
/
gz-oarms
generated from youfool-project/youfool-prj-springboot3-template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
广州户外广告监管后端
5 Commits 1 Branch 0 Tags 504 KiB
Java 100%
Go to file
chenjy 687eb9a916 feat: CW-4 线索转办模块完善 — 新增6个接口覆盖完整业务闭环 
- 待转办线索列表查询（pending-clues/query）
- 待转办线索详情（pending-clues/detail）
- 转办操作日志查询（operation-logs）
- 转办状态流转：transferred→processing→completed/failed，双表同步线索状态
- 转办催办（urge）
- 转办撤回（withdraw），线索状态回退允许重新转办
- 非法状态流转校验拦截

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 		2026-05-18 16:05:40 +08:00
docs feat: OARMS 全模块后端代码 + DM8 数据库适配 2026-05-18 13:42:29 +08:00
src feat: CW-4 线索转办模块完善 — 新增6个接口覆盖完整业务闭环 2026-05-18 16:05:40 +08:00
.gitignore Initial commit 2026-05-06 16:31:24 +08:00
README.md docs: 更新 README 为 OARMS 项目文档 2026-05-18 15:41:14 +08:00
checkstyle-v1.0.xml Initial commit 2026-05-06 16:31:24 +08:00
findings.md fix: 补齐20个缺失接口 + 运行时问题修复 + 端到端测试通过 2026-05-18 15:30:53 +08:00
pom.xml fix: 补齐20个缺失接口 + 运行时问题修复 + 端到端测试通过 2026-05-18 15:30:53 +08:00
progress.md fix: 补齐20个缺失接口 + 运行时问题修复 + 端到端测试通过 2026-05-18 15:30:53 +08:00
task_plan.md fix: 补齐20个缺失接口 + 运行时问题修复 + 端到端测试通过 2026-05-18 15:30:53 +08:00

README.md

OARMS - 广州市户外广告监管系统后端

广州市户外广告监测监管系统（Outdoor Advertising Regulation & Monitoring System）后端服务，负责广告大屏信息管理、法律法规维护、监测规则配置、录屏取证、线索转办等全链路业务。

技术栈

组件 版本 说明
Spring Boot 3.4.5 基础框架
Java 21 编程语言
DM8 (达梦) 8.1 国产数据库
MyBatis-Plus 3.5.12 ORM 框架
Sa-Token 1.42.0 权限认证
Knife4j 4.4.0 API 文档
Druid 1.2.24 连接池

业务模块

系统按业务域划分为 5 大域、10 个模块：

域 模块 数据表 说明
BS 基础 BS-1 大屏管理 bs_screen, bs_screen_history 户外广告大屏基础信息维护
LB 法律 LB-1 法律法规 lb_law_clause 广告相关法律法规条款管理
MR 监测 MR-1 监测规则 mr_monitoring_rule, mr_rule_law_clause_rel, mr_rule_operation_history 广告内容监测规则配置
AM 监控 AM-1 录屏设置 am_recording_config 大屏录屏参数配置
AM 监控 AM-2 随机录屏 am_recording_task, am_alert_notification 录屏任务调度与告警
AM 监控 AM-3 广告画面监控 am_monitor_record 广告画面抓拍与识别记录
CW 取证 CW-1 固化取证 cw_evidence_record, cw_evidence_status_history 违法广告取证固化
CW 取证 CW-2 规则关联 cw_evidence_rule_relation 取证与监测规则关联
CW 取证 CW-3 线索生成 cw_monitoring_clue, cw_clue_generation_log 违法线索自动/手动生成
CW 取证 CW-4 线索转办 cw_clue_transfer_record, cw_transfer_operation_log 线索转办与处置跟踪

项目结构

gz-oarms/
├── docs/
│   └── db/sql/                          # DDL 建表语句 + 初始数据
├── src/main/java/com/chinaweal/youfool/prj/
│   ├── YoufoolApplication.java          # 启动类
│   ├── common/                          # 常量、工具类
│   ├── config/                          # Spring 配置
│   ├── controller/                      # 登录等通用接口
│   ├── service/                         # 通用服务（用户等）
│   └── modules/
│       ├── screen/                      # BS-1 大屏管理
│       │   ├── controller/
│       │   ├── entity/                  # Entity / Query / Req / VO
│       │   ├── mapper/
│       │   └── service/
│       ├── law/                         # LB-1 法律法规
│       ├── rule/                        # MR-1 监测规则
│       ├── monitor/
│       │   ├── config/                  # AM-1 录屏设置
│       │   ├── task/                    # AM-2 随机录屏
│       │   └── record/                  # AM-3 广告画面监控
│       └── evidence/
│           ├── record/                  # CW-1 固化取证
│           ├── relation/                # CW-2 规则关联
│           ├── clue/                    # CW-3 线索生成
│           └── transfer/                # CW-4 线索转办
├── src/main/resources/
│   ├── application.yml                  # 主配置
│   ├── application-dev.yml              # 开发环境数据源
│   ├── application-prod.yml             # 生产环境数据源
│   └── logback-spring.xml              # 日志配置
└── pom.xml

快速开始

环境要求

  • JDK 21+
  • Maven 3.6+
  • DM8 数据库（已部署，17 张表已初始化）

编译

mvn clean compile

运行

由于 spring-boot-maven-plugin 配置了 ZIP layout 分离依赖，mvn spring-boot:run 无法直接使用。需通过以下方式启动：

# 方式一：打包后运行（生产部署）
mvn clean package -DskipTests
java -jar target/youfool-prj-springboot3-template.jar

# 方式二：本地开发
mvn dependency:build-classpath -Dmdep.outputFile=classpath.txt
java -cp "target/classes;$(cat classpath.txt)" -Dfile.encoding=UTF-8 \
     com.chinaweal.youfool.prj.YoufoolApplication

访问地址

功能 路径 账号 密码
接口文档 /doc.html admin 123456
Druid 监控 /druid admin 123456

数据源配置

项目使用动态数据源（dynamic-datasource），配置两个数据源：

数据源 Schema 用途
master OARMS 业务数据（大屏、法规、规则、取证等）
youfool YOUFOOL 框架日志（restLog）

开发环境配置在 application-dev.yml，生产环境在 application-prod.yml。

事务注解必须使用 @DSTransactional，不能使用 @Transactional。

API 概览

所有接口路径以 /api/ 开头，登录接口在 /user/auth/。

模块 基础路径 核心接口
大屏管理 /api/screen query, detail, save, update, remove, toggle-status, check-code, check-address, export, import, import-template, histories
法律法规 /api/law-clause query, detail, save, update, remove, repeal, check-clause-number, effective
监测规则 /api/monitoring-rules query, detail, save, update, remove, toggle-status, check-name, enabled, scope-types, status-options, export
录屏设置 /api/recording-config query, detail, save, update, remove, toggle-status, configurable-screens
录屏任务 /api/recording-task query, detail, save
广告监控 /api/monitor-record query, detail, save
固化取证 /api/evidence-record query, detail, save, download, play
规则关联 /api/evidence-rule-relation query-by-evidence, relate
线索生成 /api/monitoring-clue query, detail, save, clue-preview, status-summary
线索转办 /api/clue-transfer query, detail, save, targets/districts, targets/departments, targets/persons, disposal-feedback

常用命令

# 编译
mvn clean compile

# 打包（跳过测试）
mvn clean package -DskipTests

# 代码风格检查
mvn checkstyle:check

注意事项

  1. 本项目使用 JDK 21 编译，请确保本地 JDK 版本匹配
  2. 数据库为达梦 DM8，DDL 语法与 MySQL/PostgreSQL 有差异，详见 docs/db/sql/
  3. 动态数据源事务必须使用 @DSTransactional 注解
  4. mvn spring-boot:run 因 ZIP layout 配置无法直接启动，请使用上述替代方式
  5. CW-4 部门/人员数据当前为模拟数据，需对接组织架构系统
  6. CW-1 文件下载/播放路径为占位实现，需对接文件存储系统

许可证

Copyright © chinaweal.com.cn