docs: 完善项目说明和注释

migrations/002_seed_demo_data.sql

@@ -0,0 +1,27 @@
+-- 002_seed_demo_data.sql
+-- 这个迁移文件负责写入项目启动时需要的演示数据。
+-- 它依赖 001_initial_schema.sql 先创建好 stores 和 roles 表。
+
+-- 初始化一个示例门店，方便本地直接创建员工并测试 CRUD。
+-- 指定 id = 1 是为了 README 里的示例请求可以稳定使用 storeId: 1。
+INSERT INTO stores (id, name, address, phone, status)
+VALUES (1, '示例门店', '请改成你的真实门店地址', '13800000000', 'ACTIVE')
+ON DUPLICATE KEY UPDATE
+  name = VALUES(name),
+  address = VALUES(address),
+  phone = VALUES(phone),
+  status = VALUES(status);
+
+-- 初始化常见角色。
+-- code 用于代码和接口里的稳定标识，name/description 用于页面或接口展示。
+INSERT INTO roles (code, name, description)
+VALUES
+  ('store_manager', '店长', '负责门店日常管理、排班和权限审批'),
+  ('cashier', '收银员', '负责收银、订单核对和基础会员操作'),
+  ('kitchen', '后厨', '负责出品、备货和库存相关操作'),
+  ('part_time', '兼职', '临时员工，默认只开放基础操作'),
+  ('admin', '管理员', '系统管理角色，仅授予可信人员')
+-- 如果重复执行迁移或本地重新导入数据，已存在的角色会更新名称和说明，避免重复插入报错。
+ON DUPLICATE KEY UPDATE
+  name = VALUES(name),
+  description = VALUES(description);