6.2 KiB
6.2 KiB
Project Structure Overview
runtime-smoke-20260710143823/
├── src/
│ ├── main/
│ │ ├── java/com/example/demo/
│ │ │ ├── DemoApplication.java
│ │ │ ├── controller/
│ │ │ │ ├── HealthController.java
│ │ │ │ └── UserController.java
│ │ │ ├── service/
│ │ │ │ ├── UserService.java
│ │ │ │ └── impl/
│ │ │ │ └── UserServiceImpl.java
│ │ │ ├── repository/
│ │ │ │ └── UserRepository.java
│ │ │ ├── entity/
│ │ │ │ └── User.java
│ │ │ ├── dto/
│ │ │ │ ├── UserDto.java
│ │ │ │ └── ApiResponse.java
│ │ │ └── exception/
│ │ │ ├── GlobalExceptionHandler.java
│ │ │ └── UserNotFoundException.java
│ │ └── resources/
│ │ ├── application.yml
│ │ ├── application-dev.yml
│ │ ├── application-prod.yml
│ │ ├── schema.sql
│ │ ├── data.sql
│ │ ├── static/
│ │ └── templates/
│ └── test/
│ ├── java/com/example/demo/
│ │ ├── DemoApplicationTests.java
│ │ ├── service/
│ │ │ └── UserServiceTest.java
│ │ └── controller/
│ │ └── UserControllerTest.java
│ └── resources/
│ └── application.yml
├── pom.xml
├── mvnw
├── mvnw.cmd
├── Dockerfile
├── docker-compose.yml
├── .github/
│ └── workflows/
│ └── ci.yml
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
└── source-inventory/
├── INVENTORY.md
└── STRUCTURE.md
Architecture Diagram
┌─────────────────────────────────────────────────────────────┐
│ Client Request │
└─────────────────────────┬───────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Controller Layer │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │HealthController │ │ UserController │ │
│ └─────────────────┘ └─────────────────┘ │
└─────────────────────────┬───────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Service Layer │
│ ┌─────────────────────────────────────────┐ │
│ │ UserServiceImpl │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────┬───────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Repository Layer │
│ ┌─────────────────────────────────────────┐ │
│ │ UserRepository (JPA) │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────┬───────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Database (H2/MySQL) │
│ ┌─────────────────────────────────────────┐ │
│ │ User Table │ │
│ └─────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Technology Stack
| Layer | Technology |
|---|---|
| Runtime | Java 17 |
| Framework | Spring Boot 3.x |
| Database | H2 (dev), MySQL/PostgreSQL (prod) |
| ORM | Spring Data JPA / Hibernate |
| Build | Maven |
| Testing | JUnit 5, Mockito |
| Container | Docker |
| CI/CD | GitHub Actions |