当前为 0.x 开发版本，安装和联调只支持当前 API、配置、任务载荷与数据库基线；请使用全新隔离数据库，不直接覆盖旧开发库。
当前提供用户、角色、权限、组织、产品套餐、多租户、配置迁移、跨库迁移、监控、消息、调度、导入和导出。Agent 查询接口、用户委托和服务账号管理已移除，个人资料、密码、头像和登录会话管理继续保留。套餐可以发布不含可选能力的版本，租户开通与配额管理照常使用。
RyFrame 是面向企业后台的 Rust 2024 服务端，与 RyFrame-Vue3 配套使用。它提供认证授权、系统管理、多租户、异步任务、筛选导出、对象存储和可观测性能力。
项目运行时以 Rust 为唯一业务实现语言。API、Worker、迁移、重建和业务生成器均有独立 Rust 二进制；cargo xtask 只用于 RyFrame 自身的检查、构建、CI、性能、恢复和发布维护。
API、Worker、迁移和维护程序按 feature 定向构建；标准资源生成默认离线，数据库结构导入按需启用 schema-import。前端首屏只同步加载核心、外壳和全局导出文案，生产构建自动检查初始依赖图与包体积预算。
构建、检查、首页和业务负载的性能通过 cargo xtask check perf 测量；需要写入隔离环境的性能身份准备从 cargo xtask data performance-identities 进入，使用方式见开发指南。源码或工具链变化后，既有测量只能作为历史参考；报告需要对应实际源码、硬件、服务配置和冷暖缓存条件，不能用单次构建耗时或包体积推断首页打开时间。当前改造后的完整恢复和性能验收仍在准备中，不代表已达到正式版发布条件。
本地开发使用 Windows，需要准备：
- Rust 1.98.1（由
rust-toolchain.toml固定，最低版本为 1.98）； - MySQL；
- WSL 中的 Redis；
- 需要文件能力时启动 Windows RustFS；
- 前端所需的 Node.js 与 pnpm。
配置从 config/ 中对应环境的文件加载，并可使用 APP_ 环境变量覆盖。密码、令牌和证书请使用本机环境变量或密钥文件，不要写入配置样例。
$env:APP_ENV = "dev"
cargo migrate -- control verify
cargo servecargo migrate -- control verify 校验控制库结构，不修改数据库。确认迁移后使用 cargo migrate -- control up。租户库必须明确指定配置中的目标键，例如 cargo migrate -- tenant-data verify --target <目标键>。
cargo serve 只启动后端 API。需要 Worker 时在另一个终端运行 cargo worker；前端在 ryframe-vue3 仓库中单独运行 corepack pnpm dev。
非生产重建通过 cargo reset -- <参数> 执行。备份、恢复、性能和发布演练属于框架维护流程，按运维文档使用 cargo xtask。
日常修改后运行：
cargo xtask check准备联调或交付前运行完整检查：
cargo xtask check --full--scope backend|frontend 可限制主要检查侧。更多迁移、测试和排障命令见开发指南。
维护和验收统一从 cargo xtask 进入，不直接把 tools/ 中的文件当作用户命令。各辅助文件的职责与调用边界见 tools/README.md。
生产构建分别生成 release API、Worker 和前端生产目录，并输出每项产物的路径、大小和 SHA-256。--plan 使用同一任务图展示依赖、输入范围和允许写入，不执行任务或写入文件：
cargo xtask build --plan
cargo xtask build实际构建会在开始和结束时核对前后端工作树指纹；构建期间来源变化时直接失败，不能把混合来源产物作为成功结果。
openapi/openapi.json 是后端 HTTP 契约快照。接口变化后同步前端派生契约：
cargo xtask generate api --write完成同步后，在前端运行消费者检查并进行浏览器联调。请求格式、认证方式和稳定错误码见 API 指南。
RyFrame 不内置示例业务 crate。使用正式脚手架在 crates/ 下按业务域创建一个或多个普通库 crate：
cargo ryframe new-business order
cargo generate -- resource --package order-business
cargo generate -- resource --package order-business --model Order --writecargo ryframe new-business order --dry-run 只显示将创建或更新的文件。正式创建会写入业务 crate 的元数据和目录、工作区成员、组合根依赖及统一 business_modules() 注册表；API、Worker 与迁移因此读取同一个模块集合。业务模型使用 Rust ResourceModel 维护。生成器可从工作区根目录或业务 crate 的任意子目录运行；预览默认只显示差异，只有 --write 更新 src/generated/、migrations/ 和 ownership。手写代码放在 src/resources/ 与 src/extensions/，不会被生成器覆盖。完整结构和代码见开发指南。
字段、菜单、权限、配置默认值和生成结果分别以 OpenAPI、catalog/access.toml、配置结构、资源清单及命令 --help 为准。