Files
dacli/doc/v0.8-scan.md
T

19 KiB
Raw Blame History

v0.8 扫描快照 (2026-06-12)

用途: v0.8 启动前的情报快照,记录 web 端 25+ 顶级模块入口、基线样例、后端 Controller、API 端点 4 类数据.下次会话从本文档恢复,直接进入开发,不再重复扫描. 生成方式: 1) find web/views -maxdepth 3 -name "index.vue"; 2) dacli form list × 2 应用; 3) find jnpf/后端 -name "*Controller.java"; 4) dacli apis list --keyword X.


1. web 端模块清单 (94 个 index.vue 入口,3 级深度)

路径前缀: /home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/views/

1.1 已整合到 dacli TS 版 (8 父命令) ✓

模块路径 对应 dacli 命令 入口数
onlineDev/formDesign + onlineDev/sysForm dacli form 2
dataCenter/dataModel dacli dm 1
sysData/dictionary dacli dict 1
permission/menu dacli menu 1
dataCenter/dataInterface dacli di 1
workFlow/* + onlineDev/flowEngine dacli workflow 11

1.2 v0.8 P0 必整合 (6 大父命令, 24 入口)

模块路径 计划命令 入口数 状态
dataCenter/dataSource dacli datasource 1 待整合
onlineDev/report + onlineDev/dataReport + common/dynamicReport + common/dynamicDataReport dacli report 4 待整合
onlineDev/visualPortal + common/dynamicPortal dacli portal 2 待整合
extend/bigData dacli bigscreen 1 待整合
onlineDev/printDev + teamwork/printTemplate dacli print 2 待整合
appCenter + appConfig/* dacli app 6 待整合

1.3 v0.8 P1 应整合 (6 大父命令, 22 入口)

模块路径 计划命令 入口数
permission/role + permission/authGroup + permission/auth + permission/identity dacli role 4
permission/user dacli user 1
permission/organize + permission/resource + permission/action dacli org 3
msgCenter/notice + msgCenter/msgTemplate + msgCenter/sendConfig dacli msg 3
teamwork/schedule + sysService/task dacli schedule 2
teamwork/document dacli doc-library (避免与 doc 命令冲突) 1

1.4 v0.8 P2 可整合 (6 大父命令, 31 入口)

模块路径 计划命令 入口数
monitor/flowMonitor + monitor/msgMonitor + monitor/platformMonitor + monitor/userOnline dacli monitor 4
sysLog/loginLog + sysLog/operateLog + sysLog/errorLog + sysLog/requestLog dacli log 4
integrationCenter/email + sms + weChatMp + weCom + dingTalk + webhook + aiModelConfig dacli integration 7
extend/importAndExport dacli import + dacli export 1
sysData/area dacli area 1
dataCenter/interfaceOauth dacli di-auth (di 子命令) 1

1.5 v0.8 P3 长尾 (13 大父命令, ~25 入口)

模块路径 计划命令
commonCenter/{commonVariable,sysFunction,sysVariable} dacli var
sysConfig/{parameter,strategy} dacli config
sysData/{icons,language} 暂不整合 (资源类)
extend/{barCode,documentPreview,email,map,signature,signet,order,saleOrder,projectGantt} 暂不整合 (业务扩展示例)
templateCenter/{billRule,commonWords,kit,signature} dacli template
sysService/cache dacli cache
_core/{home,join,messageRecord,profile} 暂不整合 (框架)
common/{externalLink,formShortLink} 暂不整合 (Web 入口辅助)

1.6 v0.8 总计 (31 大父命令, 104 入口)

实际 v0.8 父命令数 (排除 P3 暂不整合) = 22 个 (已 8 + P0 6 + P1 6 + P2 5 = 25, 减去 doc-library/di-auth/var/config 等子命令化约 3)


2. baseline 样例清单 (114 张 form + 其他模块样例)

2.1 developSystem (29 张)

  • dacli form list 已验证全部 29 张 schema 完整
  • 典型样例: dacli_ts_smoke / task_v7v / test_parent_a97ba7 (主子表)
  • URL: http://nginx/jnpf_app_developSystem/

2.2 workSystem (85 张)

  • dacli form list 验证 85 张 schema 完整
  • 套打样例: tdsl (id=585384793399624261) - 列表标签 "套打示例"
  • 打印模板样例: zdydy (id=469136940843723909) - "表单自定义按钮及多打印模板示例"
  • 视图样例: stsl / stcx / kjdysjjk (控件调用数据接口)
  • 工作流样例: leaveApply / salesOrder / testpurchaseform / testprojects / testsubpackage / testpurchase / testposition
  • URL: http://nginx/jnpf_app_workSystem/

2.3 其他模块样例 (走 swagger 端点查, 待 v0.8 验证)

  • 报表样例: dacli report list (待 W8)
  • 门户样例: dacli portal list (待 W8)
  • 大屏样例: dacli bigscreen list (待 W9)
  • 打印模板样例: dacli print list (待 W9)
  • 角色/用户/组织: 走业务库, 真实数据
  • 消息/通知: 走系统库, 真实数据

3. 后端 Controller 清单 (100+ 类, 关键模块)

3.1 P0 模块

模块 Controller 类 端点 prefix
报表 (datareport-univer) ReportController + ReportDataController /api/extend/ReportManage + /api/extend/ReportTemplate
报表 (ureport) DataReportController /api/ureport/preview
门户 PortalController + PortalDataController + DashboardController /api/visualdev/Portal
大屏 BigDataController /api/extend/BigData
打印 PrintDevController /api/system/printDev
数据源 DbLinkController /api/system/DataSource
应用 AppDataController + AppMenuController + AppUserController + AppVersionController /api/system/System

3.2 P1 模块

模块 Controller 类 端点 prefix
角色 RoleController + RoleRelationController /api/permission/Role + /api/permission/RoleRelation
用户 UserController + UserRelationController + UserSettingController /api/permission/Users
组织 OrganizeController + PositionController /api/permission/Organize + /api/permission/Position
消息模板 MessageTemplateController + MessageTemplateConfigController /api/system/MessageTemplate + /api/message/MessageTemplateConfig
通知公告 MessageController /api/message/Notice
发送配置 SendMessageConfigController + AccountConfigController /api/message/SendMessageConfig
调度任务 TimeTaskController + ScheduleNewController /api/scheduletask + /api/system/Schedule
xxl-job JobInfoController + JobLogController + JobCodeController + JobGroupController + JobUserController + JobApiController /xxl-job-admin

3.3 P2 模块

模块 Controller 类 端点 prefix
监控 MonitorController + WorkflowMonitorController + MessageMonitorController /api/system/Monitor + /api/workflow/monitor + /api/message/MessageMonitor
日志 LogController + (登录/操作/异常/请求在 LoginLogController + OperateLogController + ErrorLogController + RequestLogController 内) /api/system/log
短信 SmsTemplateController /api/system/SmsTemplate
微信 WxGZHFunctionController + WeChatEnterpriseFunctionController /api/message/WxGZH + /api/message/WeChatEnterprise
钉钉 DingTalkController /api/integration/dingTalk
Webhook WebhookController /api/integration/webhook
导入 分散在每个 Controller 的 Actions/Import 详见 §4
行政区划 AreaController /api/system/Area

3.4 后端模块 (Maven 多模块)

jnpf/后端/
├── jnpf-java-boot/                  # 主 Spring Boot
│   ├── jnpf-admin                   # admin 入口
│   ├── jnpf-app                     # app 管理
│   ├── jnpf-extend                  # 扩展 (ReportTemplate/BigData/Email/LeaveApply/Order/SalesOrder)
│   ├── jnpf-file                    # 文件
│   ├── jnpf-flowable                # 工作流
│   ├── jnpf-message                 # 消息中心
│   ├── jnpf-oauth                   # 鉴权
│   ├── jnpf-permission              # 权限
│   ├── jnpf-scheduletask            # 调度
│   ├── jnpf-system                  # 系统 (Module/Dict/Area/PrintDev/Monitor)
│   ├── jnpf-visualdata              # 可视化数据
│   └── jnpf-visualdev               # 可视化开发 (form/portal)
├── jnpf-java-datareport-univer/     # 报表 (新)
├── jnpf-datareport/                 # 报表 (旧 ureport)
├── jnpf-scheduletask/               # xxl-job
├── jnpf-file-preview/               # 文件预览 (kkFileView)
└── jnpf-common/                     # 公共

4. API 端点清单 (关键模块, 端点级别)

用 dacli apis list --keyword X 拉的, 实际端点数远多于下表, 仅列代表性端点.

4.1 数据源 (8 端点)

GET     /api/system/DataSource
POST    /api/system/DataSource
GET     /api/system/DataSource/{id}
PUT     /api/system/DataSource/{id}
DELETE  /api/system/DataSource/{id}
POST    /api/system/DataSource/Actions/Test    # 测试连接
GET     /api/system/DataSource/getGroup        # 分组
GET     /api/system/DataSource/Selector        # 下拉选择

4.2 报表 (9 端点)

GET     /api/extend/ReportManage               # 报表列表
POST    /api/extend/ReportManage               # 新建
GET     /api/extend/ReportTemplate/Month       # 月报
GET     /api/extend/ReportTemplate/Quarter     # 季报
GET     /api/extend/ReportTemplate/Purchase    # 采购报表
GET     /api/extend/ReportTemplate/GroupList
GET     /api/extend/ReportTemplate/Combination
POST    /api/system/Menu/saveReportMenu        # 报表菜单
POST    /api/system/Menu/getReportMenu

4.3 门户 (16 端点)

GET     /api/visualdev/Portal
POST    /api/visualdev/Portal
GET     /api/visualdev/Portal/{id}
PUT     /api/visualdev/Portal/{id}
DELETE  /api/visualdev/Portal/{id}
PUT     /api/visualdev/Portal/{id}/Actions/SetDefault
PUT     /api/visualdev/Portal/Custom/Save/{menuId}
PUT     /api/visualdev/Portal/Actions/release/{portalId}
POST    /api/visualdev/Portal/{modelId}/Actions/Export
POST    /api/visualdev/Portal/{id}/Actions/Copy
POST    /api/visualdev/Portal/Actions/Import
GET     /api/visualdev/Portal/{id}/auth
GET     /api/visualdev/Portal/systemFilter/{id}
GET     /api/visualdev/Portal/Selector
GET     /api/visualdev/Portal/Selector/Menu

4.4 打印 (19 端点)

GET     /api/system/printDev
POST    /api/system/printDev
GET     /api/system/printDev/{id}
PUT     /api/system/printDev/{id}
DELETE  /api/system/printDev/{id}
POST    /api/system/printDev/{id}/Actions/Copy
POST    /api/system/printDev/Save
POST    /api/system/printDev/getListOptions
POST    /api/system/printDev/getListById
GET     /api/system/printDev/Info/{versionId}
POST    /api/system/printDev/Info/{versionId}
DELETE  /api/system/printDev/Info/{versionId}
POST    /api/system/printDev/BatchData
POST    /api/system/printDev/Actions/Import
GET     /api/system/printDev/{id}/Actions/Preview
GET     /api/system/printDev/{id}/Actions/Export
GET     /api/system/printDev/WorkSelector

4.5 调度 (15 端点)

GET     /api/scheduletask                       # 任务调度列表
POST    /api/scheduletask                       # 新建
GET     /api/scheduletask/{id}
PUT     /api/scheduletask/{id}
DELETE  /api/scheduletask/{id}
POST    /api/scheduletask/white/trigger         # 触发
GET     /api/scheduletask/{id}/TaskLog          # 任务日志
GET     /api/scheduletask/TaskMethods           # 任务方法
GET     /api/scheduletask/Info/{id}             # 详情
GET     /api/system/Schedule                    # 日程
POST    /api/system/Schedule
GET     /api/system/Schedule/{id}
PUT     /api/system/Schedule/{id}/{type}
DELETE  /api/system/Schedule/{id}/{type}
GET     /api/system/Schedule/detail
GET     /api/system/Schedule/AppList

4.6 角色 (19 端点)

GET     /api/permission/Role
POST    /api/permission/Role
GET     /api/permission/Role/{id}
PUT     /api/permission/Role/{id}
DELETE  /api/permission/Role/{id}
GET     /api/permission/Role/Selector
GET     /api/permission/Role/TemplateDownload
POST    /api/permission/Role/Uploader
POST    /api/permission/Role/RoleCondition
POST    /api/permission/Role/ImportData
POST    /api/permission/Role/ExportExceptionData
GET     /api/permission/RoleRelation
POST    /api/permission/RoleRelation
POST    /api/permission/RoleRelation/delete
POST    /api/permission/RoleRelation/deleteRoles
POST    /api/permission/RoleRelation/addRoles
GET     /api/permission/RoleRelation/roleList

4.7 用户 (89 端点, 仅列核心)

GET     /api/permission/Users
POST    /api/permission/Users
GET     /api/permission/Users/{id}
PUT     /api/permission/Users/{id}
DELETE  /api/permission/Users/{id}
PUT     /api/permission/Users/{id}/Actions/unlock
PUT     /api/permission/Users/{id}/Actions/State
PUT     /api/permission/Users/Tenant/UpdateAdminInfo
PUT     /api/permission/Users/Tenant/ResetPassword
GET     /api/permission/Users/Current/BaseInfo
PUT     /api/permission/Users/Current/BaseInfo
PUT     /api/permission/Users/Current/Avatar/{name}

4.8 组织 + 岗位 (46 端点)

GET     /api/permission/Organize
POST    /api/permission/Organize
GET     /api/permission/Organize/{id}
PUT     /api/permission/Organize/{id}
DELETE  /api/permission/Organize/{id}
GET     /api/permission/Organize/Selector
POST    /api/permission/Organize/SelectedList
POST    /api/permission/Organize/OrganizeCondition
GET     /api/permission/Position
POST    /api/permission/Position
GET     /api/permission/Position/{id}
PUT     /api/permission/Position/{id}
DELETE  /api/permission/Position/{id}
GET     /api/permission/Position/getList/{organizeId}
POST    /api/permission/Position/getListByOrgIds
POST    /api/permission/Position/SelectedList

4.9 消息 + 通知 (70+ 端点)

# 消息模板
GET     /api/system/MessageTemplate
POST    /api/system/MessageTemplate
GET     /api/system/MessageTemplate/{id}
PUT    /api/system/MessageTemplate/{id}
DELETE /api/system/MessageTemplate/{id}
PUT    /api/system/MessageTemplate/{id}/Actions/State

# 通知公告
GET     /api/message/Notice
POST    /api/message/Notice
GET     /api/message/Notice/{id}
PUT     /api/message/Notice/{id}
DELETE  /api/message/Notice/{id}
PUT     /api/message/Notice/{id}/Actions/Release
GET     /api/message/Notice/List
POST    /api/visualdev/Dashboard/Notice

# 发送配置
GET     /api/message/SendMessageConfig
POST    /api/message/SendMessageConfig
GET     /api/message/SendMessageConfig/{id}
PUT     /api/message/SendMessageConfig/{id}
DELETE  /api/message/SendMessageConfig/{id}
POST    /api/message/SendMessageConfig/{id}/Actions/Copy
POST    /api/message/SendMessageConfig/testSendConfig
POST    /api/message/SendMessageConfig/getTestConfig/{id}

4.10 监控 (17 端点)

GET     /api/system/Monitor                      # 平台监控
GET     /api/workflow/monitor                    # 流程监控
GET     /api/workflow/monitor/FlowTodo
POST    /api/workflow/monitor/FlowTodoCount
POST    /api/workflow/monitor/Pause/{id}
POST    /api/workflow/monitor/Activate/{id}
POST    /api/workflow/monitor/Cancel/{id}
POST    /api/workflow/monitor/Assign/{id}
POST    /api/workflow/monitor/Reboot/{id}
GET     /api/workflow/monitor/AnySubFlow/{id}
GET     /api/message/MessageMonitor              # 消息监控
POST    /api/message/MessageMonitor
GET     /api/message/MessageMonitor/{id}
GET     /api/message/MessageMonitor/detail/{id}
DELETE  /api/message/MessageMonitor/empty
DELETE  /api/message/MessageMonitor/batchRemove

4.11 行政区划 (9 端点)

POST    /api/system/Area
GET     /api/system/Area/{nodeId}
PUT     /api/system/Area/{id}
DELETE  /api/system/Area/{id}
PUT     /api/system/Area/{id}/Actions/State
POST    /api/system/Area/GetAreaByIds
GET     /api/system/Area/{id}/Selector/{ids}
GET     /api/system/Area/{id}/Info

4.12 应用管理 (29 端点, 仅列核心)

GET     /api/app/Data                            # app 常用数据
POST    /api/app/Data
POST    /api/visualdev/Generater/App/Preview    # 代码生成预览
GET     /api/visualdev/Generater/App/{id}/Preview
POST    /api/system/System/saveAppAuthorization
POST    /api/system/System/changeAppAuthorization
GET     /api/system/System/getAppAuthorization/{systemId}
POST    /api/system/System/Actions/Import        # 导入 app

5. dacli 8 父命令现状 (v0.7.1 末, 27 子命令)

dacli form       (10 子): list/info/create/release/delete/export/import/clone/validate/fix-columndata
dacli dm         (4 子) : list/create/drop/fields
dacli dict       (2 子) : type-list/data-list
dacli menu       (4 子) : list/create/delete/unrelease
dacli di         (1 子) : list
dacli workflow   (3 子) : list/launch/approve
dacli doc        (1 子) : list
dacli apis       (1 子) : list
+ login/status/switch-app (顶层 3)

6. 已知边界 (v0.8 启动必看)

6.1 已完工

  • ✅ 8 父命令 / 27 子命令
  • ✅ 114 张 baseline (developSystem 29 + workSystem 85) schema 完整
  • ✅ Web 端 60+ jnpfKey 控件 / 14 L1 正则 / 39 控件 schema 已提取
  • ✅ Playwright + 浏览器会话管理 + 视觉对比
  • ✅ Help 系统 (--ai-help / --example / --source) 全命令支持
  • ✅ blindspot 23 闭环 (Actions/Module NPE root cause + fix)

6.2 已知遗留 (留 v0.8 末期, 优先级低)

  • P0 #16 收尾 (tds_leave 跑 fix-columndata + 写剩余 spec) — 用户手动, AI 不动
  • P1 examples/baseline/all.sh 一键 72 张 — 留 W8 边整合边写
  • P2 dacli/ git 持久化 — 用户决策

6.3 风险

  • 报表/门户端点复杂度高 (PortalController 16 端点 + PortalDataController) → 拆子命令谨慎
  • 调度任务对接 xxl-job, 鉴权与原 JNPF 不同 → 走 /api/scheduletask 主端点, 不碰 /xxl-job-admin/*
  • 集成中心 (email/sms/weChat) 走第三方 OAuth, 沙箱测难 → W11 末做实跑

7. 缓存路径 (下次会话恢复直接用)

  • 本文档: $ccWorkDir/dacli/doc/v0.8-scan.md
  • web 模块入口: /tmp/jnpf-web-views.txt (94 个 index.vue)
  • 后端 Controllers: find /home/ubuntu/ccWorkDir/jnpf/后端 -name "*Controller.java" (100+ 类)
  • API 端点缓存: ~/.dacli/cache.db SQLite (12h TTL, PID 变化失效)
  • 开发 token: /home/ubuntu/ccWorkDir/dacli/.dacli-token/token.json (admin@tds, 7 天 TTL)
  • Playwright storage: /home/ubuntu/ccWorkDir/dacli/.auth/admin.json (6h TTL)

生成时间: 2026-06-12 作者: Claude (M3) + 用户 下一阶段: 写 doc/v0.8-plan.md (从本文档 §1 + prompt.md §3.5 抄), 然后开始 W7 (情报 → 脚手架)