Welfare Management System

Overview

Transparency and accountability have been my driving force in learning SE. Having noticed the inefficiencies of managing welfare activities in the village, I decided to come up with a Welfare Management System (WMS). The purpose of my PROJECT is to empower communities through the development of a system that aims to facilitate transparent contributions, accountable financial management, and seamless interaction among community members. By providing a platform for managing welfare contributions, donations, and financial activities, the WMS seeks to address the challenges associated with the inefficiencies of manual record-keeping, lack of transparency, and difficulties in maintaining accurate financial records. The project aims to streamline and automate these processes, fostering transparency, accountability, and ease of access to welfare-related information. Through the integration of the Mpesa API for automated transactions, the WMS further enhances its functionality, enabling users to make contributions and transactions more conveniently. Overall, the purpose of the project is to improve the welfare management process within communities, promoting efficiency, transparency, and accountability.

Table of Contents

• Technologies Used
• Installation Frontend
• Installation Backend
• Configurations
• Usage
• Contributing
• License
• Links

Technologies-used

• React-Vite
• Tailwind-CSS
• Django

Installation-Frontend

1. Clone the repository to your local machine.

   git clone https://github.com/mainanorbert/Welfare_Management_System.git

2. Navigate into the Project Directory

   cd wms-frontend

3. Install Dependencies

   npm install

4. Start the Development Server

   npm run dev

5. Access the Project in the Browser

   http://localhost:5173
   

Installation-Backend

1. Clone the Repository

• skip this step if you already cloned repository when installing frontend

  git clone https://github.com/mainanorbert/Welfare_Management_System.git

2. Navigate into the Project Directory

   cd wms

3. Install Dependencies (optional, if using a virtual environment)

   python -m venv venv
   source venv/bin/activate  # For Linux/Mac
   . .\venv\Scripts\activate  # For Windows

4. Install the packages with other dependencies

   pip install -r requirements.txt

5. Apply Migrations

   python3 manage.py migrate

6. Create a Superuser (if needed)

   python manage.py createsuperuser

7. Run the Development Server

   python3 manage.py runserver
   

Configuration

After installing and running both frontend and backend, other configurations include:

1. updating AxiosClient.jsx file of the react frontend to ensure baseURL matches you backend url
2. Updating wms/settings.py of the django backend to ensure that CORS_ALLOWED_ORIGINS include your local frontend developement server url e.g., http://localhost:5173

Usage

• After installing, use the navbar and other links to view different features:
• To have full access to the system, contact developer via:
  • Twitter
  • LinkedIn
  • Email
• Access the hosted project: Welfare Management System

Contribution

To contribute to this project, follow the steps:

1. Fork the repository
2. Make the desired changes
3. Push your changes to github
4. Create a pull request

License

The project is opensource and anybody is free to use and modify it appropriately by contacting through email or my social media

Links

• Nobertechx Blog
• LinkedIn
• Article on Welfare Management Project
• Welfare Management System
• Twitter