9.16/1

backend/doc/同步文档.md

@@ -13,6 +13,20 @@
 - User: `root`
 - 说明：所有结构变更均通过 MysqlMCP 执行并已落地到线上库。
 
+### 角色与模拟数据策略（统一为店长）
+- 当前不进行角色划分，系统仅保留“店长”角色。
+- 已将所有用户记录统一为：`role='owner'`、`is_owner=1`。
+- 前端/后端权限逻辑暂未启用，后续若引入权限体系，再行扩展角色与边界。
+
+### 小程序默认用户（可开关，默认关闭）
+- 目的：开发/演示阶段，便于免登录联调。
+- 机制：前端在请求头附加 `X-User-Id`（值为张老板 id=2），仅当开关开启时。
+- 开关：
+  - 环境变量：`VITE_APP_ENABLE_DEFAULT_USER=true` 与 `VITE_APP_DEFAULT_USER_ID=2`
+  - 或本地存储：`ENABLE_DEFAULT_USER=true` 与 `DEFAULT_USER_ID=2`
+- 关闭：不设置/置为 `false` 即可停用（生产环境默认关闭）。
+- 完全移除：删除 `frontend/common/config.js` 中默认用户配置与 `frontend/common/http.js` 中注入逻辑。
+
 ### 后端（Spring Boot）数据库状态
 - 依赖：`pom.xml` 未包含 `spring-boot-starter-web`、`spring-boot-starter-data-jpa`、`mysql-connector-j` 等数据库相关依赖。
 - 配置：`src/main/resources/application.properties` 仅有 `spring.application.name=demo`；未配置 `spring.datasource.*`、`spring.jpa.*`。