https://github.com/gopalverma1303/homeease
The household services management web application for customers, professionals, and administrators.
https://github.com/gopalverma1303/homeease
bootstrap chartjs css flask html javascript jinja python sqlal sqlite
Last synced: 2 months ago
JSON representation
The household services management web application for customers, professionals, and administrators.
- Host: GitHub
- URL: https://github.com/gopalverma1303/homeease
- Owner: GopalVerma1303
- Created: 2024-12-09T09:37:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-09T09:59:22.000Z (over 1 year ago)
- Last Synced: 2025-03-31T05:28:36.887Z (about 1 year ago)
- Topics: bootstrap, chartjs, css, flask, html, javascript, jinja, python, sqlal, sqlite
- Language: HTML
- Homepage:
- Size: 734 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HomeEase
### The household services management web application for customers, professionals, and administrators.
[](https://developer.mozilla.org/en-US/docs/Web/HTML)
[](https://developer.mozilla.org/en-US/docs/Web/CSS)
[](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[](https://www.python.org/)
[](https://flask.palletsprojects.com/)
[](https://getbootstrap.com/)
[](https://jinja.palletsprojects.com/)
[](https://www.sqlite.org/)
## Features
1. Analyzed the requirements and identified key features for customers, professionals, and administrators.
2. Designed the database schema to support user roles, services, and service requests.
3. Developed the backend using Flask to handle user authentication, service management, and request processing.
4. Created a responsive frontend using HTML, CSS, and JavaScript to ensure a user-friendly interface.
5. Implemented admin functionalities for user management and platform oversight.
6. Integrated a rating and review system for service quality feedback.
## Technologies Used
- **Backend:** Flask (Python web framework)
- **Database:** SQLite
- **ORM for DB:** SQLAlchemy
- **Frontend:** HTML, CSS, JavaScript (Jinja templates)
- **UI Framework:** Bootstrap 5
- **Authentication:** Flask-Login
- **Password Hashing:** Werkzeug Security
- **Date/Time Handling:** datetime
## Database Design
1. **User**
- Fields: id, username, email, password, role, is_blocked, date_created, address, pin_code
2. **Service**
- Fields: id, name, base_price, time_required, description
3. **Professional**
- Fields: id, user_id, service_id, experience, description, is_approved, documents, pin_code, avg_rating, total_services
4. **ServiceRequest**
- Fields: id, service_id, customer_id, professional_id, date_of_request, date_of_completion, service_status, remarks, rating, review_remarks, has_review, location
## Contributing
We welcome contributions to HomeEase! Here's how you can help:
1. **Fork the Repository**
- Create a fork of this project to your GitHub account
2. **Clone the Fork**
```bash
git clone https://github.com/your-username/HomeEase.git
cd HomeEase
```
3. **Create a Branch**
```bash
git checkout -b feature/your-feature-name
```
4. **Make Changes**
- Write your code
- Follow the existing code style
- Add comments where necessary
- Test your changes thoroughly
5. **Commit Changes**
```bash
git add .
git commit -m "Add: brief description of your changes"
```
6. **Push to GitHub**
```bash
git push origin feature/your-feature-name
```
7. **Create a Pull Request**
- Go to your fork on GitHub
- Click "New Pull Request"
- Select your feature branch
- Describe your changes in detail
### Development Setup
1. Create a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python app.py
```
Please ensure your PR:
- Includes a clear description of the changes
- Has been tested locally
- Follows the existing code style
- Updates documentation if needed