Files
aibridge/docs/codedev/03-examples-index.md
T
2026-05-18 09:28:15 +08:00

191 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 示例目录与功能对照表
> 基于 `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 → 甘特图组件