SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 10-16 07:23

技能介绍

用途:这是一份 Rust 后端开发规范,触发场景包括开发 Rust Web 项目、使用 Axum 实现 REST API、采用 SeaORM 异步 ORM、用 serde/validator 做数据验证、实现 JWT/Redis Token 认证与 RBAC 权限,以及开发 youlai-rust 管理后台模块。配合设计文档 docs/youlai-rust-2026.md 使用,AI 助手可据此从 0 到 1 创建与 youlai-boot-postgres 功能等价的 Rust 后端;不实现多租户,数据库为 PostgreSQL。

主要能力与约定:技术栈涵盖 tokio、axum 0.8+、sea-orm 1.1+、PostgreSQL 16+、Redis 7.x、figment、tracing、utoipa、jsonwebtoken+bcrypt、tower-governor、calamine/rust_xlsxwriter、aws-sdk-s3、lettre、tokio-cron-scheduler 等。目录划分为 core、common、entity、framework、modules 五层,entity 由 sea-orm-cli 生成且不依赖业务层,framework 不依赖 modules。规范覆盖文件/类型/方法/变量命名、DTO 后缀(Create/Update/VO/Query/Form/Result)、路由前缀与标准 CRUD 路径、固定路径端点须位于 /:id 参数端点之前的注册顺序、Handler 模板、HTTP 恒为 200 而业务码走 body code 字段的错误码体系(00000、A0210、A0230、A0301、A0400、B0001 等)、统一 Result/PageResult 响应格式,以及分页参数 pageNum/pageSize。

使用方式:按规范组织 src/ 各层结构与模块,路由以 routes() 注册并附 utoipa 注解,Service 方法命名为 get_page、get_by_id、create、update、delete 等;实体用 sea-orm-cli 生成,例如:sea-orm-cli generate entity --connection-string "postgres://postgres:123456@localhost:5432/youlai_admin" --output-dir src/entity --with-serde both。

限制:数据库脚本须各项目自用,禁止跨项目引用;具体配置、部署与测试细节以原资料及设计文档为准,本次未提供相关内容。