Appearance
二次开发
客户拿到源码后，在扩展边界内增加业务能力。本文只写已经定稿、可按此实施的约定。
日常使用见 产品手册；部署见 实施交付；扩展目录与升级见 源码交付。
谁来看
已授权的客户开发或实施开发人员。不替代管理员配置手册。
扩展优先于改核心
| 做法 | 适用 |
|---|---|
| 用生成器产出业务模块 | 标准录入、查询、移动端填报 |
| 写源码插件 | 复杂规则、外部系统、需要独立升级的客户功能 |
| 改产品标准模块 | 仅当扩展边界不够；必须登记补丁，升级时单独合并 |
生成入口（开发或实施环境，生产默认不开放）：生成业务应用。表单草稿见 AI 创建表单。
交付物里常见目录
| 目录 | 用途 |
|---|---|
| 后端启动与聚合 | oars-java |
| 前端应用 | oars-web |
| 生成与 CLI | oars-tools |
| 源码插件 | oars-plugins/<插件标识>/ |
| 插件后端包 | oars-java/oars-app/src/main/java/com/oars/plugins/<插件标识>/ |
| 插件前端 | oars-web/apps/web-antd/src/plugins/<插件标识>/ |
| 平台库迁移 | 版本化脚本目录 db/migration（随应用启动执行） |
本栏目
| 页 | 内容 |
|---|---|
| 工程结构 | 后端模块、菜单与路由从哪里来 |
| 接口约定 | 登录、Token、响应码、Swagger |
| 前端约定 | 菜单 backend 模式、请求封装、插件页面 |
| 数据库约定 | 列名、迁移、插件 SQL |
| 扩展与插件 | 生成模式、插件边界、交付检查 |
改菜单、角色、字典请走管理员界面，不要直接改库绕过授权。