# 业务应用 H5 界面规范（adminui-v1 / 底座 v0.9）

所有业务应用必须自带 H5。底座只负责导航、账号、登录、主题和消息桥，不生成表单、列表、工作流或通讯录。完整契约见 /docs/h5-ui.md。

- 在 manifest.ui 声明 mode=h5、entry、bridge_version=1 和 files；缺省和 generated 不再支持。
- 主题样式及 PlatformUI 自动注入。使用 --c-canvas、--c-surface、--c-text、--c-text-muted、--c-border、--c-brand 等变量，支持深浅主题。
- 模块自由设计内容区，包括表单、表格、卡片、棋盘和组织树；不要重复平台侧栏、登录或账号系统。
- H5 自己写明确的中文标签、必填约束、错误、空态和加载态，后端仍须验证所有字段和状态。禁止把后端校验仅放在浏览器。
- 使用相对资源地址，依赖随包发布；数据操作只走 PlatformUI.execute，不使用直接网络请求、CDN、eval 或 Service Worker。
- 表格在自身容器内滚动；检查390px手机宽度，主要按钮可见，长文本可换行。状态同时使用文字及语义色。
- 写入保留 requestId 以便通信超时重试；输入改变后再生成新请求号。按钮禁用不能代替幂等或服务端权限。
- iframe 不透明来源不允许父页面DOM、Cookie、存储和直接API访问；账号凭据不能传入H5。

验收：所有资源在包内且匹配指纹；正常业务交互；只读与写入角色；主题同步；手机布局；重启恢复；发布失败整体回退。自动模拟覆盖后端和安装契约，视觉和浏览器交互另外验收。

完整示例：工单、报销、请假、CMS、通讯录、发票、五子棋。