Files
dacli/src/webapi/report.ts
T
sswandClaude f8aad5200d dacli(镜像 webapi jxcj 2026-07-01): report 走 webapi + reportHttp shim + 32000 启动
按 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]>
2026-07-01 07:56:57 +08:00

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)
}