Skip to content

zahidmgsk/GGC_Portal_2026

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KN Gohar Green City (GGC) Residents Portal

🏡

Your Smart Residents Portal


📥 Download Application

To get started, download the latest version of the app directly from the link below:

Download APK

🕰 Older Versions

Access previous releases and change logs on the GitHub Releases page.


🌟 Key Benefits

  • Instant Communication: Receive real-time notifications about maintenance, water supply, and society announcements.
  • Efficient Complaint Management: Lodge complaints in seconds and track their status from "Pending" to "Resolved" without visiting the office.
  • Transparency: Clear visibility of water supply schedules and official society notices.
  • Privacy & Security: Secure login system with dedicated roles for Residents, Admins, and Super Admins.
  • Feedback Loop: Rate the resolution of your complaints to help management improve services.

🚀 Main Features

👤 User Roles

  • Resident: Can lodge complaints, track history, view water schedules, and react to announcements.
  • Admin: Manages complaints, schedules water supply, posts announcements, and approves new users.
  • Super Admin: Full control over the system, including managing other admins and high-level settings.

📋 Feature Modules

  1. Notification Center: A dedicated hub for personal and society-wide alerts. Includes high-priority "Maintenance Due" alerts that stay visible until acknowledged.
  2. Complaint Portal:
    • Categorized complaint lodging (Maintenance, Water, Security, etc.).
    • Unique reference numbers for tracking.
    • Interactive rating system for resolved complaints.
  3. Water Supply Schedule:
    • List view of upcoming supply timings.
    • Integrated Calendar View to check schedules for the entire month.
  4. Society Announcements:
    • Official updates with "Reaction" support (👍, ❤️, 😂).
    • Easy sharing of announcements to other platforms (WhatsApp, Email, etc.).
  5. Admin Dashboard:
    • User approval system to prevent unauthorized access.
    • Database export (CSV) for record-keeping.
    • Admin management for the Super Admin.

📖 User Guide

1. Getting Started

  • Welcome Screen: Tap "Enter Portal" to begin.
  • Registration: New residents must register with their Name, Phone Number, CNIC, and House Number.
  • Approval: After registration, your account will be "Pending Approval." An admin will verify your details to grant access.

2. Logging In

  • Resident: Use your House Number and Phone Number.
  • Options:
    • Remember House Number: Saves your ID for the next time.
    • Keep me logged in: Skips the login screen on future app opens.
    • Password Toggle: Tap the "eye" icon to show/hide your password.

3. Using the App

  • Bottom Navigation: Easily switch between Notifications, Complaints, Water, and Announcements.
  • Theming: Tap the palette icon in the top bar to switch between Light, Dark, and various color themes.
  • Logout: Use the red Logout button in the top bar to securely exit your session.

🛠 Tech Stack

  • Platform: Android
  • UI Framework: Jetpack Compose (Modern Declarative UI)
  • Database: Firebase Realtime Database
  • Architecture: MVVM (Model-View-ViewModel)
  • Languages: Kotlin

👨‍💻 Development

Developed with ❤️ by Zahid Choudhry. Version: 1.1.0


Note: This app is specifically tailored for the residents and management of KN Gohar Green City.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors