feat: 切换 schema dump 基线并增强返点结算与管理校验

README.md

@@ -11,6 +11,29 @@
 
 侧栏与 `prd.*` 权限目录见 [`docs/admin-rbac.md`](docs/admin-rbac.md)。维护命令：`php artisan lottery:admin-auth-sync --audit`。
 
+## 数据库基线
+
+项目当前已经整理出一份**最终版基线结构**，并已将历史迁移链清理为 schema dump 模式：
+
+- PostgreSQL 基线文件：[`database/schema/pgsql-schema.sql`](database/schema/pgsql-schema.sql)
+- 适用场景：**新环境初始化**
+- 后续 migration 目录：`database/migrations/`
+- 适用场景：**从当前基线之后继续新增结构变更**
+
+推荐约定如下：
+
+- 新环境初始化时，优先使用 Laravel schema dump，让框架先加载 `database/schema/pgsql-schema.sql`，再执行该时间点之后的新迁移。
+- 已上线或已有数据的环境，如果已经接受 schema dump 作为唯一基线，可不再保留历史 migration 文件。
+- 之后的数据库结构演进，从当前 schema dump 往后继续追加新的 migration。
+
+当数据库结构发生一轮阶段性稳定变更后，可重新生成基线：
+
+```bash
+php artisan schema:dump --database=pgsql
+```
+
+如果只是日常开发中的普通字段变更，仍然按正常方式新增 migration 即可；等累积到一段时间后，再统一刷新一次 schema dump。
+
 ## About Laravel
 
 Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as: