{"body":"","images":null,"summary":"","tdk":{"title":"智能输出自动匹配模板系统模板动态列扩展配置","description":"你这句话像是要设计一个功能模块：**智能输出自动匹配模板系统 + 模板动态列扩展配置**。下面按“可落地方案”给你整理一套配置模型与实现思路。\n\n## 1. 核心目标\n\n系统根据业务数据、输出场景、用户条件，自动匹配最合适的输出模板；模板中的列不写死，而是根据数据动态扩展。例如：\n\n- 销售报表中，每个商品动态生成一列；\n- 不同客户等级输出不同字段；\n- 同一模板适配不同渠道、不同数据源；\n- 列名、列顺序、取值路径由配置驱动。\n\n## 2. 配置结构\n\n建议配置分为 5 部分：\n\n```yaml\ntemplateCode: sales_report_001\ntemplateName: 销售明细报表\n\n# 1. 自动匹配规则\nmatchRules:\n businessType: sales\n priority: 100\n conditions:\n - field: order.channel\n operator: in\n value: [online, offline]\n - field: customer.level\n operator: in\n value: [A, B]\n\n# 2. 固定列\ncolumns:\n fixed:\n - key: orderNo\n title: 订单号\n source: order.no\n width: 120\n - key: customerName\n title: 客户名称\n source: customer.name\n width: 160\n\n # 3. 动态列扩展\n dynamic:\n - expandBy: items # 从 items 数组展开\n groupBy: productId # 按 productId 去重生成列\n keyPattern: product_{productId}\n titlePattern: \"{productName}\"\n sourcePattern: items[{productId}].amount\n sortBy: productId\n sortOrder: asc\n defaultValue: 0\n maxColumns: 200\n\n# 4. 输出配置\noutput:\n format: xlsx\n sheetName: 销售明细\n headerRow: 1\n dataStartRow: 2\n fileNamePattern: \"销售明细_{yyyyMMdd}.xlsx\"\n```\n\n## 3. 动态列扩展逻辑\n\n动态列的核心是：**从数据集中提取维度，再把维度变成列**。\n\n以 `items` 为例：\n\n```json\n{\n \"order\": { \"no\": \"SO001\" },\n \"customer\": { \"name\": \"张三\" },\n \"items\": [\n { \"productId\": \"P01\", \"productName\": \"苹果\", \"amount\": 10 },\n { \"productId\": \"P02\", \"productName\": \"香蕉\", \"amount\": 20 }\n ]\n}\n```\n\n根据配置：\n\n- `expandBy: items`：从 `items` 数组展开；\n- `groupBy: productId`：按商品 ID 去重；\n- `titlePattern: \"{productName}\"`：列名取商品名；\n- `sourcePattern: items[{productId}].amount`：每行取对应商品金额。\n\n最终输出：\n\n| 订单号 | 客户名称 | 苹果 | 香蕉 |\n|---|---|---|---|\n| SO001 | 张三 | 10 | 20 |\n\n## 4. 自动匹配流程\n\n```text\n输入上下文\n ↓\n加载所有模板匹配规则\n ↓\n按 businessType、conditions、priority 评分\n ↓\n选择最高分模板\n ↓\n渲染固定列\n ↓\n根据 dynamic 配置生成动态列\n ↓\n合并列并绑定数据\n ↓\n按 output 配置输出 Excel / PDF / JSON / CSV\n```\n\n匹配评分可以简化为：\n\n```text\nscore = priority + 命中条件数 * 10\n```\n\n如果多个模板同分，可以按更新时间、模板版本、业务优先级二次排序。\n\n## 5. 核心伪代码\n\n```python\ndef build_columns(template, context):\n columns = list(template[\"columns\"][\"fixed\"])\n\n for rule in template[\"columns\"].get(\"dynamic\", []):\n items = get_path(context, rule[\"expandBy\"])\n dims = unique_by(items, rule[\"groupBy\"])\n\n if rule.get(\"sortBy\"):\n dims = sorted(dims, key=lambda x: x[rule[\"sortBy\"]])\n\n for dim in dims[: rule.get(\"maxColumns\", 9999)]:\n columns.append({\n \"key\": rule[\"keyPattern\"].format(**dim),\n \"title\": rule[\"titlePattern\"].format(**dim),\n \"source\": rule[\"sourcePattern\"].format(**dim),\n \"defaultValue\": rule.get(\"defaultValue\", \"\")\n })\n\n return columns\n```\n\n## 6. 关键设计要点\n\n1. **列 key 要稳定** \n 建议用业务 ID，如 `product_P01`，不要用中文列名当 key。\n\n2. **动态列顺序要可控** \n 支持 `sortBy + sortOrder`，否则 Excel 列顺序会随数据变化。\n\n3. **空值处理** \n 每个动态列应支持 `defaultValue`，避免导出为空或报错。\n\n4. **列冲突处理** \n 固定列和动态列 key 重复时，配置 `onConflict: skip | override | rename`。\n\n5. **性能限制** \n 动态列可能爆炸，必须设置 `maxColumns`，并缓存维度结果。\n\n6. **权限与可见性** \n 可按角色、客户等级控制动态列是否输出。\n\n7. **多语言标题** \n `titlePattern` 可扩展为 `titleI18n: { zh: \"{productName}\", en: \"{productNameEn}\" }`。\n\n## 7. 可扩展方向\n\n- 规则引擎：支持 AND/OR、表达式、脚本；\n- AI 辅助匹配：根据自然语言描述推荐模板；\n- 可视化配置：前端拖拽固定列、配置动态列规则；\n- 版本管理：模板发布、回滚、灰度；\n- 输出审计：记录匹配了哪个模板、生成了哪些动态列。\n\n如果你需要，我可以继续给你：\n1. 数据库表结构；\n2. 前端动态列配置界面字段；\n3. Java Spring Boot / Python 完整实现；\n4. Excel 导出动态列代码。","keyword":"智能输出自动匹配模板系统模板动态列扩展配置"},"title":"智能输出自动匹配模板系统模板动态列扩展配置"}