Add Payment Schema, Controllers, and Admin-Restricted Management Routes for Backend

[IkkiOcean]

Description:
This PR introduces the schema, controller, and management features for handling payments in the backend. It includes a set of routes allowing the system to store, track, and manage payment-related information. Additionally, certain CRUD operations are restricted to admins, ensuring secure access and control over payment details via the admin dashboard.

Changes Implemented

1. Payment Schema

• Schema Design: Created a Payment schema to store all relevant information about customer payments.
  • Fields:
    • paymentId, orderId, userId, amount, paymentMethod, paymentStatus, paymentDate, transactionId.
  • Validations & Defaults:
    • paymentStatus defaults to Pending.
    • Required validations on fields like amount, userId, and orderId to ensure data integrity.

2. Payment Controller

• CRUD Operations:
  • Retrieve All Payments: Allows admins to fetch all payment records for tracking and auditing.
  • Retrieve Payment by ID: Allows access to a specific payment record based on paymentId.
  • Create Payment: Adds a new payment entry with the required details.
  • Update Payment Status: Enables admins to update the paymentStatus field (Pending, Completed, Failed).
  • Update Payment Method: Allows admins to modify the payment method.
  • Delete Payment: Allows admins to remove a specific payment entry based on paymentId.

3. Payment Management API Endpoints

• Routes:

  • GET /: Retrieve all payments (Admin-only).

  • GET /:id: Retrieve a specific payment by ID.

  • GET /user/:userId: Retrieve all payments made by a specific user.

  • GET /status/:status: Retrieve payments filtered by status.

  • POST /: Create a new payment.

  • PATCH /:id/status: Update the status of a specific payment (Admin-only).

  • PATCH /:id/method: Update the payment method of a specific payment (Admin-only).

  • DELETE /:id: Delete a specific payment (Admin-only).

  • Additional Routes for Edge Cases:

    • GET /date-range: Retrieve payments within a specific date range.
    • GET /amount-range: Retrieve payments within a specific amount range.
    • GET /transaction/:transactionId: Retrieve a payment by transaction ID.
    • GET /count/status: Count payments grouped by their status.
• fixes Develop Payment and Invoice Management System with Schema, Controller, and Functionality for Admin Dashboard #946

4. Middleware

• Access Control Middleware:

  • Implemented middleware to verify admin access, restricting certain routes (e.g., GET /, PATCH /:id/status, PATCH /:id/method, DELETE /:id) to admins only.

• Payment Data Validation Middleware:

  • Ensures that all required fields are valid before creating or updating a payment.

[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 9, 2024 7:24pm

[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! 🚀