Citizen Services

This module handles all interactions between management and residents, including house activation requests, complaints, and complaint tasks.

1. House Activation Requests

Overview

When residents register for the first time, they must request activation to link their account to a physical house unit. This prevents unauthorized access and ensures data integrity.

Accessing House Activation Requests

1. Navigate to House Requests from the sidebar

Interface Components

Main Table

Displays all activation requests with columns:

• Request ID: Unique identifier
• Resident Name: Who is requesting
• Email: Resident's email
• House: Requested house (Complex - Block - Number)
• Request Date: When request was submitted
• Status: Pending, Approved, Rejected
• Actions: View Details, Approve, Reject

Filter Options

• Status: Filter by Pending/Approved/Rejected
• Date Range: Filter by request date
• Complex/Block: Filter by location

Step-by-Step: Reviewing an Activation Request

Step 1: Access Request Details

1. Locate the pending request in the table
2. Click View Details icon (eye icon)
3. Detail modal opens showing:
   • Resident information (name, email, phone)
   • Requested house details
   • Proof of ownership (if uploaded)
   • Request date and time
   • Any notes from resident

Step 2: Verify Information

1. Check Resident Identity:
   • Verify name matches ID/documents
   • Check email is valid
   • Confirm phone number
2. Verify House Ownership:
   • Check if house is available (not already claimed)
   • Review proof of ownership documents
   • Confirm house number is correct
3. Check for Duplicates:
   • Ensure resident doesn't already have another house
   • Verify house isn't already activated for someone else

Step 3: Make Decision

To Approve:

1. Click Approve button
2. Confirmation dialog appears
3. Optionally add a welcome note
4. Click Confirm Approval

Expected Result:

• Request status changes to "Approved"
• Resident is automatically linked to the house
• Resident receives email notification
• Resident can now access full system features
• House status updates to "Occupied"

To Reject:

1. Click Reject button
2. Rejection reason dialog appears
3. Enter reason (required):
   • Example: "Proof of ownership insufficient"
   • Example: "House already occupied"
   • Example: "Incorrect house number"
4. Click Confirm Rejection

Expected Result:

• Request status changes to "Rejected"
• Resident receives email with rejection reason
• Resident can submit a new request with corrections
• House remains available

Step-by-Step: Bulk Processing Requests

If you have multiple requests to process:

1. Filter for Pending requests
2. Sort by date (oldest first recommended)
3. Review each request systematically
4. Use keyboard shortcuts for faster processing:
   • Tab: Move to next request
   • Enter: Open details
   • A: Approve (if shortcut enabled)
   • R: Reject (if shortcut enabled)

Common Scenarios

Scenario 1: New Resident Moving In

• Resident registers online
• Submits activation request with KTP/deed
• Admin verifies and approves
• Resident gains immediate access

Scenario 2: Ownership Transfer

• Previous owner's account is deactivated
• New owner registers and requests activation
• Admin verifies transfer documents
• Approves new owner, house transfers

Scenario 3: Renter Requesting Access

• Renter submits request
• Admin checks with owner
• If owner confirms, approve with "Renter" note
• Set house status to "Rented"

Scenario 4: Duplicate/Fraudulent Request

• Admin notices suspicious request
• Checks if house already has active resident
• Rejects with clear reason
• May flag for further investigation

---

2. Complaints Management

Overview

Residents can submit complaints about issues in the complex (security, cleanliness, facilities, etc.). Admins manage these complaints through their lifecycle.

Accessing Complaints

1. Navigate to Complaints from the sidebar

Interface Components

Main Table

• Complaint ID: Unique number
• Date: When submitted
• Resident: Who submitted
• House: Resident's house
• Category: Type of complaint
• Subject: Brief description
• Priority: Low, Medium, High, Critical
• Status: Pending, In Progress, Resolved, Rejected
• Assigned To: Staff member handling it
• Actions: View, Edit Status, Add Note, Delete

Filter Panel

• Status: Filter by status
• Category: Filter by type
• Priority: Filter by urgency
• Date Range: Filter by submission date
• Block: Filter by location

Action Buttons

• Export: Download complaint report
• Statistics: View complaint analytics
• Categories: Manage complaint categories

Complaint Categories

Common categories include:

• Security: Guards, gates, CCTV issues
• Cleanliness: Trash, common areas
• Facilities: Pool, gym, playground
• Maintenance: Roads, lights, drainage
• Noise: Disturbance complaints
• Parking: Parking violations
• Other: Miscellaneous issues

