Service Management System for Computer Repair Shops

A Django REST API backend for managing computer repair shop operations, including customer management, repair job tracking, and parts replacement records.

Description

This project provides a comprehensive backend API for computer repair shops to manage their daily operations. It allows tracking customers, creating and managing repair jobs, assigning engineers, and recording replaced parts with costs.

Features

• User Management: Custom user model with roles for staff and engineers
• Customer Management: Store customer details including contact information and address
• Repair Job Tracking: Create, update, and track repair jobs with device details, status, and assignments
• Parts Management: Record replaced parts with costs for each repair job (Model exists, API pending)
• Status Tracking: Monitor repair progress (pending, in progress, completed)
• Image Upload: Support for device images
• RESTful API: Built with Django REST Framework for easy integration
• Query Profiling: Integration with Django Silk for performance monitoring

Tech Stack

• Backend: Django 6.0.1
• API Framework: Django REST Framework
• Authentication: JWT (JSON Web Tokens)
• Database: PostgreSQL
• Documentation: Markdown

Installation

Prerequisites

• Python 3.8 or higher
• PostgreSQL database
• Git

Setup

1. Clone the repository:

   git clone <repository-url>
   cd DRS_API

2. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Database Setup:

   • Create a PostgreSQL database named vedb
   • Update database credentials in backend_api/backend_api/settings.py if needed

5. Run migrations:

   cd backend_api
   python manage.py makemigrations
   python manage.py migrate

6. Create superuser:

   python manage.py createsuperuser

Usage

Running the Development Server

cd backend_api
python manage.py runserver

The API will be available at http://127.0.0.1:8000/

Admin Panel

Access the Django admin panel at http://127.0.0.1:8000/admin/ using the superuser credentials.

Silk Profiler

Access the Silk profiling dashboard at http://127.0.0.1:8000/silk/ (if configured).

API Endpoints

Authentication

• POST /api/auth/register/ - Register a new user
• POST /api/auth/login/ - Login and retrieve JWT tokens
• POST /api/token/ - Obtain JWT token pair
• POST /api/token/refresh/ - Refresh JWT access token

Jobs

• GET /api/job/ - List all repair jobs
• POST /api/job/create - Create a new repair job
• GET /api/job/<id>/ - Retrieve details of a specific repair job
• GET /api/user-job/ - List repair jobs created by the authenticated user
• GET /api/jobinfo/ - Get job statistics

Customers

• GET /api/customer/ - List all customers

Users

• GET /api/user/ - List all users

Models

CustomUser

• Roles: admin, owner, engineer
• Extends Django's AbstractUser

Customer

• customer_name, customer_phone, customer_email, address
• created_at timestamp

RepairJob

• customer (ForeignKey)
• Device details: device_type, device_brand, device_model, serial_number, device_image
• problem_description
• status (pending, in_progress, completed)
• assigned_engineer (ForeignKey to CustomUser)
• created_by (ForeignKey to CustomUser)
• Timestamps: created_at, updated_at

ReplacedParts

• repair_jab (ForeignKey to RepairJob)
• part_name, cost
• repaled_at timestamp

Otp

• phone, otp
• exprie_at, verified

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

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