191 lines
6.9 KiB
Markdown
191 lines
6.9 KiB
Markdown
# 示例目录与功能对照表
|
||
|
||
> 基于 `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 → 甘特图组件
|