Complaint Statuses

• Pending: Just submitted, not yet reviewed
• In Progress: Being worked on
• Resolved: Issue fixed
• Rejected: Not valid or out of scope

Priority Levels

• Low: Minor issues, no urgency
• Medium: Normal issues, handle soon
• High: Important, needs quick attention
• Critical: Emergency, immediate action required

Step-by-Step: Reviewing a New Complaint

Step 1: Open Complaint Details

1. Locate the complaint in the table
2. Click View icon or complaint ID
3. Detail page opens showing:
   • Full complaint description
   • Photos/attachments (if any)
   • Resident contact information
   • Location details
   • Submission timestamp
   • History of status changes

Step 2: Assess the Complaint

1. Read Description: Understand the issue
2. View Photos: Check visual evidence
3. Check Location: Identify where the issue is
4. Determine Priority: Assess urgency
5. Categorize: Ensure correct category

Step 3: Take Initial Action

Option A: Assign to Staff

1. Click Assign button
2. Select staff member from dropdown
3. Add assignment note
4. Click Assign

Option B: Change Status

1. Click Change Status button
2. Select new status:
   • In Progress: If you're starting to work on it
   • Rejected: If complaint is invalid
3. Add status note (required)
4. Click Update

Option C: Change Priority

1. Click Priority dropdown
2. Select appropriate level
3. Confirmation appears
4. Click Confirm

Option D: Change Category

1. Click Category dropdown
2. Select correct category
3. Click Update

Step 4: Add Internal Notes

1. Scroll to Notes section
2. Click Add Note button
3. Type your note:
   • Example: "Contacted security, will check CCTV"
   • Example: "Scheduled maintenance for tomorrow"
4. Select note visibility:
   • Internal Only: Only admins can see
   • Visible to Resident: Resident can see
5. Click Save Note

Step-by-Step: Resolving a Complaint

Step 1: Complete the Work

• Fix the issue or coordinate with relevant parties
• Document actions taken
• Collect proof (photos, receipts, etc.)

Step 2: Update Complaint

1. Open the complaint
2. Click Resolve button
3. Resolution form appears:
   • Resolution Description (required): Explain what was done
   • Upload Proof: Photos of completed work
   • Completion Date: When work finished
4. Fill in all fields
5. Click Mark as Resolved

Step 3: Notify Resident

• System automatically sends email to resident
• Resident can view resolution details
• Resident can provide feedback

Step-by-Step: Rejecting a Complaint

Use this when complaint is:

• Duplicate
• Outside scope of management
• Not valid
• Resident's personal issue

1. Open the complaint
2. Click Reject button
3. Rejection form appears:
   • Reason (required): Clear explanation
   • Example: "This is a personal dispute between neighbors, not a management issue"
   • Example: "Duplicate of complaint #123"
4. Click Confirm Rejection

Expected Result:

• Status changes to "Rejected"
• Resident receives notification with reason
• Complaint removed from active queue

Step-by-Step: Creating a Complaint Task

For complex complaints requiring multiple steps or staff:

1. Open the complaint
2. Click Create Task button
3. Task creation form opens:
   • Task Title: Brief description
   • Description: Detailed work plan
   • Assign To: Select staff members
   • Priority: Set urgency
   • Deadline: Set completion date
   • Checklist: Add subtasks
4. Click Create Task

Expected Result:

• Task is created and linked to complaint
• Assigned staff receives notification
• Complaint status changes to "In Progress"
• Task appears in Complaint Tasks module

---

3. Complaint Tasks

Overview

Complaint Tasks are structured work items for handling complex complaints. They allow breaking down work into steps, assigning multiple people, and tracking progress.

Accessing Complaint Tasks

1. Navigate to Complaint Tasks from sidebar

Interface Components

Main Table

• Task ID: Unique identifier
• Title: Task name
• Related Complaints: Linked complaints
• Assigned To: Staff members
• Priority: Urgency level
• Status: Not Started, In Progress, Completed, Cancelled
• Progress: Percentage complete
• Deadline: Due date
• Actions: View, Update, Complete

Task Statuses

• Not Started: Created but not begun
• In Progress: Work underway
• Completed: All work done
• Cancelled: Task cancelled

Step-by-Step: Working on a Task

Step 1: Open Task Details

