从想法到云端应用
你可以请助手把业务需求做成可访问的应用，通过 Brazosd API 使用云盘、智能体和会话，并接入 Brazosd 登录。先做一个可检查的最小版本，再考虑发布。
本页内容
先描述使用场景
不需要先决定技术方案。说明谁使用、填写什么、看到什么、数据是否需要保存，以及哪些内容不能公开。
我想做一个活动报名应用。 访问者填写姓名和联系方式，管理员可以查看和导出报名表。 请先确认使用人数、访问权限和数据保存方式，再给我一个最小方案。 先在测试环境验证；未经我确认，不发布正式版本，也不写入正式数据。
助手能否完成具体应用，取决于模型、工具和权限。涉及登录、支付或个人信息时，先把访问规则讨论清楚。
认识三个组成部分
| 名称 | 可以怎样理解 |
|---|---|
| 云函数 | 让应用代码在云端提供服务的运行位置 |
| 云数据库 | 保存报名记录、业务数据等需要长期保留的内容 |
| 开发环境快照 | 保存一份可复用的开发文件和依赖环境 |
表格较宽时，可以左右滑动查看。
可以在平台页面查看云函数、云数据库和快照。初次使用不必手动填写所有技术参数，可以让助手解释配置用途并协助准备。
原生能力：把平台资源接入应用
应用服务端可以直接调用 Brazosd API，Node.js 应用也可以使用官方 SDK @brazosd/node。你可以把已有资料、助手和工作记录接到自己的业务页面中：
| 平台资源 | 应用可以做什么 | 示例 |
|---|---|---|
| 云盘 | 在权限范围内上传、读取、整理和下载文件 | 读取合同，把审查报告保存回云盘 |
| 智能体 | 查询可用助手，创建会话并交给助手执行任务 | 从业务页面发起合同审查、资料分析或报告生成 |
| 会话 | 读取任务状态、消息和结果，继续已有任务 | 在应用里展示进度，并让用户补充要求 |
表格较宽时，可以左右滑动查看。
云函数默认以自己的 service user（服务用户） 调用 API，由组织为它配置相应的 API 和资源权限。这个身份代表应用；访问者打开网页或登录应用，不会自动把自己的云盘和会话权限交给它。需要以当前用户的权限访问平台数据时，使用下面的内部应用 SSO 方案。
选择登录与注册方式
推荐接入 Brazosd SSO（单点登录），复用 Brazosd 的账号注册和登录。用户在 Brazosd 页面完成登录、选择组织并确认后，返回应用。已有账号体系或需要独立账号时，也可以自行实现登录注册。
| 方式 | 适用用户 | 应用得到什么 |
|---|---|---|
| 自己做登录注册 | 使用独立账号体系的用户 | 应用自行管理账号、登录和会话；这些账号不会自动获得 Brazosd API 权限 |
| Brazosd SSO：内部应用 | 应用所属组织的成员 | org-user：独立的用户 access token 和 refresh token，按该用户在组织内已有的权限访问云盘、智能体、会话等资源 |
| Brazosd SSO：第三方应用 | 任意组织的用户，适合面向外部客户的 SaaS | identity：只获得确认用户身份的 JWT，不能用它访问 Brazosd API |
表格较宽时，可以左右滑动查看。
内部应用拿到的是单独签发、可以撤销的授权，用户凭证保存在应用服务端。Brazosd 不会把浏览器当前使用的登录凭证直接交给应用，也不会通过这种方式把其他组织用户的平台数据开放给第三方。
身份 JWT 包含 account_id、org_id 和 user_id。一般推荐用 account_id 识别应用中的用户，同一个账号切换组织后仍是同一个人；如果业务按组织成员隔离，也可以选择 org_id 与 user_id 的组合。登录身份不等于应用管理员权限，业务角色、数据访问规则和应用会话仍由应用自己管理。同组织用户只需要登录身份时，也可以使用 identity。
示例：合同审查 SaaS
管理后台面向本组织成员，用 org-user 登录，在成员已有权限范围内读取云盘资料、使用智能体并查看审查会话。普通客户页面用 identity 登录，以 account id 建立应用自己的用户记录。
客户主动上传给应用的合同，可以由应用用自己的服务用户调用获授权的智能体处理，结果保存到获授权的云盘目录或应用数据库。应用负责隔离每个客户的合同；客户登录并不授权它读取客户原有的 Brazosd 云盘。
请做一个合同审查 SaaS，使用 Brazosd API 和 SSO。 管理后台仅供本组织成员使用，按用户权限访问云盘、智能体和会话。 客户页面允许任意组织账号登录，只获取身份，以 account id 识别用户。 不同客户只能查看自己提交的合同和结果。 请按“开发云函数与云应用”技能完成接入，先在测试环境验证这两种登录模式和数据隔离。
按这个顺序推进
- 确认需求： 页面、数据、使用者和权限。
- 完成测试版本： 用单独的测试函数和测试数据库验证流程。
- 亲自试用： 测试正常输入、缺失字段、重复提交和权限限制。
- 准备正式发布： 确认正式资源、数据、地址和预期费用。
- 发布后检查： 打开应用，验证实际版本与关键流程。
“开发完成”“部署中”“已经可以访问”是不同状态。应等部署结果和实际访问检查完成，再把链接交给别人。
快照保存什么
快照保存开发环境中的文件和依赖，不保存正在运行的进程、内存或连接。创建前先让助手完成文件写入和依赖安装。
组织内的快照可被其他成员查看和使用，应检查其中是否包含不该共享的文件。被云函数、智能体或会话引用的快照，需要先解除引用才能删除；删除权限还与创建者及组织所有者有关。
发布、回退与数据
新部署准备就绪前，已有版本可以继续提供服务。部署包和历史记录帮助你识别当前版本，必要时选择历史包回退。
应用版本回退不等于数据库内容也自动回退。正式数据的变更应单独确认和备份，不要把测试数据与正式数据混用。
后续维护
记录应用用途、管理人、正式地址、使用的数据库和维护方式。定期检查账单及资源状态。不再需要时分别确认停用或删除的资源，删除操作可能不可恢复。