awrsha/telecom-employee-management-system

The ability to add a new employee or delete and update the information of old employees along with the ability to search among employees. The back-end part of the project is also written with Django.

Employee Management System

The Employee Management System is a web-based application built using Django, HTML, CSS, and SQLite3 that allows users to efficiently manage employee information. The system provides features for adding, updating, and deleting employee records, as well as searching for specific employees based on various criteria. This README.md provides an overview of the project, installation instructions, usage guidelines, and other relevant information.

Table of Contents

• Features
• Prerequisites
• Installation
• Usage
• Project Structure
• Contributing
• License

Features

1. Add New Employee: Users can add new employee details to the system, including information such as name, contact details, job position, and department.

2. Update Employee Information: Existing employee details can be updated, allowing for changes to be made to their records when needed.

3. Delete Employee: Users can delete employee records from the system, effectively removing their information.

4. Search Functionality: The system offers a search feature, enabling users to search for employees using different search criteria such as name, department, or job position.

5. User-Friendly Interface: The web interface is designed with HTML and CSS to provide an intuitive and visually appealing user experience.

6. Django Backend: The backend of the project is developed using Django, which handles data storage, retrieval, and management efficiently.

7. SQLite Database: Employee data is stored in an SQLite3 database, ensuring data integrity and reliability.

Prerequisites

Before you begin, ensure you have the following prerequisites:

• Python (version 3.x)
• Django (install using pip install django)

Installation

1. Clone the repository to your local machine using:

   git clone https://github.com/awrsha/Telecom-Employee-Management-System.git

2. Navigate to the project directory:

   cd TCI-Beta-V1

3. Install the required dependencies:

   pip install -r requirements.txt

4. Run migrations to set up the database:

   python manage.py makemigrations

   Run migrate to set up the database:

   python manage.py migrate

Usage

1. Start the development server:

   python manage.py runserver

2. Open your web browser and go to http://localhost:8000 to access the Employee Management System.

3. Use the provided interface to add, update, delete, and search for employee records.

Project Structure

• employee_app/: This is the main Django app directory.
  • models.py: Defines the data models for employees.
  • views.py: Contains the views and logic for handling requests.
  • urls.py: Defines the URL routing for the app.
• static/: Static assets such as CSS files, images, and JavaScript files.
• templates/: HTML templates for rendering different pages.
• manage.py: Django management script for various tasks.

Contributing

Contributions to this project are welcome. To contribute, follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and test thoroughly.
4. Commit your changes and push them to your fork.
5. Create a pull request detailing your changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Developers 👨🏻‍💻

_{.:: Amir M. Parvizi ::.}

System & Hardware 🛠

⚙️ Things I use to get stuff done

• OS: Windows 11
• Laptop: TUF Gaming
• Code Editor: Visual Studio Code - The best editor out there.
• To Stay Updated: Medium, Linkedin and Instagram.

⚛️ Checkout Our VSCode Configrations Here.

💙 If you like my projects, Give them ⭐ and Share it with friends!