How asmaekarmouchi/e-syndic-web-platform works
Project Type and Purpose
• This is a full-stack Java EE web application for managing condominium (“syndic”) operations.
• Purpose: Provide role-based access (Admin, Syndic, Member) to handle payments, charges, incidents, meetings, notifications, reports, and regulatory compliance.
Main Components
a. Presentation Layer
• JSP pages (src/main/webapp/*.jsp) & static assets (CSS, JS, images)
• Templates for navigation per role (admin_sidenav.jsp, member_sidenav.jsp, syndic_sidenav.jsp)
b. Controller Layer
• Servlets (com.syndic.servlet.*) handle HTTP requests, route to services/DAOs, forward to JSPs
c. Business/Service Layer
• NotificationService & Mail class for email alerts (com.syndic.mail)
• Potential place for additional services if logic grows
d. Data Access Layer
• DAO interfaces (com.syndic.dao.*DAO) and implementations (…DAOImpl)
• AbstractDAOA base class, Syndic_con for JDBC connection pooling/config
e. Domain Model
• JavaBeans representing entities (Account, Charge, Expense, Incident, Meeting, Member, News, Payment, PaymentFlow, Reclamation, Supplier, Syndic, Task, User)
f. Persistence
• MySQL database (referenced in context.xml & kubernetes/mysql-deployment.yaml)
g. Infrastructure & Deployment
• Dockerfile + docker-compose.yml for local containers (Tomcat + MySQL)
• Kubernetes manifests for production (kubernetes/mysql-deployment.yaml, tomcat-deployment.yaml)
h. Continuous Integration/Deployment
• GitHub Actions workflow ( .github/workflows/deploy.yaml )
Relationships and Interactions
• Browser → HTTP request → Tomcat (Docker/K8s)
• Tomcat loads Servlets → invokes DAO layer → executes SQL on MySQL → returns domain objects
• Servlets forward the results to JSPs for rendering
• NotificationService triggers Mail class → SMTP server (configured via email.properties)
• GitHub Actions pushes new Docker images → deployed via Kubernetes
Architectural Patterns & Principles
• Model-View-Controller (MVC):
• View = JSPs/CSS/JS
• Controller = Servlets
• Model = JavaBeans + DAO layer
• DAO pattern for persistence abstraction
• Java EE/Servlet container architecture
• Containerization and orchestration for portability & scalability