Refactor code structure for improved readability and maintainability

Author: nim444

.docs/diagram.png

@@ -18,6 +18,13 @@ This project serves as a template or starting point for building secure and scal
 * **Modern Tooling:** Utilizes `uv` for dependency management, `Dynaconf` for configuration, and `ruff` for linting/formatting.
 * **Testability:** Designed with dependency injection and includes a comprehensive test suite using `pytest`.
 
+
+## User Interface
+
+Below is a preview of the application's interface:
+
+![User Interface](.docs/interface.png)
+
 ## Highlights
 
 * JWT-based authentication (login, refresh tokens).
@@ -30,6 +37,13 @@ This project serves as a template or starting point for building secure and scal
 * Comprehensive test suite with `pytest` (including coverage).
 * Health check endpoint (`/health`).
 
+
+## Architecture Diagram
+
+Below is an overview of the application's architecture:
+
+![Architecture Diagram](.docs/diagram.png)
+
 ## Technology Stack
 
 * **Python:** >= 3.13