Torque Vault Server¶

Plans¶

• Migrate the source code from Gitlab to Gitea.
• Switch to develop branch to continue development.
• Standardize responses from API:
  • Success response:
    • List resource (no pagination):
      GET /api/v1/able-work-order?wo_id=1
      => 200 OK

    {
      "data": [
        WorkOrder_Object,
        WorkOrder_Object,
      ]
    }
    

    • List resource (pagination):
      GET /api/v1/work-orders?page=1&page_size=20
      => 200 OK

    {
      "data": [
        WorkOrder_Object,
        WorkOrder_Object,
      ],
      "meta": {
        "page": 1,
        "page_size": 20,
        "total_pages": 7
      }
    }
    

    • Retrieve detail:
      GET /api/v1/work-orders/1
      => 200 OK

    {
     "data": WorkOrder_Object
    }
    

    • Create resource:
      POST /api/v1/work-orders
      => 201 Created

    {
     "data": WorkOrder_Object
    }
    

    • Update resource:
      PUT/PATCH /api/v1/work-orders/1
      => 200 OK

    {
     "data": WorkOrder_Object
    }
    

    • Delete resource:
      DELETE /api/v1/work-orders/1
      => 204 No Content

    (Empty)
    

  • Error response:

    {
      "code": "string",
      "message": "string"
    }
    

    • Validation Error:
      POST /api/v1/work-orders
      => 400 Bad Request

    {
      "code": "VALIDATION_ERROR",
      "message": "Validation failed",
      "errors": {
        "make": [
          "This field is required."
        ],
        "employee": [
          "This field is required."
        ]
      }
    }
    

    • Resource Not Found:
      PATCH /api/v1/work-orders/1
      => 404 Not Found

    {
      "code": "404_NOT_FOUND",
      "message": "Work order not found"
    }
    

• Develop an API endpoint for the mobile app home screen to retrieve all work orders whose status is Open, Retorque, Servicing, or Re-servicing.
• Migrate the Help / Instructions feature from walmart branch to develop branch.
• CI CD integration.