如何二次开发一个模块？从哪几个文件下手？

[XYAIStudio]

问题

想给公开版加能力或改示例模块，最小正确改动面是什么？有没有「只加菜单」这种坑？

[XYAIStudio]

答案（维护者）

请先读：模块二次开发契约。

权威目录：

• 后端：backend/open-module-catalog.ts
• 前端状态：frontend/src/open-modules.ts
• 登录后路由：frontend/src/OpenApp.tsx
• 侧栏：frontend/src/components/OpenSidebar.tsx

改示例模块时，通常要同步动这些面：

1. 页面：frontend/src/pages/
2. 路由与守卫：OpenApp.tsx
3. 菜单：OpenSidebar.tsx
4. API：backend/routes/
5. 表/迁移：backend/db.ts（及 migrations）
6. 租户隔离与审计：认证态上的 tenant_id，不要信客户端乱填
7. 验证脚本：scripts/（能复现读写与权限失败）

铁律： 不要只注册菜单或空页面。新增模块键必须前后端目录、导航、路由、测试一起改。新人 PR 不建议直接改模块目录契约；可先在 Q&A 对一下范围。

用户可见文案要中英双语同一 PR，见 本地化政策。