19 KiB
19 KiB
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.dbSQLite (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 (情报 → 脚手架)