Backend Implementation for Delivery Person Management

[IkkiOcean]

Overview:
This PR adds a backend solution for managing delivery personnel within the system, implementing features such as CRUD operations, status toggling, and consistent response handling. This functionality allows for seamless management of delivery personnel with validation, secure password handling, and error messaging.

---

• closes Implement Backend for Delivery Person Management #977

Key Features:

1. Delivery Person Model Definition

• Schema Design: The DeliveryPerson schema includes fields such as name, email, phone_number, status, assigned_routes, vehicle_details, profile_picture, and password.
• Field Validations: Email and phone number are validated for uniqueness and format correctness.
• Password Security: Passwords are hashed using a utility function, ensuring stored passwords are secure.

2. CRUD Operations

• Create Delivery Person: Adds new personnel with validated input and hashed passwords when provided.
• Retrieve All Delivery Persons: Fetches a paginated list with selected fields.
• Retrieve by ID: Provides detailed information about an individual delivery person, including route assignments.
• Update Delivery Person: Supports updates with validation for fields such as email and phone number, with password hashing if updated.
• Soft Delete: Allows deactivation of personnel instead of complete deletion by setting their status to inactive.

3. Status Toggling

• Toggle Active/Inactive Status: Supports controlled toggling between active and inactive statuses based on provided values. Ensures only valid statuses are accepted.

4. Middleware Implementations

• Authentication Middleware: Ensures that only authenticated users can access these endpoints.
• Validation Middleware: Enforces input validity, including:
  • Email uniqueness and format
  • Phone number format and length
  • Validity of the status field
  • Route references, where applicable
• Authorization Middleware: Restricts access to personnel management functions to admin users only.

5. Standardized Response Handling

• Consistent Responses: Success and error response helper functions provide uniform structure across all endpoints, enhancing readability and consistency.
• Detailed Feedback: Error responses include specific messages for user-friendly debugging, while success responses confirm actions and return relevant data.

6. Routing and Endpoint Definitions

• Endpoint Setup: Defined endpoints for each CRUD operation, status toggling, and retrieval with pagination, using RESTful conventions.
• RESTful Routes:
  • POST /api/delivery-persons: Create
  • GET /api/delivery-persons: Retrieve all (paginated)
  • GET /api/delivery-persons/:id: Retrieve by ID
  • PUT /api/delivery-persons/:id: Update by ID
  • DELETE /api/delivery-persons/:id: Soft delete
  • PATCH /api/delivery-persons/:id/status: Status toggle

---

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
agro-tech-ai	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Nov 10, 2024 11:22am

[github-actions]

Thank you for submitting your pull request! 🙌 We'll review it as soon as possible. In the meantime, please ensure that your changes align with our CONTRIBUTING.md. If there are any specific instructions or feedback regarding your PR, we'll provide them here. Thanks again for your contribution! 😊

[github-actions]

🎉 Your pull request has been successfully merged! 🎉 Thank you for your valuable contribution to our project. Your efforts are greatly appreciated. Feel free to reach out if you have any more contributions or if there's anything else we can assist you with. Keep up the fantastic work! 🚀