贡献指南

欢迎提交 Issue 与 Pull Request。改动前先读 架构设计 与本仓库约定，保持与现有分层、接口契约一致。

提交信息

使用 Conventional Commits，subject 用中文祈使句，不超过 72 字符。例如：fix: 修复角色列表分页总数。

不要把 docs/ 加进提交（文档目录不进 git）。

后端质量命令

在 server/ 下执行：

composer test
composer lint
composer analyse
composer check:context

• composer test：跑 PHPUnit。
• composer lint：PHP-CS-Fixer 干跑检查风格。
• composer analyse：PHPStan 静态分析。
• composer check:context：常驻内存与分层纪律检查。

提交前至少保证与本次改动相关的测试与检查通过。