FFGS 开发注意事项

1总则

开发注意事项的定位与适用范围：

• 本文档约束开发全流程：需求 → 讨论 → 开发 → 测试 → 部署 → 维护，任何环节不得绕过。
• 适用于所有参与 FFGS 服务器开发、维护的成员，含外包与临时协作者。
• 与现有管理制度冲突时，以本文档为准；未覆盖事项，按「先讨论、后执行」原则处理。
• 文档由项目负责人维护，重大变更需在开发层上说明。

2需求管理

2.1 需求提出

• 所有需求必须书面化（文档/私信），口头需求不进入开发目录。
• 需求提出方需说明：内容、目标、预期效果。【待定：优先级分级规则】
• 玩法类需求（内容、规则）需表述完整，提供事例，提交后经开发组确认，避免重复返工。

2.2 需求评审

• 需求进入开发前必须评审：可行性、工作量、影响范围、风险。
• 评审结论记录在案：通过 / 驳回 / 修改后通过。
• 「小需求」也需进行提交，禁止随意更改。

2.3 需求变更

• 开发中变更需求，须重新评审并同步可行性、工作量、影响范围、风险。
• 上线前 24 小时内原则上冻结需求变更（紧急修复除外）。
• 变更需记录「变更人 / 时间 / 原因 / 影响范围」。

3开发流程

3.1 排挡

• 需求开发要进行排挡，根据排挡顺序进行开发
• 当前开发任务未完成时，不得开始新的任务

3.2 开发环境

• 统一使用测试服联调，禁止直接改线上配置。
• 开发环境与生产环境隔离，测试数据与玩家数据分离。
• 本地环境由成员自行维护，但版本、依赖以pyz发布的为准。

3.3 命名空间于开发

• 命名空间统一使用ffgs
• 开发内容需提交至FFGS网盘<网址>: 1801pyzgw.bot.cd更改内容开发人，日期

3.4 开发自检

• 提交前自检清单：编译通过、核心流程可跑、无调试残留、无敏感信息。
• 禁止提交：本地日志、密钥、数据库备份、IDE 配置、临时文件。

4测试规范

4.1 测试要求

• 功能上线前必须经过测试服验证，禁止「上线即测试」。
• 涉及玩法规则时改动，需按流程完整跑一遍：开局 → 对局 → 结算 → 结束对局。
• 涉及存档/数据迁移的改动，先备份、后操作、再验证，不可行即使回档。

4.2 测试记录

• 测试结果留痕：测试人、时间、版本、通过/失败、遗留问题。上传测试报告-<测试人>.txt至FFGS网盘。
• 遗留问题必须明确负责人与修复时限，不得带病上线。

4.3 回档

• 影响面较大的改动，需对备份服务器
• 进行版本更新时，需对回档日期、时间进行记录

5评审与验收

• 该条例用于功能开发外包的情况
• 验收需进行完整的测试于记录，未通过不得进入发布流程。
• 「紧急修复」可先上线修复，然后上传报告至FFGS网盘，限 24 小时内记录。

6上线与发布

6.1 发布流程

1. 确认版本号与变更清单（更新了什么、、删除什么、影响什么）。
2. 备份线上相关数据（mods/配置/存档）。
3. 选择低峰时段发布，重大改动提前在群内发布公告。
4. 发布后管理员首测，确认核心功能正常。

6.2 回档预案

• 每次发布前明确回档日期、时间和负责人。
• 发布后服务器功能异常（玩家无法进服、数据异常、频繁报错）立即关闭入服ip并立刻介入排查。

6.3 发布记录

• 每次发布记录：日期、时间、内容、操作人、结果。
• 线上配置变更同样留痕，禁止无记录改动。

7服务器与数据

7.1 备份制度

• 重要变更前手动备份，注明日期与内容。

7.2 资源管理

• 暂无

7.3 访问控制

• 服务器op按需给予，退出成员立即回收。

8安全事项

• 发现漏洞或异常访问，第一时间报告负责人，先处置后公开。
• 不随意安装来源不明的插件/脚本，安装前检查来源与权限。

9文档规范

• 系统结构、业务流程变动后，同步更新服务器维护手册，保持文档与现状一致。
• 关键操作（部署、回档、故障处理）需进行记录。