How williamniemiec/nforum-web works
Main Components
a) Client Layer:
• Web Browser
• JSP Views (located in /src/main/webapp/WEB-INF/views)
• Static Assets (CSS, JavaScript, Images in /src/main/webapp/assets)
b) Application Layer:
• Controllers Package (/controllers)
• Services Package (/services)
• DTOs Package (/dto)
• Repositories Package (/repositories)
c) Data Layer:
• PostgreSQL Database
• Database Configuration (/config)
Component Relationships
[Client Browser] ←→ [JSP Views]
• ↑↓
[Controllers (Servlets)]
• ↑↓
[Services Layer]
• ↑↓
[DTOs] ←→ [Repositories]
• ↑↓
[Database Config]
• ↑↓
[PostgreSQL Database]
Specific Implementation Details
• Rectangles: Core components (Controllers, Services, Repositories)
• Rounded rectangles: UI components
• Hexagons: DTOs and Config classes
Component Details
Controllers:
• AuthController
• HomeController
• TopicController
• RankingController
• SignInController
• SignUpController
Services:
• AuthService
• CommentService
• TopicService
• UserAccountService
Repositories:
• CommentRepository
• TopicRepository
• UserAccountRepository
Views:
• TopicsPage
• TopicPage
• SignInPage
• SignUpPage
• RankingPage
Additional Elements
Supporting components:
• ViewLoader (core package)
• Exception handling
• Database configuration variants (Local/Production)
Important Architectural Notes
• MVC pattern implementation
• Separation between presentation (JSP), business logic (Services), and data access (Repositories)
• Database schema connection as shown in the README
• Authentication flow separately
• Where Selenium tests interface with the system