feat: initial commit

This commit is contained in:
admin committed 2026-05-18 09:28:15 +08:00
commit 539b115e38
232 files changed
+31223

No files matched your search

+330
View File
@@ -0,0 +1,330 @@
"""可视化开发核心模块
对应前端源码: api/onlineDev/visualDev.ts
包含功能 CRUD、发布、复制、配置获取、代码生成、AI 表单、OCR 等
"""
import json
from typing import Optional
from aibridge.client import JNPFClient
from aibridge.models import APIResponse
class VisualDevAPI:
"""可视化开发 API"""
def __init__(self, client: JNPFClient):
self._client = client
self._prefix = "/api/visualdev/Base"
self._online_prefix = "/api/visualdev/OnlineDev"
self._gen_prefix = "/api/visualdev/Generater"
self._personal_prefix = "/api/visualdev/personal"
self._log_prefix = "/api/visualdev/OnlineLog"
# ==================== 功能 CRUD ====================
def get_list(self, data: dict = None) -> APIResponse:
"""获取功能列表"""
return self._client.request("GET", self._prefix, params=data)
# ==================== 重复检查 ====================
def check_en_code_exists(self, en_code: str) -> bool:
"""检查功能编码是否已存在
Args:
en_code: 功能编码
Returns:
True=已存在,False=不存在
"""
resp = self.get_list({"keyword": en_code, "currentPage": 1, "pageSize": 20})
if resp.code != 200:
return False
for item in resp.data.get("list", []):
if item.get("enCode") == en_code:
return True
return False
def check_name_exists(self, full_name: str) -> bool:
"""检查功能名称是否已存在
Args:
full_name: 功能名称
Returns:
True=已存在,False=不存在
"""
resp = self.get_list({"keyword": full_name, "currentPage": 1, "pageSize": 20})
if resp.code != 200:
return False
for item in resp.data.get("list", []):
if item.get("fullName") == full_name:
return True
return False
def get_id_by_en_code(self, en_code: str) -> Optional[str]:
"""通过编码查询功能 ID
Args:
en_code: 功能编码
Returns:
功能 ID,未找到返回 None
"""
resp = self.get_list({"keyword": en_code, "currentPage": 1, "pageSize": 20})
if resp.code != 200:
return None
for item in resp.data.get("list", []):
if item.get("enCode") == en_code:
return item.get("id")
return None
def get_form_list(self, data: dict = None) -> APIResponse:
"""获取功能列表(集成助手用)"""
return self._client.request("GET", f"{self._prefix}/list", params=data)
def create(self, data: dict) -> APIResponse:
"""新建功能"""
return self._client.request("POST", self._prefix, data=data)
def update(self, data: dict) -> APIResponse:
"""修改功能"""
func_id = data.get("id")
return self._client.request("PUT", f"{self._prefix}/{func_id}", data=data)
def get_info(self, func_id: str) -> APIResponse:
"""获取功能详情"""
return self._client.request("GET", f"{self._prefix}/{func_id}")
def delete(self, func_id: str) -> APIResponse:
"""删除功能"""
return self._client.request("DELETE", f"{self._prefix}/{func_id}")
def soft_delete(self, func_id: str) -> APIResponse:
"""软删除功能 - 修改属性使其不可见且不冲突
由于 JNPF 平台删除后重新创建同名/同编码功能会提示已存在,
此方法通过以下方式软删除:
1. 功能名加上 ID 后缀(避免名称冲突)
2. en_code 改为 func_{id}(避免编码冲突)
3. sortCode 设为极大值(沉底,不影响正常查看)
Args:
func_id: 要删除的功能 ID
Returns:
APIResponse
"""
resp = self.get_info(func_id)
if resp.code != 200:
return resp
data = resp.data.copy()
# 名称加 ID 后缀
original_name = data.get("fullName", "")
if f"({func_id})" not in original_name:
data["fullName"] = f"{original_name}({func_id})"
# en_code 改为 func_{id}
data["enCode"] = f"func_{func_id}"
# 排序码沉底
data["sortCode"] = 999999
return self.update(data)
def copy(self, func_id: str) -> APIResponse:
"""复制功能"""
return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Copy")
def release(self, func_id: str) -> APIResponse:
"""发布功能(复制到 base_visual_release,state 设为 1)"""
return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Release")
def get_release_menu(self, func_id: str) -> APIResponse:
"""获取已发布菜单"""
return self._client.request("GET", f"{self._prefix}/{func_id}/getReleaseMenu")
def create_menu(self, func_id: str, data: dict) -> APIResponse:
"""生成菜单"""
return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Module", data=data)
def get_form_data_fields(self, func_id: str, filter_type: int = 0) -> APIResponse:
"""获取表单主表属性列表"""
return self._client.request("GET", f"{self._prefix}/{func_id}/FormDataFields",
params={"filterType": filter_type})
def get_field_data_select(self, data: dict) -> APIResponse:
"""获取表单主表数据下拉框"""
model_id = data.get("modelId")
return self._client.request("GET", f"{self._prefix}/{model_id}/FieldDataSelect", params=data)
def get_selector(self, data: dict = None) -> APIResponse:
"""获取功能下拉框列表"""
return self._client.request("GET", f"{self._prefix}/Selector", params=data)
def get_column_list(self, data: dict) -> APIResponse:
"""获取列表字段"""
return self._client.request("GET", f"{self._prefix}/getColumnList", params=data)
def get_list_by_system(self, data: dict) -> APIResponse:
"""获取跨应用菜单"""
return self._client.request("GET", f"{self._prefix}/getListBySystem", params=data)
# ==================== OnlineDev 数据操作 ====================
def get_config(self, model_id: str, data: dict = None) -> APIResponse:
"""获取列表表单配置 JSON"""
return self._client.request("GET", f"{self._online_prefix}/{model_id}/Config", params=data)
def get_config_by_menu_id(self, data: dict = None) -> APIResponse:
"""通过菜单 ID 获取列表表单配置 JSON"""
return self._client.request("GET", f"{self._online_prefix}/Config", params=data)
def get_form_data(self, model_id: str) -> APIResponse:
"""获取表单配置 JSON"""
return self._client.request("GET", f"{self._online_prefix}/{model_id}/FormData")
def get_model_list(self, model_id: str, data: dict) -> APIResponse:
"""获取数据列表"""
return self._client.request("POST", f"{self._online_prefix}/{model_id}/List", data=data)
def create_model(self, model_id: str, data: dict, menu_id: str = "") -> APIResponse:
"""新建数据
注意:JNPF API 返回不包含 data 字段,此方法会通过查询列表最近一条数据id,非常微弱几率可能有覆盖情况
自动补充返回的 id 属性。
"""
payload = {"data": json.dumps(data, ensure_ascii=False)}
if menu_id:
payload["menuId"] = menu_id
resp = self._client.request("POST", f"{self._online_prefix}/{model_id}", data=payload)
# JNPF create API 不返回 data/id,通过查询列表补充
if resp.success:
list_resp = self.get_model_list(model_id, {"currentPage": 1, "pageSize": 1})
if list_resp.success and list_resp.data:
records = list_resp.data.get("list", [])
if records:
resp.id = records[0].get("id")
resp.data = {"id": resp.id}
return resp
def update_model(self, model_id: str, data: dict) -> APIResponse:
"""修改数据"""
record_id = data.get("id")
payload = {"id": record_id, "data": json.dumps(data, ensure_ascii=False)}
return self._client.request("PUT", f"{self._online_prefix}/{model_id}/{record_id}", data=payload)
def get_model_info(self, model_id: str, record_id: str, menu_id: str = "") -> APIResponse:
"""获取数据详情"""
return self._client.request("GET", f"{self._online_prefix}/{model_id}/{record_id}",
params={"menuId": menu_id})
def delete_model(self, model_id: str, record_id: str) -> APIResponse:
"""删除数据"""
return self._client.request("DELETE", f"{self._online_prefix}/{model_id}/{record_id}")
def batch_delete_model(self, model_id: str, data: dict) -> APIResponse:
"""批量删除数据"""
return self._client.request("POST", f"{self._online_prefix}/batchDelete/{model_id}", data=data)
def get_data_change(self, model_id: str, data: dict) -> APIResponse:
"""获取数据详情(变更对比)"""
return self._client.request("POST", f"{self._online_prefix}/{model_id}/DataChange", data=data)
def export_model_data(self, model_id: str, data: dict) -> APIResponse:
"""导出数据"""
return self._client.request("POST", f"{self._online_prefix}/{model_id}/Actions/ExportData", data=data)
def get_template(self, model_id: str) -> APIResponse:
"""下载导入模板"""
return self._client.request("GET", f"{self._online_prefix}/{model_id}/Template")
def export_data(self, model_id: str) -> APIResponse:
"""导出模板"""
return self._client.request("POST", f"{self._online_prefix}/{model_id}/Actions/Export")
def launch_flow(self, model_id: str, data: dict) -> APIResponse:
"""自定义按钮发起流程"""
return self._client.request("POST", f"{self._online_prefix}/{model_id}/actionLaunchFlow", data=data)
def get_relation_query(self, data: dict) -> APIResponse:
"""获取关联查询数据列表"""
return self._client.request("POST", f"{self._online_prefix}/RelationQuery", data=data)
def get_data_log_list(self, data: dict) -> APIResponse:
"""获取修改记录列表"""
return self._client.request("GET", self._log_prefix, params=data)
# ==================== 个人视图 ====================
def get_view_list(self, data: dict) -> APIResponse:
"""获取视图列表"""
return self._client.request("GET", self._personal_prefix, params=data)
def create_view(self, data: dict) -> APIResponse:
"""新建视图"""
return self._client.request("POST", self._personal_prefix, data=data)
def update_view(self, data: dict) -> APIResponse:
"""修改视图"""
view_id = data.get("id")
return self._client.request("PUT", f"{self._personal_prefix}/{view_id}", data=data)
def delete_view(self, view_id: str, menu_id: str) -> APIResponse:
"""删除视图"""
return self._client.request("DELETE", f"{self._personal_prefix}/{view_id}?menuId={menu_id}")
def set_default_view(self, view_id: str, menu_id: str) -> APIResponse:
"""设置默认视图"""
return self._client.request("PUT", f"{self._personal_prefix}/{view_id}/setDefault?menuId={menu_id}")
# ==================== 代码生成(基础)====================
def download_code(self, func_id: str, data: dict = None) -> APIResponse:
"""下载代码"""
params = data or {}
return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Actions/DownloadCode", data=params)
def code_preview(self, func_id: str, data: dict = None) -> APIResponse:
"""代码预览"""
params = data or {}
return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Actions/CodePreview", data=params)
def get_alias_info(self, func_id: str) -> APIResponse:
"""获取代码生成命名规范"""
return self._client.request("GET", f"{self._gen_prefix}/{func_id}/Alias/Info")
def save_alias(self, func_id: str, data: dict) -> APIResponse:
"""更新代码生成命名规范"""
return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Alias/Save", data=data)
# ==================== AI / OCR / 跨应用 ====================
def get_ai_info(self, data: dict) -> APIResponse:
"""获取 AI 字段(AI 表单生成)"""
return self._client.request("POST", "/api/visualdev/ai/form", data=data)
def get_ocr_data(self, data: dict) -> APIResponse:
"""OCR 识别"""
return self._client.request("POST", "/api/visualdev/ocr", data=data)
def get_share_list(self) -> APIResponse:
"""获取跨应用表单列表"""
return self._client.request("GET", "/api/visualdev/share")
def get_share_info(self, ids: list) -> APIResponse:
"""获取跨应用表单详情"""
return self._client.request("POST", "/api/visualdev/share/SelectedList", data={"ids": ids})
def save_share(self, data: dict) -> APIResponse:
"""保存跨应用回显"""
return self._client.request("POST", "/api/visualdev/share/save", data=data)
def get_share_selector(self) -> APIResponse:
"""获取功能下拉框列表(包含跨应用表单)"""
return self._client.request("GET", "/api/visualdev/share/Selector")