首次使用

完成 快速开始 后，先用一个普通账号验证日常操作，再接入审批、商城等业务。本页操作在开发或验收环境进行，演示用商品、订单和文件与正式业务数据分开。

1. 设置管理员和组织

先修改初始管理员密码，再在组织管理中建立实际部门、岗位和用户。初始化不会预建你的组织；部门和人员下拉列表为空时，先补齐这些资料。

为日常使用建立业务角色，将测试用户关联到该角色。超级管理员适合初始化和管理权限；用它测试所有页面，无法发现普通角色漏授权的问题。

2. 给普通角色授权

按 权限体系 分配菜单、按钮、API 和适用的数据范围。一个“查询商品”的角色，除列表接口外，还可能需要分类选项、详情等页面依赖接口。

用普通账号登录，检查三件事：能看到分配的页面、能执行允许的操作、不能通过接口执行未授权操作。自定义角色也要有当前用户信息、退出及个人维护所需的基础 account:* 权限。

3. 设置站点与文件

在站点配置中修改品牌、名称、Logo 和需要的业务开关。数据库地址和服务器端口仍在外置 YAML 中修改；两类配置的区别见 应用配置。

首次可使用默认本地存储。上传图片，检查预览、下载和重启后是否仍可读取。计划使用 OSS/MinIO 时，再按 文件与对象存储 配置并验证。更换默认存储不会自动迁移已经上传的文件。

4. 按需启用业务

要使用的功能	先准备	第一次验证
通知	发布权限、实际收件人	发布后，收件人能在收件箱看到通知
审批	部门、发起人、审批人、已发布流程	发起一条申请，由实际待办人审批到结束
商城	商品基础资料、启用的默认仓库、商品和库存	先完成一笔人工付款订单的履约
在线支付	商户凭据、加密密钥、HTTPS 回调	在对应渠道环境验证支付、查询、回调和退款
AI 助手	模型服务地址、可用模型、API Key	收到逐步输出的回答，错误时有明确提示

详细步骤：审批、商城、支付、通知与 AI。无需为了启动系统一次配完全部第三方服务。

5. 交付前留下一份使用记录

将实际前后端版本、访问地址、部署方式、启用模块和维护联系人交给客户；账号与密钥通过约定的受控方式交接。保留数据库、上传文件和实际配置的备份，并验证能恢复。

验收以客户真正使用的流程为单位：普通角色能完成操作、数据保存正确、失败时可以定位、重启后数据仍在。只打开首页或检查健康接口还不能替代业务验收。部署与恢复步骤见 部署运维 和 备份与升级。