# 示例目录与功能对照表 > 基于 `views/extend` 和 `jnpf-extend` 模块的完整示例索引 > 整理时间:2026-04-01 --- ## 一、前端扩展示例 ### 1.1 表格示例 (tableDemo) | 示例 | 路径 | 功能说明 | |------|------|----------| | 普通表格 | `tableDemo/commonTable` | 基础 CRUD 操作 | | 树形表格 | `tableDemo/treeTable` | 树形数据展示 | | 复杂表头 | `tableDemo/complexHeader` | 多层表头合并 | | 合并单元格 | `tableDemo/mergeTable` | 行列合并 | | 分组表格 | `tableDemo/groupingTable` | 数据分组 | | 锁定表格 | `tableDemo/lockTable` | 列冻结 | | 编辑表格 | `tableDemo/redactTable` | 行内编辑 | | 签字表格 | `tableDemo/signTable` | 手写签字 | | 批注表格 | `tableDemo/postilTable` | 单元格批注 | | 扩展表格 | `tableDemo/extension` | 行政区划联动 | | 统计表格 | `tableDemo/statisticsTable` | 数据统计 | **后端对应**:`TableExampleController` (`/api/extend/TableExample`) ### 1.2 图表示例 (graphDemo) | 示例 | 路径 | 图表类型 | |------|------|----------| | 柱状图 | `graphDemo/echartsBar` | Bar | | 折线图 | `graphDemo/echartsLine` | Line | | 饼图 | `graphDemo/echartsPie` | Pie | | 仪表盘 | `graphDemo/echartsGauge` | Gauge | | 散点图 | `graphDemo/echartsScatter` | Scatter | | 树图 | `graphDemo/echartsTree` | Tree | | 漏斗图 | `graphDemo/echartsFunnel` | Funnel | | K线图 | `graphDemo/echartsCandlestick` | Candlestick | | 柱状折线混合 | `graphDemo/echartsLineBar` | Line+Bar | | 面积图 | `graphDemo/echartsLineArea` | Line Area | ### 1.3 表单示例 (formDemo) | 示例 | 路径 | 控件类型 | |------|------|----------| | fieldForm1 | `formDemo/fieldForm1` | 文本、数值、日期 | | fieldForm2 | `formDemo/fieldForm2` | 下拉、树形 | | fieldForm3 | `formDemo/fieldForm3` | 弹窗选择 | | fieldForm4 | `formDemo/fieldForm4` | 文件上传 | | fieldForm5 | `formDemo/fieldForm5` | 开关、复选框 | | fieldForm6 | `formDemo/fieldForm6` | 定位、地图 | | verifyForm | `formDemo/verifyForm` | 表单验证 | ### 1.4 其他示例 | 示例 | 路径 | 功能说明 | |------|------|----------| | 导入导出 | `importAndExport` | Excel 导入导出 ★ | | 订单管理 | `order` | 主从表结构 | | 销售订单 | `saleOrder` | 复杂业务表单 ★ | | 项目甘特图 | `projectGantt` | 甘特图组件 ★ | | 邮件 | `email` | 邮件发送接收 ★ | | 条形码 | `barCode` | 条形码生成 | | 印章 | `signet` | 电子印章 | | 手写签名 | `signature` | 手写签名 | | 文档预览 | `documentPreview` | 多格式文档预览 | | 地图 | `map` | 百度/高德地图 | | 大数据 | `bigData` | 大数据量表格 | --- ## 二、后端模块对照 ### 2.1 Controller 层 | Controller | 路径 | 功能说明 | |------------|------|----------| | `TableExampleController` | `/api/extend/TableExample` | 表格 CRUD + 特殊操作 | | `EmployeeController` | `/api/extend/Employee` | 职员管理 + 导入导出 ★ | | `SalesOrderController` | `/api/extend/saleOrder` | 销售订单 ★ | | `OrderController` | `/api/extend/Order` | 订单管理 | | `ProjectGanttController` | `/api/extend/ProjectGantt` | 项目甘特图 | | `EmailController` | `/api/extend/Email` | 邮件收发 | | `BigDataController` | `/api/extend/BigData` | 大数据表格 | | `BarCodeController` | `/api/extend/BarCode` | 条形码生成 | | `DocumentPreviewController` | `/api/extend/DocumentPreview` | 文档预览 | | `CustomerController` | `/api/extend/Customer` | 客户管理 | | `ProductController` | `/api/extend/Product` | 产品管理 | | `WorkLogController` | `/api/extend/WorkLog` | 工作日志 | | `LeaveApplyController` | `/api/extend/LeaveApply` | 请假申请 | ### 2.2 Entity 层 | Entity | 表名 | 说明 | |--------|------|------| | `TableExampleEntity` | `table_example` | 表格示例 | | `EmployeeEntity` | `employee` | 职员信息 | | `SalesOrderEntity` | `sales_order` | 销售订单 | | `OrderEntity` | `order` | 订单 | | `ProjectGanttEntity` | `project_gantt` | 项目甘特图 | | `EmailSendEntity` | `email_send` | 邮件发送 | | `BigDataEntity` | `big_data` | 大数据 | | `CustomerEntity` | `customer` | 客户 | | `ProductEntity` | `product` | 产品 | | `WorkLogEntity` | `work_log` | 工作日志 | ### 2.3 Service 层 | Service | 说明 | |---------|------| | `TableExampleService` | 表格 CRUD | | `EmployeeService` | 职员 + 导入导出 | | `SalesOrderService` | 销售订单 | | `OrderService` | 订单 | | `ProjectGanttService` | 甘特图 | | `EmailSendService` | 邮件发送 | | `BigDataService` | 大数据 | --- ## 三、示例功能分类 ### 3.1 完整流程示例 ★★★ | 示例 | 说明 | 关键代码位置 | |------|------|--------------| | **Employee** | 导入导出完整流程 | `EmployeeController` 完整导入导出 | | **TableExample** | CRUD + 特殊操作 | `TableExampleController` 批注/行编辑 | | **saleOrder** | 主子表 | `saleOrder/index.vue` + `SalesOrderController` | ### 3.2 特殊功能示例 | 示例 | 功能 | 说明 | |------|------|------| | `projectGantt` | 甘特图 | 任务树 + 时间轴 | | `email` | 邮件 | 发送/接收/配置 | | `importAndExport` | 导入导出 | Excel/Word/PDF | | `barCode` | 条形码 | 生成打印 | | `documentPreview` | 文档预览 | Office/PDF/图片 | --- ## 四、源码位置速查 ### 前端 ``` web/apps/jnpf-web-apps-main/src/ ├── views/extend/ │ ├── importAndExport/ # 导入导出 ★ │ │ ├── index.vue # 主页面 │ │ ├── ImportModal.vue # 导入弹窗 │ │ └── ExportModal.vue # 导出弹窗 │ ├── saleOrder/ # 销售订单 ★ │ │ ├── index.vue # 主页面 │ │ └── Form.vue # 表单弹窗 │ ├── tableDemo/ # 表格示例 │ ├── projectGantt/ # 甘特图 │ └── ... └── api/extend/ ├── employee.ts # 职员 API ├── saleOrder.ts # 销售订单 API ├── table.ts # 表格 API └── ... ``` ### 后端 ``` jnpf/后端/jnpf-java-boot/jnpf-extend/ ├── jnpf-extend-controller/src/main/java/jnpf/controller/ │ ├── EmployeeController.java # 导入导出 ★ │ ├── TableExampleController.java # CRUD ★ │ ├── SalesOrderController.java # 销售订单 ★ │ └── ... ├── jnpf-extend-biz/src/main/java/jnpf/ │ ├── service/impl/ # Service 实现 │ └── mapper/ # Mapper └── jnpf-extend-entity/src/main/java/jnpf/ ├── entity/ # Entity └── model/ # VO/Form ``` --- ## 五、推荐学习路径 1. **入门**:TableExample → CRUD 最基础 2. **进阶**:Employee → 导入导出完整流程 3. **复杂**:saleOrder → 主子表操作 4. **扩展**:projectGantt → 甘特图组件