Implement Procurement Module

[RUKAYAT-CODER]

[BACKEND] Implement Procurement Module

📚 Description

Implement a Procurement Module to handle asset purchase requests and approvals.
This will enable structured management of procurement workflows and integrate with asset registration once approved.

---

✅ Expected Behavior

• Maintain a procurement_requests table with fields:
  • itemName
  • quantity
  • requestedBy
  • status
• API to create procurement requests.
• API to approve/reject procurement requests.
• Approved requests automatically link to asset registration.

---

🛠️ Tasks

• Generate procurement module.
• Define entity, DTOs, and service.
• Implement endpoints for:
• Submitting a new request.
• Approving/rejecting requests.
  -[x] Integrate approved requests with asset registration flow.

---

📂 Impacted Files

• src/procurement/procurement.module.ts (new)
• src/procurement/procurement.entity.ts (new)
• src/procurement/dto/* (new)
• src/procurement/procurement.service.ts (new)
• src/procurement/procurement.controller.ts (new)
• test/procurement/procurement.e2e-spec.ts (new)

Changes applied:

• Added procurement module
  ◦ src/procurement/enums/procurement-status.enum.ts
  ◦ src/procurement/entities/procurement-request.entity.ts
  ◦ src/procurement/dto/create-procurement-request.dto.ts
  ◦ src/procurement/dto/update-procurement-status.dto.ts
  ◦ src/procurement/interfaces/asset-registration.interface.ts
  ◦ src/procurement/providers/procurement.service.ts
  ◦ src/procurement/procurement.controller.ts
  ◦ src/procurement/procurement.module.ts
• Integrated module
  ◦ src/app.module.ts: Imported ProcurementModule
  ◦ src/config/typeorm.config.ts: Added ProcurementRequest to entities
• Migration
  ◦ src/migrations/1727955600000-CreateProcurementRequestsTable.ts
• Tests
  ◦ src/procurement/providers/procurement.service.spec.ts

🎯 Acceptance Criteria

• Procurement requests can be created, approved, or rejected via API.
• Approved requests are linked to asset registration.
• Data persists correctly in procurement_requests.
• Tests validate request lifecycle and approval logic.

---

🔖 Labels

• feature
• backend
• procurement

close #324

[vercel]

@RUKAYAT-CODER is attempting to deploy a commit to the naijabuz's projects Team on Vercel.

A member of the Team first needs to authorize it.