zhjwxt/niucloud/databasedoc/school_sys_area.md

school_sys_area 表文档

表概述

表名: school_sys_area
功能: 系统地区管理表，用于存储全国省市区县等行政区划信息，支持层级结构管理和地理位置定位，为系统提供地区选择的基础数据支撑

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int unsigned	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
pid	int	NULL	NO		0		select,insert,update,references	父级
name	varchar(50)	utf8mb4_general_ci	NO				select,insert,update,references	名称
shortname	varchar(30)	utf8mb4_general_ci	NO				select,insert,update,references	简称
longitude	varchar(30)	utf8mb4_general_ci	NO				select,insert,update,references	经度
latitude	varchar(30)	utf8mb4_general_ci	NO				select,insert,update,references	纬度
level	smallint	NULL	NO		0		select,insert,update,references	级别
sort	mediumint	NULL	NO		0		select,insert,update,references	排序
status	tinyint	NULL	NO		1		select,insert,update,references	状态1有效

功能用途

主要功能

• 地区数据管理: 存储全国省市区县等行政区划信息
• 层级结构管理: 通过pid字段构建地区的树形层级关系
• 地理位置定位: 存储经纬度坐标信息，支持地图定位功能
• 地区分级管理: 通过level字段区分省、市、区县等不同级别
• 地区状态控制: 管理地区的启用/禁用状态
• 地区排序管理: 支持自定义地区显示顺序
• 地区简称管理: 提供地区的简称信息，便于显示和检索
• 基础数据支撑: 为其他业务模块提供地区选择的基础数据
• 地区检索优化: 支持按名称、简称等多种方式检索地区

业务场景

• 用户地址选择: 用户注册、收货地址等场景的地区选择
• 校区地址管理: 校区创建时选择所在地区
• 人员地址信息: 教师、学员等人员信息中的地址选择
• 统计分析: 按地区统计校区分布、学员分布等数据
• 地图展示: 在地图上标注校区位置、服务范围等
• 配送范围设置: 设置教材配送、上门服务的覆盖范围
• 营销活动: 按地区开展针对性的营销推广活动
• 数据筛选: 按地区筛选各类业务数据和报表
• 权限控制: 基于地区的数据访问权限控制
• 服务区域: 定义不同校区的服务覆盖区域

关联关系

主要关联表

• school_campus: 校区表，关联campus_area_id字段
• school_member: 会员表，关联地址相关字段
• school_personnel: 人员表，关联地址信息
• school_member_address: 会员地址表，关联省市区字段
• school_sys_config: 系统配置表，可能关联默认地区设置

关联说明

• 自关联: 通过pid字段实现地区的层级关系，pid=0为顶级地区
• 校区关联: 校区创建时需要选择所在地区，用于地理位置标识
• 地址关联: 各类地址信息都需要关联到具体的省市区
• 统计关联: 各类统计报表按地区维度进行数据汇总
• 权限关联: 可能与用户权限系统结合，实现地区级别的数据权限

索引建议

-- 主键索引（自动创建）
PRIMARY KEY (id)

-- 父级ID索引（用于查询子地区）
INDEX idx_pid (pid)

-- 级别索引（用于按级别查询）
INDEX idx_level (level)

-- 状态索引（用于查询有效地区）
INDEX idx_status (status)

-- 排序索引（用于排序显示）
INDEX idx_sort (sort)

-- 复合索引（用于层级查询）
INDEX idx_pid_level_status (pid, level, status)

-- 名称索引（用于地区搜索）
INDEX idx_name (name)

注意事项

• 数据完整性: 确保地区数据的完整性和准确性，避免缺失重要地区
• 层级一致性: 维护地区层级关系的一致性，避免出现循环引用
• 级别规范: level字段应遵循统一的级别定义（如1-省，2-市，3-区县）
• 坐标精度: 经纬度数据应保证足够的精度，支持准确的地理定位
• 状态管理: 禁用地区时需要考虑对关联数据的影响
• 数据更新: 地区信息变更时需要同步更新相关业务数据
• 性能优化: 地区数据查询频繁，需要合理设置缓存策略
• 编码规范: 建议使用标准的行政区划代码作为地区标识
• 数据同步: 定期同步最新的行政区划调整信息
• 排序逻辑: 排序字段应考虑用户习惯和业务需求
• 简称唯一性: 在同级地区中简称应避免重复
• 删除限制: 已被引用的地区不应允许删除
• 批量操作: 支持地区数据的批量导入和更新功能
• 数据备份: 重要的基础数据应定期备份