Skip to content

Suraj9075/society-management-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 

Repository files navigation

🏒 Society Management System

A role-based Society Management System built using Django.
This application allows Admin, Owner, and Tenant users to manage societies, flats, and bills efficiently with secure role-based access.


πŸš€ Features

πŸ” Authentication & Authorization

  • Custom User model with role-based access:
    • ADMIN
    • OWNER
    • TENANT
  • Only active users can log in
  • Separate dashboards for each role

πŸ‘‘ Admin Capabilities

  • Access Admin Dashboard
  • Create Owner accounts
  • Create Society
  • Create Flats
  • Create Bills

🏠 Owner Capabilities

  • Access Owner Dashboard
  • View assigned flats
  • View bills
  • Edit bill payment information (update paid status)

🏒 Tenant Capabilities

  • Access Tenant Dashboard
  • View assigned flat
  • View bills

πŸ› οΈ Tech Stack

  • Backend: Django 4.2
  • Language: Python 3.8+
  • Database: SQLite
  • Frontend: HTML, CSS

πŸ“‚ Project Structure

Society Management System/

β”‚

β”œβ”€β”€ core/ β”‚ β”œβ”€β”€ models.py β”‚ β”œβ”€β”€ views.py β”‚ β”œβ”€β”€ urls.py

β”‚

β”œβ”€β”€ society_management/ β”‚ β”œβ”€β”€ settings.py

β”‚

β”œβ”€β”€ templates/ β”œβ”€β”€ static/ β”œβ”€β”€ manage.py


βš™οΈ Installation & Setup

1️⃣ Clone the Repository

git clone

cd Society Management System

2️⃣ Install Django

pip install django

3️⃣ Apply Database Migrations

python manage.py makemigrations

python manage.py migrate

4️⃣ Run the Development Server

python manage.py runserver

Open in browser:

http://127.0.0.1:8000/

πŸ” Default Login Credentials Admin

Username: admin Password: 1234 Role: ADMIN

Owner

Username: owner Password: 1234 Role: OWNER

Tenant

Username: testtenet Password: 1234 Role: TENANT

πŸ“Œ Assumptions Made

Custom User model includes a role field.

Roles are defined as:

ADMIN

OWNER

TENANT

Only active users (is_active=True) can log in.

SQLite is used as the default database.

Templates are stored in the project-level templates/ directory.

Static files are stored in the project-level static/ directory.

Owners are allowed to update their bill payment status.

About

A role-based Society Management System built using Django, featuring Admin and Owner dashboards, flat allocation, and maintenance bill management with authentication and access control.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors