zhjwxt/niucloud/databasedoc/school_campus.md

school_campus 表文档

表概述

表名: school_campus
功能: 校区信息管理表，用于存储和管理学校各个校区的基本信息、地理位置、状态等核心数据，是整个教务系统的基础数据表。

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	主键ID
campus_name	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	校区名称
campus_address	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	校区地址
campus_preview_image	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	校区预览图，存储图片路径
campus_coordinates	varchar(512)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	校区坐标，格式为经度,纬度
campus_introduction	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	校区介绍
campus_status	tinyint	NULL	YES		1		select,insert,update,references	校区状态：0-禁用，1-启用
create_time	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	校区创建时间
update_time	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	校区更新时间
delete_time	int	NULL	NO		0		select,insert,update,references	逻辑删除字段，0表示未删除，非空表示已删除

功能用途

主要功能

1. 校区基础信息管理: 存储校区名称、地址、介绍等基本信息
2. 地理位置管理: 通过坐标字段支持地图定位和导航功能
3. 校区展示: 支持校区预览图片展示，用于宣传和介绍
4. 状态控制: 支持校区启用/禁用状态管理
5. 数据完整性: 提供软删除机制，保证数据的完整性和可追溯性

业务场景

• 多校区学校的校区信息管理
• 学生选择校区时的信息展示
• 校区相关的课程、教师、学生数据关联
• 校区地理位置查询和导航
• 校区宣传和介绍展示
• 系统数据按校区进行分类管理

关联关系

直接关联表

1. school_student: 通过campus_id字段关联学生所属校区
2. school_teacher: 通过campus_id字段关联教师所属校区
3. school_course: 通过campus_id字段关联课程开设校区
4. school_classroom: 通过campus_id字段关联教室所属校区
5. school_department: 通过campus_id字段关联院系所属校区

间接关联表

1. school_class: 通过校区间接关联班级信息
2. school_schedule: 通过校区间接关联课程安排
3. school_exam: 通过校区间接关联考试安排
4. school_fee: 通过校区间接关联费用管理

关联说明

• id字段作为主键，在多个业务表中作为campus_id外键引用
• 校区是整个教务系统的基础维度，几乎所有业务数据都与校区相关
• 支持多校区独立管理，也支持跨校区数据统计分析
• 校区状态影响相关业务数据的可用性

索引建议

• 主键索引：id（自动创建）
• 唯一索引：campus_name（校区名称唯一性）
• 普通索引：campus_status（按状态查询活跃校区）
• 普通索引：delete_time（软删除查询）
• 复合索引：campus_status + delete_time（查询有效校区）
• 普通索引：create_time（按创建时间排序）

注意事项

1. 数据完整性: 校区是基础数据，删除前需要检查关联的业务数据
2. 软删除: 使用delete_time字段实现软删除，避免影响历史数据
3. 坐标格式: campus_coordinates字段建议使用标准的"经度,纬度"格式
4. 图片路径: campus_preview_image存储相对路径，需要配合文件服务使用
5. 状态一致性: campus_status和delete_time需要保持逻辑一致性
6. 唯一性约束: 校区名称应该保持唯一性，避免重复
7. 时区处理: timestamp字段需要注意时区设置和显示
8. 级联影响: 校区状态变更会影响所有关联的业务数据可用性