开发注意事项

配置基准

• 后端本地行为以 shengyu-server/src/main/resources/application-local.yaml 为准。
• 开发容器或生产容器使用 application-dev.yaml 时，必须同步必要的域名、回调与上传配置。
• 钰信客户端域名以 shengyu-ui/shengyu-ui-admin-flutter/lib/app/config/app_config.dart 为准；浏览器入口 im.shengyukj.top 不应被当作 API 域名。

数据与权限

• 新增租户业务表应包含 tenant_id 并验证租户隔离是否生效。
• 平台级表、平台接口使用平台模块和平台权限表达式；租户业务使用 system 模块和租户权限表达式。
• 新增菜单、权限、字典或初始化数据时，必须提供幂等 SQL 增量，并同步开源初始化脚本。
• 不在代码、前端构建产物、SQL 或文档中提交密码、Token、证书私钥、推送密钥和生产账号。

发布纪律

• 后端、Vue、Flutter 和 Nginx 配置变更应分别构建、部署与验证，不能只替换其中一部分。
• 生产 API 必须使用 HTTPS；Flutter 的 API、WebSocket 和 LiveKit 地址使用可公网路由的正式域名。
• Android 在线更新必须使用同一发布签名，且发布版本的构建号必须递增。
• 涉及音视频时，除 HTTPS/WSS 外还要验证 UDP/TCP RTC 和 TURN 端口；仅页面能打开不代表通话可用。