# school_sys_printer 表文档

## 表概述
**表名**: school_sys_printer  
**功能**: 系统打印机配置管理表，用于管理各种品牌的云打印机设备配置和打印模板

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
printer_id	int unsigned	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
printer_name	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	打印机名称
brand	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	设备品牌（易联云，365，飞鹅）
printer_code	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	打印机编号
printer_key	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	打印机秘钥
open_id	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	开发者id
apikey	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	开发者密钥
template_type	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	小票打印模板类型，多个逗号隔开
trigger	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	触发打印时机
value	longtext	utf8mb4_general_ci	YES		NULL		select,insert,update,references	打印模板数据，json格式
print_width	varchar(255)	utf8mb4_general_ci	NO		58mm		select,insert,update,references	纸张宽度
status	tinyint	NULL	NO		1		select,insert,update,references	状态（0，关闭，1：开启）
create_time	int	NULL	NO		0		select,insert,update,references	创建时间
update_time	int	NULL	NO		0		select,insert,update,references	修改时间
```

## 功能用途

### 主要功能
- **打印机设备管理**: 管理易联云、365、飞鹅等品牌的云打印机设备
- **设备配置管理**: 配置打印机编号、密钥、开发者ID等连接参数
- **模板类型管理**: 管理不同业务场景的小票打印模板类型
- **打印触发配置**: 配置自动打印的触发时机和条件
- **模板数据存储**: 存储JSON格式的打印模板数据和样式
- **纸张规格设置**: 设置打印纸张宽度等物理参数
- **设备状态控制**: 控制打印机的启用和禁用状态
- **多品牌支持**: 支持多种云打印机品牌的统一管理
- **API密钥管理**: 安全管理各品牌打印机的API访问密钥

### 业务场景
- **收费凭证打印**: 自动打印学费收据、报名凭证等财务单据
- **课程安排打印**: 打印课程表、上课通知等教学文档
- **考勤记录打印**: 打印学员签到记录、考勤统计等
- **合同协议打印**: 打印培训合同、协议书等法务文档
- **成绩单打印**: 打印考试成绩、评价报告等学习成果
- **通知公告打印**: 打印学校通知、公告等信息
- **证书凭证打印**: 打印结业证书、培训证明等
- **营销材料打印**: 打印宣传单、优惠券等营销物料
- **报表统计打印**: 打印各类业务统计报表
- **备份文档打印**: 打印重要数据的纸质备份

## 关联关系

### 主要关联表
- **school_sys_printer_template**: 打印模板表，存储具体的打印模板
- **school_pay**: 支付表，触发收费凭证打印
- **school_contract**: 合同表，触发合同打印
- **school_course**: 课程表，触发课程相关文档打印
- **school_attendance**: 考勤表，触发考勤记录打印
- **school_campus**: 校区表，不同校区可能使用不同打印机
- **school_sys_config**: 系统配置表，全局打印配置
- **school_member**: 会员表，个人信息打印
- **school_student**: 学员表，学员相关文档打印

### 关联说明
- **模板关联**: 通过template_type关联具体的打印模板
- **业务触发**: 各业务表通过trigger配置触发相应的打印任务
- **校区关联**: 不同校区可能配置不同的打印机设备
- **用户关联**: 打印任务可能关联具体的操作用户
- **配置关联**: 与系统全局配置形成层级配置关系

## 索引建议
```sql
-- 主键索引(自动创建)
PRIMARY KEY (printer_id)

-- 打印机编号索引(用于设备识别)
UNIQUE INDEX idx_printer_code (printer_code)

-- 打印机名称索引(用于名称查询)
INDEX idx_printer_name (printer_name)

-- 品牌索引(用于按品牌查询)
INDEX idx_brand (brand)

-- 状态索引(用于查询可用设备)
INDEX idx_status (status)

-- 模板类型索引(用于按模板类型查询)
INDEX idx_template_type (template_type)

-- 触发时机索引(用于按触发条件查询)
INDEX idx_trigger (trigger)

-- 创建时间索引(用于按时间查询)
INDEX idx_create_time (create_time)
```

## 注意事项
- **API密钥安全**: 妥善保管各品牌打印机的API密钥，避免泄露
- **网络连接**: 云打印机需要稳定的网络连接，注意网络环境
- **模板格式**: 不同品牌打印机的模板格式可能不同，需要适配
- **纸张规格**: 确保设置的纸张宽度与实际使用的纸张匹配
- **打印队列**: 高并发打印时需要考虑打印队列管理
- **错误处理**: 建立打印失败的重试和错误处理机制
- **设备状态**: 定期检查打印机设备的在线状态
- **模板数据**: JSON格式的模板数据需要验证格式正确性
- **权限控制**: 控制打印机配置的修改权限
- **日志记录**: 记录打印任务的执行日志和结果
- **成本控制**: 监控打印量，控制打印成本
- **维护保养**: 定期维护打印机设备，确保打印质量
- **备用方案**: 准备备用打印机，防止设备故障影响业务
- **数据备份**: 定期备份打印机配置和模板数据