1. Click on task ID or View icon
2. Task detail page shows:
   • Task information
   • Linked complaints
   • Assigned staff
   • Checklist of subtasks
   • Progress tracker
   • Activity log
   • Evidence/attachments

Step 2: Update Progress

1. Scroll to Checklist section
2. Check off completed items:
   • Click checkbox next to each subtask
   • Subtask marks as complete
   • Overall progress percentage updates
3. Add notes for each completed item

Step 3: Upload Evidence

1. Click Upload Evidence button
2. Select file (photo, document, etc.)
3. Add description:
   • Example: "Photo of repaired fence"
   • Example: "Invoice for materials"
4. Click Upload

Expected Result:

• File uploads and appears in evidence list
• Timestamp and uploader recorded
• Available for review

Step 4: Update Status

1. Click Update Status button
2. Select new status:
   • In Progress: When starting work
   • Completed: When all work done
3. Add status note
4. Click Update

Step 5: Complete Task

When all work is finished:

1. Ensure all checklist items are complete
2. All evidence uploaded
3. Click Complete Task button
4. Completion form appears:
   • Summary: Describe what was accomplished
   • Final Evidence: Upload final photos
   • Completion Date: Confirm date
5. Click Mark Complete

Expected Result:

• Task status changes to "Completed"
• Linked complaints can be resolved
• Staff receives completion notification
• Task archived

Step-by-Step: Adding Complaints to Task

If additional related complaints come in:

1. Open the task
2. Click Add Complaints button
3. Search for complaints
4. Select complaints to add
5. Click Add Selected

Expected Result:

• Complaints linked to task
• Task scope expands
• Progress may adjust

Common Scenarios

Scenario 1: Multi-Step Repair

• Create task with checklist:
  • Assess damage
  • Order materials
  • Schedule contractor
  • Perform repair
  • Inspect quality
• Update progress as each step completes

Scenario 2: Multiple Staff Coordination

• Assign task to multiple staff
• Each uploads their evidence
• Coordinator tracks overall progress
• Complete when all parts done

Scenario 3: Recurring Maintenance

• Create template task
• Duplicate for each occurrence
• Track pattern over time

---

Common Workflows

Workflow 1: Simple Complaint Resolution

1. Resident submits complaint
2. Admin reviews and categorizes
3. Admin or staff fixes issue
4. Admin marks as resolved
5. Resident receives notification

Workflow 2: Complex Issue Requiring Task

1. Resident submits complaint
2. Admin creates task from complaint
3. Task assigned to staff
4. Staff works through checklist
5. Staff uploads evidence
6. Admin reviews and completes task
7. Complaint marked as resolved

Workflow 3: Escalation

1. Complaint submitted as Low priority
2. Issue worsens or repeats
3. Admin escalates to High priority
4. Creates task for urgent handling
5. Assigns senior staff
6. Expedited resolution

---

Tips & Best Practices

For House Activation

• Review requests daily to avoid delays
• Always verify ownership documents
• Keep rejection reasons professional and clear
• Welcome new residents with a friendly note

For Complaints

• Respond to complaints within 24 hours
• Keep residents informed of progress
• Use internal notes for coordination
• Upload evidence of completed work
• Follow up after resolution

For Tasks

• Break complex work into clear steps
• Set realistic deadlines
• Assign appropriate staff
• Update progress regularly
• Document everything with photos

---

Troubleshooting

Problem: Cannot approve activation request

• Solution: Check if house is already occupied or if resident already has another house

Problem: Complaint photos won't upload

• Solution: Check file size (max 5MB per file), ensure format is JPG/PNG/PDF

Problem: Cannot change complaint status

• Solution: Ensure you have proper permissions, check if complaint is locked

Problem: Task progress not updating

• Solution: Refresh page, ensure checklist items are being saved

Problem: Resident says they didn't receive notification

• Solution: Check email address is correct, check spam folder, resend notification

---

Keyboard Shortcuts

• N: New complaint/task
• F: Focus filter
• R: Refresh list
• Esc: Close modal
• Ctrl/Cmd + Enter: Submit form

---

Reporting

Complaint Statistics

Access via Statistics button to see:

• Total complaints by status
• Complaints by category
• Average resolution time
• Complaints by block
• Trend over time

Export Options

• Excel: Full data export
• PDF: Formatted report
• CSV: For analysis

Use filters before exporting to get specific data.