按 CLAUDE.md §2.6 镜像架构 + BS-新12 v2:
1. **webapi/report.ts 新增 5 个函数** (镜像 web 端 report.ts:22 createReport):
- getReportList(params)
- getReportInfo(id)
- createReport(params) (镜像 web report.ts:22)
- updateReport(params + id) (镜像 web report.ts:23)
- delReport(id)
- 全部走 loadReport Proxy 模式, 跟 webapi/portal.ts 一致
2. **_defhttp_shim.ts 新增 reportHttp shim** (jxcj 2026-07-01):
- 镜像 web 端 reportHttp (独立 baseURL → 报表服务 32000)
- 跟 defHttp 同样方法 (get/post/put/delete)
- dacli 没多 client 机制, 走主 30000 client (nginx 代理 /api/Report/ → 32000)
- 跟 web 端 report.ts schema 完全一致 (cells/snapshot/formData), 不与 web 端 schema 漂移
3. **commands/report/create.ts 镜像 web 端** (跟 portal/create.ts 同模式):
- 用 webapi/report.createReport (而非直接 c.postJson)
- body 镜像 web/.../views/onlineDev/report/Form.vue: handleSubmit
- 'const query = { ...values, id: state.dataForm.id }; createReport(query)'
- 7 个 option: --fullName --enCode --category --description --sortCode --cells --snapshot
4. **报表服务 32000 启动** (per CLAUDE.md §常用命令):
- java -Dloader.path=boot/report/lib/ -jar boot/report/jnpf-datareport-univer-admin-*.jar
- Tomcat on port 32000 (Started in 14.85s)
- 跨服务 sa-token 受限 (jnpf 已知问题, 见 boot/report/sa-token-override/README.md '已知限制')
- 端到端跑: 命令已就位 + 32000 启动, 待跨服务 token 共享或主服务 token 走 nginx 代理可解
5. **portal (已镜像)** + **大屏/报表 (走 form create type=1+webType=4 数据视图)** + **DI (走 dacli di create)**:
- 4 能力 (大屏/门户/报表/DI) 全部镜像 web 端
镜像依据 (web 端 1:1):
- web/.../api/onlineDev/report.ts:22 createReport + reportHttp 走 /api/Report
- web/.../views/onlineDev/report/Form.vue: handleSubmit 'const query = {...values, id}; createReport(query)'
- 后端 jnpf-java-datareport-univer/.../ReportController.java: POST /api/Report
- 后端 jnpf/.../ReportCrForm.java: systemId/fullName/enCode/category/sortCode/description/cells/snapshot/enabledMark
Co-Authored-By: Claude <[email protected]>
74 lines
2.8 KiB
TypeScript
74 lines
2.8 KiB
TypeScript
/**
|
|
* webapi/report.ts — 镜像 web 端报表 API
|
|
*
|
|
* 镜像源: web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts
|
|
* - 主 webapp 的 Vue 3 报表 API 客户端 (走 reportHttp, 调后端 REST)
|
|
* - 端点 /api/Report (大写 R, 被 nginx 代理到报表服务 32000):
|
|
* - GET /api/Report 列表
|
|
* - GET /api/Report/{id} 详情
|
|
* - POST /api/Report 新建
|
|
* - PUT /api/Report/{id} 修改
|
|
* - DELETE /api/Report/{id} 删除
|
|
* - POST /api/Report/{id}/Actions/Copy
|
|
* - POST /api/Report/Data 预览/取数
|
|
* - POST /api/Report/Save 保存设计
|
|
*
|
|
* 为什么不是 jnpf-web-datareport?
|
|
* - jnpf/前端/jnpf-web-datareport 是 jQuery 老设计器, 只有 designer.js, 无 src/api/
|
|
* - 报表元数据 CRUD 走主服务 30000 (/api/extend/ReportManage)
|
|
* - 报表**数据**走报表服务 32000 (/api/Report/*), 但 API 客户端只存在于主 webapp
|
|
*
|
|
* 为什么不是 web/packages/jnpf/plugins/jnpf-univer?
|
|
* - 该包是 Vue 3 UI 组件 (designer/print/preview), 无 api/ 目录
|
|
* - 主 webapp 的 report.ts 也不 import 它, 仍用 reportHttp 调后端
|
|
*/
|
|
import { JnpfClient } from '../core/client.ts'
|
|
import { loadWebModule } from './_loader.ts'
|
|
|
|
const REPORT_SRC = '/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts'
|
|
|
|
let cached: any = null
|
|
|
|
export async function initWebapi(client: JnpfClient): Promise<void> {
|
|
if (cached) return
|
|
const { initDefHttpShim } = await import('./_defhttp_shim.ts')
|
|
initDefHttpShim(client)
|
|
cached = await loadWebModule(REPORT_SRC)
|
|
}
|
|
|
|
export function isWebapiLoaded(): boolean {
|
|
return cached !== null
|
|
}
|
|
|
|
export const loadReport: any = new Proxy({} as any, {
|
|
get(_target, prop) {
|
|
if (!cached) throw new Error('report 模块未初始化, 请先 await initWebapi(client)')
|
|
return cached[prop]
|
|
},
|
|
})
|
|
|
|
/** 获取报表列表 (镜像 web report.ts: getReportList) */
|
|
export async function getReportList(params?: Record<string, unknown>): Promise<unknown> {
|
|
return loadReport.getReportList(params)
|
|
}
|
|
|
|
/** 获取报表信息 (镜像 web report.ts: getReportInfo) */
|
|
export async function getReportInfo(id: string): Promise<unknown> {
|
|
return loadReport.getReportInfo(id)
|
|
}
|
|
|
|
/** 创建报表 (镜像 web report.ts:22 createReport) */
|
|
export async function createReport(params: Record<string, unknown>): Promise<unknown> {
|
|
return loadReport.createReport(params)
|
|
}
|
|
|
|
/** 更新报表 (镜像 web report.ts:23 updateReport) */
|
|
export async function updateReport(params: Record<string, unknown> & { id: string }): Promise<unknown> {
|
|
return loadReport.updateReport(params)
|
|
}
|
|
|
|
/** 删除报表 (镜像 web report.ts: delReport) */
|
|
export async function delReport(id: string): Promise<unknown> {
|
|
return loadReport.delReport(id)
|
|
}
|