优化开发守则文档

2026-07-05 22:29:20 +08:00
parent 2e59742bc9
commit ae43bd528f
15 changed files with 70 additions and 882 deletions
@@ -86,8 +86,6 @@ server/<游戏容器目录>/<游戏>/             ← 子游戏接入后**唯一

 `docs/client/development-guide/`与`docs/server/development-guide/`（按 01→05/04 编号）是本项目遵循的权威、项目专属开发指南——改哪块就读对应编号的文档，而不是从代码反推约定。`docs/games/engineering/` 是位于两者之上的、与平台无关的工程方法论层（单一权威数据源 SSOT、单向依赖、职责单一、对扩展开放对修改封闭 OCP、配置优先于硬编码、显式失败优于隐式兜底）。

-注意：`server/docs/development-guide/` 是 `docs/server/development-guide/` 的旧版、部分过期的副本（例如它仍写死可编辑目录为 `games2/`，而新版已改为「容器目录名不再框架强制」）。两者冲突时以 `docs/server/development-guide/` 为准。
-
 两套文档中反复强调的硬性规则（文档记载均对应过真实事故）：
 - 全面严格 ES5（`var`/`function`，继承用 `Object.create`；禁止 `let/const`/箭头函数/模板字符串/`class`/解构/`Promise`）。
 - 服务端 `require` 只能写在文件开头的守卫块内（`if (typeof require !== 'undefined') { var X = require(...); }`）——禁止在函数体内中途 `require`；两个运行时之后统一按同一个全局名引用。