基于星火赋能平台做项目，最常见的后患是：业务代码直接写进平台自带的工程，平台一升级就要手工合并，越拖越难升级。下面是推荐的做法。
原则：平台代码不改，业务代码自建
- 自建应用层工程：新建属于你项目的应用层工程，引用平台核心层；
- 代码生成器生成到自建工程：按数据表生成后端服务、前端页面、菜单与按钮权限时，目标选择自建工程，而不是平台自带的示例应用层；
- 平台自带的应用层只是示例：可以参考写法，不要往里加业务代码。
这样平台核心层升级时，业务代码不受影响。
生成之后还要做的三件事
- 分配权限：生成的菜单和按钮权限要分配给对应角色，否则普通账号看不到；
- 检查数据权限：多租户、多组织项目，确认列表查询带上了数据范围；
- 补业务校验：生成的是标准增删改查，唯一性、状态流转等业务规则需要自己补齐。
本地跑不起来时
平台同时面向 net8.0 与 net10.0，启动时需要用 -f 指定目标框架，并且工作目录要在项目目录下。端口占用、数据库连接失败等问题见本地部署与联调故障排查。