How shivareddy58/complaint-grievance-management-portal-java-full-stack works
This is a web portal for submitting grievances and managing them through review, assignment, status changes, and resolution. Users submit complaints and can follow them, add attachments, and provide feedback; officers and administrators manage complaints, while administrators also oversee accounts and reporting. Supporting capabilities include notifications and email, audit records, file storage, and PDF generation. The excerpts show several controller-to-service calls and selected persistence operations; links for unsampled subsystems are kept broad or omitted where their wiring is not established.
Main entry points: UserService.java Account service · AdminController.java Admin portal · ComplaintService.java Complaint workflow · UserController.java User portal
Components 22
Accounts and access
- Account service
grievance-management-portal/src/main/java/com/grievance/portal/service/UserService.java - Public pages
grievance-management-portal/src/main/java/com/grievance/portal/controller/PublicController.java - Password reset
grievance-management-portal/src/main/java/com/grievance/portal/controller/ForgotResetController.java - Profile management
grievance-management-portal/src/main/java/com/grievance/portal/controller/ProfileController.java
Complaint workflow
- User portal
grievance-management-portal/src/main/java/com/grievance/portal/controller/UserController.java - Officer portal
grievance-management-portal/src/main/java/com/grievance/portal/controller/OfficerController.java - Admin portal
grievance-management-portal/src/main/java/com/grievance/portal/controller/AdminController.java - Complaint workflow
grievance-management-portal/src/main/java/com/grievance/portal/service/ComplaintService.java - Category service
grievance-management-portal/src/main/java/com/grievance/portal/service/CategoryService.java
Supporting services
- Attachment storage
grievance-management-portal/src/main/java/com/grievance/portal/service/StorageService.java - Uploaded files
- Notifications
grievance-management-portal/src/main/java/com/grievance/portal/controller/NotificationController.java - Notification service
grievance-management-portal/src/main/java/com/grievance/portal/service/NotificationService.java - Email service
grievance-management-portal/src/main/java/com/grievance/portal/service/EmailService.java
Records and reporting
- Audit logging
grievance-management-portal/src/main/java/com/grievance/portal/service/AuditLogService.java - Reports
grievance-management-portal/src/main/java/com/grievance/portal/controller/ReportController.java - PDF generation
grievance-management-portal/src/main/java/com/grievance/portal/service/PdfGeneratorService.java - Portal records
grievance-management-portal/src/main/java/com/grievance/portal/repository - Complaint queries
grievance-management-portal/src/main/java/com/grievance/portal/repository/ComplaintRepository.java
Other components
- Portal user
- Portal staff
- Mail provider
Connections 28
- Portal user → User portal: uses
- Portal staff → Officer portal: manages
- Portal staff → Admin portal: administers
- User portal → Complaint workflow: submits and tracks
- User portal → Category service: loads categories
- User portal → Attachment storage: handles attachments
- Officer portal → Complaint workflow: updates complaints
- Officer portal → Attachment storage: handles evidence
- Officer portal → Audit logging: logs actions
- Admin portal → Complaint workflow: manages complaints
- Admin portal → Account service: manages accounts
- Admin portal → Attachment storage: manages attachments
- Admin portal → Audit logging: logs actions
- Public pages → Account service: account actions
- Password reset → Account service: resets password
- Profile management → Account service: updates profile
- Complaint workflow → Complaint queries: queries and saves
- Complaint queries → Portal records: reads and writes
- Account service → Portal records: persists accounts
- Attachment storage → Uploaded files: stores files
- Complaint workflow → Email service: sends notices
- Account service → Email service: sends account mail
- Email service → Mail provider: delivers email
- Notifications → Notification service: manages notices
- Reports → PDF generation: generates reports
- Reports → Complaint queries: queries complaints
- Reports → Portal records: queries records
- Audit logging → Portal records: stores audit records