springboot-lambda Project Structure

#	Path / File	Description	Clean	DDD	Hexagonal	CQRS	Event-Driven	Serverless
1	📁 springboot-lambda/	Project Root Directory	✓	✓	✓	✓	✓	✓
2	├── 📄 build.gradle	Gradle build script (Dependencies and Configuration)	✓					✓
3	├── 📄 settings.gradle	Gradle settings for module resolution	✓					✓
4	├── 📜 template.yaml	AWS SAM / CloudFormation template for serverless deployment						✓
5	├── 📁 src/	Source code and test directories	✓	✓	✓	✓	✓	✓
6	│ ├── 📁 main/	Main production source code	✓	✓	✓	✓	✓	✓
7	│ │ ├── 📁 java/	Java source files root	✓	✓	✓	✓	✓
8	│ │ │ └── 📁 org/ldschurch/rest_api/	Base package structure (Implied layers start here)	✓	✓	✓	✓	✓
9	│ │ │ ├── 🏢 domain/	The core business logic (DDD)	✓	✓	✓
10	│ │ │ │ ├── 👤 model/	Entities and Value Objects	✓	✓	✓
11	│ │ │ │ │ └── User.java	User Aggregate Root	✓	✓	✓
12	│ │ │ │ ├── ⚙️ service/	Domain Services	✓	✓	✓
13	│ │ │ │ │ └── BusinessRules.java	Service for complex business rules	✓	✓	✓
14	│ │ │ │ ├── 📢 event/	Domain Events structure	✓	✓	✓		✓
15	│ │ │ │ │ ├── DomainEvent.java	Base interface/class for all events	✓	✓	✓		✓
16	│ │ │ │ │ ├── UserCreatedEvent.java	Specific domain event	✓	✓	✓		✓
17	│ │ │ │ │ └── EventPublisher.java	Domain interface for event publishing	✓	✓	✓		✓
18	│ │ │ │ └── ✍️ command/handlers/	Domain logic handlers for commands	✓	✓	✓	✓
19	│ │ │ │ └── UserCommandHandler.java	Handler for processing user commands	✓	✓	✓	✓
20	│ │ │ ├── 🧩 application/	Use Cases and Application Ports	✓		✓	✓	✓
21	│ │ │ │ ├── 📩 command/	Command DTOs (Write side data)	✓		✓	✓
22	│ │ │ │ │ ├── CreateUserCommand.java	DTO for user creation	✓		✓	✓
23	│ │ │ │ │ ├── UpdateUserCommand.java	DTO for user update	✓		✓	✓
24	│ │ │ │ │ ├── DeleteUserCommand.java	DTO for user deletion	✓		✓	✓
25	│ │ │ │ │ └── CommandHandler.java	Base command handler interface	✓		✓	✓
26	│ │ │ │ ├── ❓ query/	Query DTOs (Read side data)	✓		✓	✓
27	│ │ │ │ │ ├── GetUserQuery.java	DTO for retrieving a single user	✓		✓	✓
28	│ │ │ │ │ ├── ListUsersQuery.java	DTO for retrieving a list of users	✓		✓	✓
29	│ │ │ │ │ └── QueryHandler.java	Base query handler interface	✓		✓	✓
30	│ │ │ │ ├── ➡️ port/	Boundary interfaces (Ports)	✓	✓	✓	✓	✓
31	│ │ │ │ │ ├── input/	Primary/Driving Ports (APIs exposed by the application)	✓		✓	✓	✓
32	│ │ │ │ │ │ ├── CommandUseCase.java	Interface for use cases that modify data	✓		✓	✓
33	│ │ │ │ │ │ ├── QueryUseCase.java	Interface for use cases that retrieve data	✓		✓	✓
34	│ │ │ │ │ │ └── EventHandlerUseCase.java	Interface for use cases responding to events	✓		✓	✓	✓
35	│ │ │ │ │ └── ⬅️ output/	Secondary/Driven Ports (Dependencies of the application)	✓	✓	✓	✓	✓
36	│ │ │ │ │ ├── UserWriteRepositoryPort.java	Port for writing to the command-side database	✓	✓	✓	✓
37	│ │ │ │ │ ├── UserReadRepositoryPort.java	Port for reading from the query-side database	✓	✓	✓	✓
38	│ │ │ │ │ └── EventPublisherPort.java	Port for notifying external systems of events	✓	✓	✓		✓
39	│ │ │ │ └── ✅ service/	Implementations of the Use Cases (Business workflows)	✓		✓	✓	✓
40	│ │ │ │ ├── command/CreateUserService.java	Implements user creation workflow (Command)	✓		✓	✓
41	│ │ │ │ ├── command/UpdateUserService.java	Implements user update workflow (Command)	✓		✓	✓
42	│ │ │ │ ├── command/DeleteUserService.java	Implements user deletion workflow (Command)	✓		✓	✓
43	│ │ │ │ ├── query/GetUserService.java	Implements single user retrieval workflow (Query)	✓		✓	✓
44	│ │ │ │ └── query/ListUsersService.java	Implements list retrieval workflow (Query)	✓		✓	✓
45	│ │ │ │ └── EventDrivenService.java	Service handling event responses/reactions	✓		✓		✓
46	│ │ │ ├── 🔌 adapter/	External infrastructure implementations (Adapters)	✓	✓	✓	✓	✓	✓
47	│ │ │ │ ├── 🌐 rest/	REST API Adapters (Inbound/Driving)	✓		✓	✓
48	│ │ │ │ │ ├── command/UserCommandController.java	Spring Controller for commands (POST, PUT, DELETE)	✓		✓	✓
49	│ │ │ │ │ └── command/HealthCheckController.java	Controller for application health check endpoint	✓		✓
50	│ │ │ │ │ └── query/UserQueryController.java	Spring Controller for queries (GET)	✓		✓	✓
51	│ │ │ │ ├── 💾 persistence/	Database Adapters (Outbound/Driven)	✓	✓	✓	✓
52	│ │ │ │ │ ├── read/JpaUserReadRepositoryAdapter.java	JPA implementation for UserReadRepositoryPort (Query side)	✓	✓	✓	✓
53	│ │ │ │ │ └── write/JpaUserWriteRepositoryAdapter.java	JPA implementation for UserWriteRepositoryPort (Command side)	✓	✓	✓	✓
54	│ │ │ │ ├── λ lambda/	Serverless Lambda Handlers (Inbound/Driving)	✓		✓	✓		✓
55	│ │ │ │ │ ├── CommandLambdaHandler.java	AWS Lambda entry point for command events (e.g., API Gateway POST)	✓		✓	✓		✓
56	│ │ │ │ │ └── QueryLambdaHandler.java	AWS Lambda entry point for query events (e.g., API Gateway GET)	✓		✓	✓		✓
57	│ │ │ │ ├── 💬 events/	Event System Adapters (Inbound/Outbound)	✓	✓	✓		✓	✓
58	│ │ │ │ │ ├── KafkaEventPublisherAdapter.java	Adapter to publish events to Kafka	✓	✓	✓		✓
59	│ │ │ │ │ ├── SnsEventPublisherAdapter.java	Adapter to publish events to AWS SNS	✓	✓	✓		✓	✓
60	│ │ │ │ │ ├── SqsEventListener.java	Adapter to consume events from AWS SQS	✓	✓	✓		✓	✓
61	│ │ │ │ │ └── EventDeserializer.java	Utility for deserializing incoming event payloads	✓		✓		✓
62	│ │ │ │ └── 💉 config/	Spring Dependency Injection Configuration	✓		✓
63	│ │ │ │ ├── BeanConfig.java	General Spring `@Configuration` for use cases/ports	✓		✓
64	│ │ │ │ ├── KafkaConfig.java	Configuration for Kafka connections	✓		✓		✓
65	│ │ │ │ ├── SnsConfig.java	Configuration for AWS SNS connections	✓		✓		✓	✓
66	│ │ │ │ └── SqsConfig.java	Configuration for AWS SQS connections	✓		✓		✓	✓
67	│ │ │ ├── 🏗️ infrastructure/	Cross-Cutting Concerns and shared utilities	✓		✓
68	│ │ │ │ ├── 🪞 tracing/LoggingAspect.java	AOP component for logging/tracing	✓		✓
69	│ │ │ │ │ └── TracingInterceptor.java	Interceptor for distributed tracing context	✓		✓
70	│ │ │ │ ├── 🛑 exception/GlobalExceptionHandler.java	Centralized error handling for APIs/Lambdas	✓		✓
71	│ │ │ │ └── 📊 metrics/MetricsCollector.java	Utility for application performance monitoring	✓		✓
72	│ │ │ └── 🚀 SpringbootLambdaApplication.java	Main Spring Boot entry point and configuration starter	✓					✓
73	│ │ └── 📁 resources/	Configuration and static content	✓					✓
74	│ │ ├── ⚙️ application.yml	Primary Spring Boot configuration file	✓					✓
75	│ │ ├── 📄 logback-spring.xml	Configuration file for logging framework	✓					✓
76	│ │ └── 📂 static/	Static web content directory	✓					✓
77	│ └── 🧪 test/	Test source root	✓					✓
78	│ └── 📁 java/.../application/command/	Unit tests for Application Command Services	✓		✓	✓
79	│ └── CreateUserServiceTest.java	Unit test for CreateUserService	✓		✓	✓
80	│ └── 📁 java/.../adapter/persistence/write/	Integration tests for Write Adapters	✓	✓	✓	✓
81	│ └── JpaUserWriteRepositoryAdapterTest.java	Test for the JPA implementation of the write port	✓	✓	✓	✓
82	│ └── events/KafkaEventPublisherAdapterTest.java	Test for Kafka event publishing functionality	✓	✓	✓		✓
83	└── 📁 build/distributions/	Generated build artifacts	✓					✓
84	└── springboot-lambda-0.0.1-SNAPSHOT.zip	Final deployable package (for Lambda)	✓					✓

springboot-lambda Project Structure - Full Architectural Hierarchy (Complete) 🚀