How tomfregonese/le-livre-dont-vous-etes-le-heros works
Project type and purpose
• This is a three-module Java backend application using Maven and Spring Boot.
• It follows a clean/hexagonal (ports and adapters) style:
• narraty-web-api: HTTP entry point (controllers, filters, security, Swagger)
• narraty-core: domain, DTOs, use-cases (application/business logic), ports (interfaces)
• narraty-infrastructure: adapters (JPA entities, Spring Data repositories, service implementations)
• It implements “Le livre dont vous êtes le héros” – an interactive story engine with tales, scenes, choices and user sessions.
File structure
• Top‐level modules:
• narraty-web-api (presentation layer)
• narraty-core (application + domain layer)
• narraty-infrastructure (infrastructure layer)
• Core patterns:
• DTOsCore, exceptions, interfaces (ports), models (domain entities), usecases (application services), validators
• Infrastructure provides repository adapters and service implementations for the core ports
• Web-API contains REST controllers, request/response DTOs, security config, authentication filter, Swagger
README insights
• We derive architecture solely from file organization and naming.