genies

Guide for using RBatis v4 Rust ORM framework. Use when implementing database CRUD operations, writing dynamic SQL with py_sql or html_sql macros, configuring database connections, managing transactions, implementing interceptors, syncing table structures, or integrating RBatis into Genies microservices. Also use when the user asks about RBatis usage patterns, query building, or database operations in Rust.

Genies 前后端接口规范。Use when designing API contracts, defining field naming conventions, date/time formats, response models, pagination, error handling, or ID strategies between Genies backend and frontend (Web/Android/OHOS).

Guide for using flyway-rs database migration framework with RBatis. Use when implementing database schema migrations, managing SQL changelog files, configuring migration runners, handling multi-database migrations, or integrating database versioning into Genies microservices.

Guide for developing Rust microservices using Genies framework following Java DDD layering principles. Use when creating new microservices, designing aggregate roots, implementing domain events, organizing service layers, setting up Flyway migrations, or structuring a DDD-based Genies project.

Genies framework unified skill hub. Use when you need to find the right skill for any Genies framework task, including authentication, authorization, caching, configuration, database, DDD microservices, Dapr messaging, macros, K8s deployment, testing, API conventions, gateway proxy, or Salvo web framework features. Also use when the user asks about Genies framework capabilities, asks which skill to use, or wants a quick overview of available Genies skills.

Guide for using the Genies Rust microservice framework with DDD and Dapr. Use when developing with Genies, creating aggregates, domain events, Dapr subscriptions, Casbin field-level permissions, configuration management, or when the user asks about Genies framework usage patterns.

Generate OpenAPI documentation automatically from Salvo handlers. Use for API documentation, Swagger UI, and API client generation.

Guide for using genies_config configuration management. Use when setting up application configuration, defining YAML config files, customizing ApplicationConfig fields, or configuring logging in Genies projects.

Guide for using the genies_auth_admin unified authentication management backend. Use when working with user/role/permission/department/application/instance CRUD, auth-admin API endpoints, admin UI, local JWT authentication, DDD architecture in auth-admin, Dapr event integration, app-proxy permission management, or microservice instance registration/heartbeat. Also use when the user asks about auth-admin startup, configuration, database migrations, or department member_count.

Guide for using the genies_auth permission and authentication module. Use when implementing API-level access control, field-level permission filtering, Casbin policy management, role assignment, resource grouping, JWT authentication middleware (local_auth, combined_auth), or when integrating auth middleware into Salvo routes. Also use when the user asks about

Guide for understanding and configuring the gateway/proxy convention in Genies projects. Use when setting up local development environment with nginx reverse proxy, configuring debug/servlet_path/gateway for a microservice, implementing route prefix mounting in main.rs, debugging cross-service HTTP call routing issues, adding a new service to the nginx configuration, or understanding how production gateway forwarding maps to local development.

Guide for using genies_core response models, error handling, and JWT utilities. Use when building HTTP handlers with RespVO/ResultDTO responses, implementing JWT authentication, or handling errors in the Genies framework.

Guide for using genies_ddd Domain-Driven Design primitives. Use when defining aggregates, domain events, implementing event sourcing patterns, or building DDD-based microservices with the Genies framework.

Guide for using genies_derive procedural macros. Use when implementing DDD aggregates with

Guide for using genies_test testing infrastructure. Use when implementing Java/Rust API comparison tests, database snapshot/diff/restore operations, deep JSON diff analysis, or integrating test utilities into Genies microservices.

Guide for using genies_context application context management. Use when initializing global context, managing database connections, configuring cache services, handling cross-service authentication tokens, or integrating K8s health status in Genies projects.

Guide for using genies_cache dual-backend caching service. Use when implementing Redis or in-memory caching, managing TTL and atomic operations, or integrating caching into Genies microservices.

Guide for using genies_dapr Dapr integration. Use when implementing pub/sub messaging, handling CloudEvents, configuring topic subscriptions, or integrating Dapr sidecar with Genies microservices.

Guide for using genies_k8s Kubernetes health probes. Use when configuring liveness and readiness probes, integrating health check endpoints into Salvo routers, or deploying Genies services to Kubernetes.

Implement authentication and authorization using JWT, Basic Auth, or custom schemes. Use for securing API endpoints and user management.

Create basic Salvo web applications with handlers, routers, and server setup. Use when starting a new Salvo project or adding basic HTTP endpoints.

Implement caching strategies for improved performance. Use for reducing database load and speeding up responses.

Compress HTTP responses using gzip, brotli, zstd, or deflate. Use for reducing bandwidth and improving load times.

Limit concurrent requests to protect resources. Use for file uploads, expensive operations, and preventing resource exhaustion.

Configure Cross-Origin Resource Sharing (CORS) and security headers. Use for APIs accessed from browsers on different domains.

Implement CSRF (Cross-Site Request Forgery) protection using cookie or session storage. Use for protecting forms and state-changing endpoints.

Extract and validate data from requests including JSON, forms, query parameters, and path parameters. Use for handling user input and API payloads.

Integrate databases with Salvo using SQLx, Diesel, SeaORM, or other ORMs. Use for persistent data storage and database operations.

Handle errors gracefully with custom error types, status codes, and error pages. Use for building robust APIs with proper error responses.

Handle file uploads (single/multiple), downloads, and multipart forms. Use for file management, image uploads, and content delivery.

Implement flash messages for one-time notifications across redirects. Use for success/error messages after form submissions.

Implement graceful server shutdown to handle in-flight requests before stopping. Use for zero-downtime deployments and proper resource cleanup.

Implement request logging, tracing, and observability. Use for debugging, monitoring, and production observability.

Implement middleware for authentication, logging, CORS, and request processing. Use for cross-cutting concerns and request/response modification.

Path parameter syntax guide for Salvo routing. Explains the `{}` syntax (v0.76+) vs deprecated `<>` syntax, with migration examples.

Implement reverse proxy to forward requests to backend services. Use for load balancing, API gateways, and microservices routing.

Implement rate limiting to protect APIs from abuse. Use for preventing DDoS attacks and ensuring fair resource usage.

Implement real-time features using WebSocket and Server-Sent Events (SSE). Use for chat applications, live updates, notifications, and bidirectional communication.

Configure Salvo routers with path parameters, nested routes, and filters. Use for complex routing structures and RESTful APIs.

Implement session management for user state persistence. Use for login systems, shopping carts, and user preferences.