File Structure

As mentioned in the introduction, Sword suggests a development structure based on modules.

A module is an organizational unit that groups together related code, such as controllers, services, repositories, and entities. This allows for a clear separation of concerns and facilitates project scalability.

module_name
├── controller.rs   # Presentation layer and adapters.
├── dtos.rs         # Input/output schemas and validation.
├── entity.rs       # Domain layer (entities and business models).
├── mod.rs          # Module entry point (definitions and re-exports).
├── repository.rs   # Persistence layer (data access).
└── service.rs      # Business logic layer.

You have likely seen or used a similar architecture in frameworks like Spring (Java) or NestJS (Node.js). Sword takes heavy inspiration from the latter.

Of course, this structure is only a guide. In fact, it is highly likely you will need to add additional files, such as:

• errors.rs to define module- or domain-specific errors.
• mappers.rs to define mapping functions between entities and DTOs.