Statamic Laravel Git 驱动内容管理

这份技能解决的核心问题是：内容团队想要版本可控、可审计的 CMS，但又不想失去熟悉的后台操作界面。很多基于 Git 的内容方案会把所有管理都推给命令行，编辑人员用不顺手；而传统数据库驱动 CMS 又很难做 diff、回滚和代码审查。Statamic 的思路是内容写入扁平文件，Git 天然成为版本账本，同时保留完整的 Control Panel 给编辑用。这份技能把这套工作流整理成可复用的步骤，让团队能在 Laravel 项目里快速落地。

要解决的问题

• 内容改动缺少可追溯的提交记录，出问题时无法快速定位是谁在什么时候改了什么。
• 数据库迁移把内容和 schema 混在一起，代码 review 时很难判断行为变更与内容变更。
• 团队希望走现代 Laravel 部署流程，比如 CI 里对内容做版本校验，但又不想完全抛弃后台编辑。

核心能力与关键步骤

• 基于扁平文件的数据存储：内容条目以文件形式落在项目目录里，结构由 collections 与 blueprints 定义，天然能被 Git 追踪和 diff。
• 完整 Control Panel：编辑人员仍然可以在后台增删改内容，底层写入的是文件而非数据库表，操作体验接近传统 CMS。
• 自定义集合与字段：根据业务模型扩展 collections 结构，把标题、slug、正文和自定义字段组织成清晰的 blueprint。
• Git 作为唯一版本账本：提交信息会包含内容变更的上下文，git diff 能直接看到文案和结构化字段的差异。
• 现代化部署集成：内容分支可与功能分支联动，把编辑改动和代码改动放进同一个 review 流程。

适用边界与注意点

• 初始资料里没有提供自动化安装脚本，实际落地时需要先查阅上游 GitHub 仓库的说明再运行。
• 涉及敏感生产流程时建议先在预发环境验证：文件权限、.gitignore 规则和缓存清理策略都需要提前调好。
• 团队成员如果习惯数据库迁移工具，需要切换到「内容即代码」的思路，提交前先确认 git status。
• 大型媒体库仍会用到磁盘或云存储，Git 不适合直接管理二进制资产，这部分要单独规划。