feat: restore source parity and harden agent runtime

This commit is contained in:
2026-06-22 11:17:26 +08:00
parent e33f08277b
commit 0793eb82d6
596 changed files with 168879 additions and 290 deletions
@@ -0,0 +1,267 @@
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
文档生成Schema定义
"""
from datetime import datetime
from typing import Optional, List, Dict, Any
from pydantic import BaseModel, ConfigDict, Field
# ==================== 文档模板 ====================
class PageMargin(BaseModel):
"""页边距配置"""
top: int = 20
right: int = 20
bottom: int = 20
left: int = 20
class SealPosition(BaseModel):
"""签章位置配置"""
seal_type: str = Field(..., description="签章类型: company/department/personal/signature")
position_type: str = Field(default="fixed", description="定位方式: fixed/relative")
x: int = Field(default=0, description="X坐标(mm)")
y: int = Field(default=0, description="Y坐标(mm)")
page: int = Field(default=-1, description="页码(-1表示最后一页)")
width: int = Field(default=40, description="宽度(mm)")
height: int = Field(default=40, description="高度(mm)")
field_name: Optional[str] = Field(default=None, description="关联字段名(用于手写签名)")
class CalculationField(BaseModel):
"""计算字段配置"""
name: str = Field(..., description="字段名")
label: str = Field(default="", description="字段标签")
formula: str = Field(..., description="计算公式,如: quantity * unit_price")
format: str = Field(default="number", description="格式化类型: number/money/percent/chinese")
decimal_places: int = Field(default=2, description="小数位数")
class AggregationField(BaseModel):
"""聚合字段配置"""
name: str = Field(..., description="字段名")
label: str = Field(default="", description="字段标签")
source: str = Field(..., description="数据源(子表名)")
field: str = Field(..., description="聚合字段")
function: str = Field(default="sum", description="聚合函数: sum/avg/max/min/count")
format: str = Field(default="number", description="格式化类型: number/money/percent/chinese")
decimal_places: int = Field(default=2, description="小数位数")
class CalculationRules(BaseModel):
"""计算规则配置"""
fields: List[CalculationField] = Field(default_factory=list, description="计算字段列表")
aggregations: List[AggregationField] = Field(default_factory=list, description="聚合字段列表")
class DocumentTemplateBase(BaseModel):
"""文档模板基础Schema"""
name: str = Field(..., min_length=1, max_length=100, description="模板名称")
code: str = Field(..., min_length=1, max_length=100, pattern=r"^[a-zA-Z][a-zA-Z0-9_]*$", description="模板编码(字母开头,只能包含字母、数字和下划线)")
category: str = Field(default="other", description="分类")
description: Optional[str] = Field(default="", description="描述")
form_code: Optional[str] = Field(default=None, description="关联表单编码")
workflow_code: Optional[str] = Field(default=None, description="关联流程编码")
template_type: str = Field(default="designer", description="模板类型: designer/html")
template_content: Optional[str] = Field(default=None, description="模板内容")
template_css: Optional[str] = Field(default=None, description="自定义CSS")
page_size: str = Field(default="A4", description="页面大小")
page_orientation: str = Field(default="portrait", description="页面方向")
page_margin: Optional[PageMargin] = Field(default_factory=PageMargin, description="页边距")
watermark_enabled: bool = Field(default=False, description="是否启用水印")
watermark_text: Optional[str] = Field(default=None, description="水印文字")
watermark_type: str = Field(default="text", description="水印类型")
watermark_image_id: Optional[str] = Field(default=None, description="水印图片ID")
watermark_opacity: int = Field(default=30, ge=0, le=100, description="水印透明度")
watermark_angle: int = Field(default=-45, description="水印角度")
seal_enabled: bool = Field(default=False, description="是否启用签章")
seal_positions: Optional[List[SealPosition]] = Field(default=None, description="签章位置配置")
header_enabled: bool = Field(default=False, description="是否启用页眉")
header_template: Optional[str] = Field(default=None, description="页眉模板")
footer_enabled: bool = Field(default=False, description="是否启用页脚")
footer_template: Optional[str] = Field(default=None, description="页脚模板")
show_page_number: bool = Field(default=True, description="是否显示页码")
calculation_rules: Optional[CalculationRules] = Field(default=None, description="计算规则配置")
class DocumentTemplateCreate(DocumentTemplateBase):
"""创建文档模板"""
application_id: Optional[str] = Field(default=None, description="所属应用ID")
class DocumentTemplateUpdate(BaseModel):
"""更新文档模板"""
name: Optional[str] = Field(default=None, max_length=100, description="模板名称")
category: Optional[str] = Field(default=None, description="分类")
description: Optional[str] = Field(default=None, description="描述")
form_code: Optional[str] = Field(default=None, description="关联表单编码")
workflow_code: Optional[str] = Field(default=None, description="关联流程编码")
template_type: Optional[str] = Field(default=None, description="模板类型")
template_content: Optional[str] = Field(default=None, description="模板内容")
template_css: Optional[str] = Field(default=None, description="自定义CSS")
page_size: Optional[str] = Field(default=None, description="页面大小")
page_orientation: Optional[str] = Field(default=None, description="页面方向")
page_margin: Optional[PageMargin] = Field(default=None, description="页边距")
watermark_enabled: Optional[bool] = Field(default=None, description="是否启用水印")
watermark_text: Optional[str] = Field(default=None, description="水印文字")
watermark_type: Optional[str] = Field(default=None, description="水印类型")
watermark_image_id: Optional[str] = Field(default=None, description="水印图片ID")
watermark_opacity: Optional[int] = Field(default=None, description="水印透明度")
watermark_angle: Optional[int] = Field(default=None, description="水印角度")
seal_enabled: Optional[bool] = Field(default=None, description="是否启用签章")
seal_positions: Optional[List[SealPosition]] = Field(default=None, description="签章位置配置")
header_enabled: Optional[bool] = Field(default=None, description="是否启用页眉")
header_template: Optional[str] = Field(default=None, description="页眉模板")
footer_enabled: Optional[bool] = Field(default=None, description="是否启用页脚")
footer_template: Optional[str] = Field(default=None, description="页脚模板")
show_page_number: Optional[bool] = Field(default=None, description="是否显示页码")
calculation_rules: Optional[CalculationRules] = Field(default=None, description="计算规则配置")
status: Optional[str] = Field(default=None, description="状态")
class DocumentTemplateOut(DocumentTemplateBase):
"""文档模板输出"""
id: str
application_id: Optional[str] = None
calculation_rules: Optional[Dict[str, Any]] = None
status: str = "draft"
is_builtin: bool = False
version: int = 1
sys_create_datetime: Optional[datetime] = None
sys_update_datetime: Optional[datetime] = None
model_config = ConfigDict(from_attributes=True)
class DocumentTemplateListOut(BaseModel):
"""文档模板列表输出"""
id: str
name: str
code: str
category: str
description: Optional[str] = None
form_code: Optional[str] = None
workflow_code: Optional[str] = None
status: str = "draft"
is_builtin: bool = False
version: int = 1
sys_create_datetime: Optional[datetime] = None
model_config = ConfigDict(from_attributes=True)
# ==================== 导入导出 ====================
class DocumentTemplateImportCheckIn(BaseModel):
"""单据模板导入预检查"""
code: str = Field(..., description="模板编码")
class DocumentTemplateImportCheckOut(BaseModel):
"""单据模板导入预检查结果"""
code_exists: bool = Field(..., description="模板编码是否已存在")
can_import: bool = Field(..., description="是否可以直接导入")
class DocumentTemplateImportIn(DocumentTemplateBase):
"""单据模板配置导入"""
application_id: Optional[str] = Field(None, description="所属应用ID")
# ==================== 生成的文档 ====================
class GeneratedDocumentOut(BaseModel):
"""生成的文档输出"""
id: str
template_id: str
template_code: Optional[str] = None
template_name: Optional[str] = None
form_code: Optional[str] = None
form_data_id: Optional[str] = None
workflow_code: Optional[str] = None
instance_id: Optional[str] = None
document_name: str
document_no: Optional[str] = None
file_id: str
file_size: int = 0
page_count: int = 1
generate_type: str = "manual"
generator_id: Optional[str] = None
generator_name: Optional[str] = None
status: str = "generated"
download_count: int = 0
sealed: bool = False
seal_info: Optional[Dict[str, Any]] = None
sys_create_datetime: Optional[datetime] = None
model_config = ConfigDict(from_attributes=True)
class GenerateDocumentIn(BaseModel):
"""生成文档请求"""
template_id: str = Field(..., description="模板ID")
form_data_id: Optional[str] = Field(default=None, description="表单数据ID")
instance_id: Optional[str] = Field(default=None, description="流程实例ID")
document_name: Optional[str] = Field(default=None, description="文档名称(可选)")
seal_ids: Optional[List[str]] = Field(default=None, description="要使用的签章ID列表")
signature_file_ids: Optional[Dict[str, str]] = Field(default=None, description="手写签名文件ID映射")
class BatchGenerateDocumentIn(BaseModel):
"""批量生成文档请求"""
template_id: str = Field(..., description="模板ID")
form_data_ids: List[str] = Field(..., description="表单数据ID列表")
# ==================== 预览 ====================
class PreviewDocumentIn(BaseModel):
"""预览文档请求"""
template_id: Optional[str] = Field(default=None, description="模板ID(与template_content二选一)")
template_content: Optional[str] = Field(default=None, description="模板内容JSON(与template_id二选一)")
calculation_rules: Optional[Dict[str, Any]] = Field(default=None, description="计算规则配置(用于未保存的模板预览)")
form_data_id: Optional[str] = Field(default=None, description="表单数据ID")
instance_id: Optional[str] = Field(default=None, description="流程实例ID")
test_data: Optional[Dict[str, Any]] = Field(default=None, description="测试数据(优先使用)")
# ==================== 通用响应 ====================
class TemplateCategory(BaseModel):
"""模板分类"""
value: str
label: str
count: int = 0
class DocumentStats(BaseModel):
"""文档统计"""
total_templates: int = 0
published_templates: int = 0
total_documents: int = 0
today_documents: int = 0