Struct BackboneCrudHandler 

pub struct BackboneCrudHandler<S, E, C, U, R>
where
    S: CrudService<E, C, U> + 'static,
    E: Serialize + Send + Sync + 'static,
    C: DeserializeOwned + Send + Sync + 'static,
    U: DeserializeOwned + Send + Sync + 'static,
    R: From<E> + Serialize + Send + Sync + 'static,
{ /* private fields */ }

Generic Backbone CRUD handler that provides all 11 endpoints as an Axum router.

This handler wraps a CrudService implementation and generates all standard Backbone endpoints automatically.

Type Parameters

• S: Service implementing CrudService
• E: Entity type
• C: Create DTO type
• U: Update DTO type
• R: Response DTO type (must implement From<E>)

Example

let user_crud = UserCrudService::new(user_service);
let routes = BackboneCrudHandler::<UserCrudService, UserAggregate, CreateUserDto, UpdateUserDto, UserResponseDto>
    ::routes(Arc::new(user_crud), "/api/v1/users");

Implementations

impl<S, E, C, U, R> BackboneCrudHandler<S, E, C, U, R>

where S: CrudService<E, C, U> + 'static, E: Serialize + Send + Sync + Clone + EntityRepoMeta + 'static, C: DeserializeOwned + Send + Sync + 'static, U: DeserializeOwned + Send + Sync + 'static, R: From<E> + Serialize + Send + Sync + 'static,

pub fn new(service: Arc<S>) -> Self

pub fn routes(service: Arc<S>, base_path: &str) -> Router<()>

where S: Clone,

Create Axum router with all 16 Backbone endpoints (reads + writes).

Equivalent to read_routes(...).merge(write_routes(...)). Use the split variants when reads and writes need different middleware (e.g., public reads + authenticated writes).

Routes Created

1. GET {base_path} - List with pagination
2. POST {base_path} - Create
3. GET {base_path}/:id - Get by ID
4. PUT {base_path}/:id - Full update
5. PATCH {base_path}/:id - Partial update
6. DELETE {base_path}/:id - Soft delete
7. POST {base_path}/bulk - Bulk create
8. POST {base_path}/upsert - Upsert
9. GET {base_path}/trash - List deleted (with filters)
10. POST {base_path}/:id/restore - Restore
11. DELETE {base_path}/empty - Empty trash
12. GET {base_path}/:id/deleted - Get deleted by ID
13. DELETE {base_path}/trash/:id - Permanent delete from trash
14. (Uses route 9 with filters)
15. GET {base_path}/count - Count active entities
16. GET {base_path}/trash/count - Count deleted entities

pub fn read_routes(service: Arc<S>, base_path: &str) -> Router<()>

where S: Clone,

Create Axum router with only the read (GET) endpoints.

Safe to expose publicly (e.g., for reference data like countries or categories) without auth middleware. Pair with write_routes under an auth layer when mutations must be restricted.

Routes Created

• GET {base_path} - List with pagination
• GET {base_path}/:id - Get by ID
• GET {base_path}/trash - List deleted (with filters)
• GET {base_path}/:id/deleted - Get deleted by ID
• GET {base_path}/count - Count active entities
• GET {base_path}/trash/count - Count deleted entities

pub fn write_routes(service: Arc<S>, base_path: &str) -> Router<()>

where S: Clone,

Create Axum router with only the write (mutation) endpoints.

These routes should not be publicly exposed. Wrap them with an auth middleware (see BackboneCrudHandler module docs) before nesting into the application router.

Routes Created

• POST {base_path} - Create
• POST {base_path}/bulk - Bulk create
• POST {base_path}/upsert - Upsert
• DELETE {base_path}/empty - Empty trash
• DELETE {base_path}/trash/:id - Permanent delete from trash
• PUT {base_path}/:id - Full update
• PATCH {base_path}/:id - Partial update
• DELETE {base_path}/:id - Soft delete
• POST {base_path}/:id/restore - Restore