Submit and Track Grievances
Submit and Track Grievances
Submit complaints, track resolution progress, and manage the grievance workflow from submission to closure.
Time: 5–10 minutes Module: OpenEduCat Grievance Enterprise Permissions: Grievance User, Grievance Manager, or Portal User
Prerequisites
- Student, faculty, or parent account exists
- Grievance categories configured
- Grievance teams assigned to categories
- Access to grievance menu or portal
Overview
The Grievance system provides:
- Structured complaint submission for students, faculty, and parents
- Multi-stage workflow with tracking
- Team-based assignment and resolution
- Appeal process for dissatisfied resolutions
- Portal access for real-time status tracking
Grievance Workflow
Draft → Submitted → In Review → Action → Resolve → Close ↓ Reject| State | Description |
|---|---|
| Draft | Initial creation, editable |
| Submitted | Awaiting team assignment |
| In Review | Under investigation |
| Action | Resolution being implemented |
| Resolve | Resolution provided |
| Close | Grievance completed |
| Reject | Grievance deemed invalid |
| Cancel | Withdrawn by submitter |
Steps
1. Submit via Backend (Staff)
-
Navigate to OpenEduCat → Grievances
-
Click New
-
Select Grievance By:
- Student
- Faculty
- Parent
-
Complete the required fields:
| Field | Action |
|---|---|
| Subject | Enter a clear, descriptive title |
| Category | Select the appropriate grievance category |
| Description | Provide detailed complaint information |
| Attachments | Upload supporting documents |
- For academic grievances (if category is academic):
| Field | Action |
|---|---|
| Course | Select the relevant course |
| Batch | Select the batch |
| Academic Year | Select the year |
| Academic Term | Select the term |
- Click Save (creates in Draft state)
- Click Submit to send for review
2. Submit via Student Portal
- Log in to the student portal
- Click Grievances from the home menu
- Click Add Grievance
- Fill in the grievance form:
- Subject
- Category
- Description
- Attachments (required)
- Choose:
- Save as Draft: Continue editing later
- Submit: Send for review
3. Submit via Parent Portal
- Log in to the parent portal
- Select your child (if multiple students)
- Navigate to Grievances
- Submit grievance on behalf of the student
Track Grievance Status
Via Portal
-
Navigate to My Grievances in the portal
-
View the status badge for each grievance:
- Draft: Not yet submitted
- In Progress: Under review
- Resolved: Awaiting your feedback
- Closed: Completed
-
Click on a grievance to view details
Via Backend
- Navigate to OpenEduCat → Grievances
- Use the Kanban view to see grievances grouped by state
- Click on any grievance to view full details
Respond to Resolution
When a grievance is resolved:
- Open the grievance details (portal or backend)
- Review the Action Taken section
- Provide satisfaction feedback:
- Click Satisfied to close the grievance
- Click Not Satisfied to escalate
File an Appeal
If not satisfied with the resolution:
- Click Not Satisfied
- A new grievance is created as an appeal
- The appeal links to the original grievance
- Provide additional details
- Submit for re-review
Field Reference
Grievance Model (grievance)
| Field | Technical Name | Type | Required | Description |
|---|---|---|---|---|
| Name | name | Char | Auto | Grievance ID (GRI0001) |
| Subject | subject | Char | Yes | Grievance title |
| Description | description | Text | Yes | Detailed complaint |
| Category | grievance_category_id | Many2one | Yes | Classification |
| Team | grievance_team_id | Many2one | Conditional | Handling team |
| Grievance By | grievance_for | Selection | Yes | student/faculty/parent |
| Student | student_id | Many2one | Conditional | If grievance_for=student |
| Faculty | faculty_id | Many2one | Conditional | If grievance_for=faculty |
| Parent | parent_id | Many2one | Conditional | If grievance_for=parent |
| State | state | Selection | No | Workflow state |
| Action Taken | action_taken | Text | No | Resolution details |
| Root Cause | root_cause_id | Many2one | No | Issue root cause |
| Is Satisfied | is_satisfied | Selection | No | yes/no feedback |
| Is Appeal | is_appeal | Boolean | No | Appeal flag |
| Parent Grievance | grievance_parent_id | Many2one | No | Original grievance |
Academic Context (visible when is_academic=True)
| Field | Technical Name | Type | Required |
|---|---|---|---|
| Course | course_id | Many2one | Yes |
| Batch | batch_id | Many2one | Yes |
| Academic Year | academic_year_id | Many2one | Yes |
| Academic Term | academic_term_id | Many2one | Yes |
Grievance Categories
Categories are hierarchical (Parent → Child):
| Parent Category | Child Categories |
|---|---|
| Academic | Grading, Course Content, Faculty |
| Administrative | Fees, Scheduling, Documentation |
| Facility | Classroom, Library, Labs |
| Hostel | Room, Food, Maintenance |
Only child categories can be assigned to grievances.
Email Notifications
The system sends automatic emails at key stages:
| Stage | Notification |
|---|---|
| Submitted → In Review | Team assignment email |
| In Review → Action | Action taken notification |
| Action → Resolve | Resolution notification |
| In Review → Reject | Rejection notification |
Search and Filter Options
Searchable Fields
- Subject
- Student/Faculty/Parent name
Filters
- Academic / Non-Academic
- In Review
- Closed
- Cancel
- Appeal
- In Action
Group By
- Date (created_date)
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Cannot submit grievance | Missing required fields | Complete all required fields |
| Category not available | Only parent categories exist | Create child categories |
| Team not assigned | Category has no team | Configure team for category |
| Cannot edit submitted grievance | Not in draft state | Cannot modify after submission |
| Attachments required error | No files uploaded | Upload at least one document |
Best Practices
- Clear subject: Use descriptive titles that summarize the issue
- Detailed description: Provide specific facts, dates, and names
- Attach evidence: Include relevant documents, screenshots, or records
- Select correct category: Choose the most specific applicable category
- Track regularly: Check status updates through the portal
Security Notes
| Role | Capabilities |
|---|---|
| Grievance User | Create, view, edit own grievances |
| Grievance Manager | Full access, resolve, reject grievances |
| Portal User | Submit and track own grievances |