> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VinMake ERP API Documentation

> RESTful API for garment manufacturing management

# Welcome to VinMake ERP

VinMake is a comprehensive Enterprise Resource Planning (ERP) system designed specifically for **garment manufacturing businesses**. Our platform streamlines every aspect of production, from initial costing and material procurement to final delivery and invoicing.

## What VinMake Does

VinMake helps garment manufacturers manage their entire production workflow:

<CardGroup cols={2}>
  <Card title="Production Management" icon="industry">
    Track production orders, manage production lines, and monitor real-time progress across your factory floor.
  </Card>

  <Card title="Bill of Materials (BOM)" icon="list-check">
    Create detailed BOMs with version control, material assignments, approval workflows, and cost tracking.
  </Card>

  <Card title="Material Management" icon="warehouse">
    Manage fabric, trims, and accessories inventory with detailed specifications and supplier tracking.
  </Card>

  <Card title="Costing & Budgets" icon="calculator">
    Accurate labor cost estimation, direct/indirect cost tracking, and budget management for each order.
  </Card>

  <Card title="Sales & Procurement" icon="cart-shopping">
    Handle sales orders, purchase orders (direct and fixed cost), and delivery notes in one unified system.
  </Card>

  <Card title="Financial Management" icon="money-bill-wave">
    Issue invoices, track bills, manage bank statements, and maintain management accounts.
  </Card>
</CardGroup>

## Explore by Section

The platform is organized into three documented surfaces, all served by one API:

<CardGroup cols={3}>
  <Card title="PLM" icon="layer-group" href="/cutmake/plm/overview">
    Product lifecycle & supply chain — quotes, sales orders, costing, the product library (styles, BOM, SKUs), and procurement.
  </Card>

  <Card title="MES" icon="industry" href="/cutmake/mes/overview">
    Shop-floor execution — production orders, cutting & sewing, warehouse & inventory, and quality control.
  </Card>

  <Card title="Finindex (ERP)" icon="money-bill-wave" href="/finindex/staging/index">
    Finance & accounting — AP/AR, the general ledger, and period close.
  </Card>
</CardGroup>

## Platform Features

* **Multi-tenant Architecture** — Secure isolation for each client
* **Role-based Access Control** — Client, Staff, and Admin user levels
* **Real-time Updates** — WebSocket support for live data synchronization
* **RESTful API** — Clean, predictable endpoints following OpenAPI 3.1 spec
* **Supabase Auth** — Secure JWT-based authentication

## Who Is This For?

This API documentation is for **VinMake team members** who need to:

* Integrate VinMake with external systems
* Build custom reports or dashboards
* Automate workflows via scripts or webhooks
* Extend the platform with custom features

## Internal Use Only

**Note:** This is an internal API documentation for the VinMake team. All endpoints require authentication and appropriate role permissions.

## Getting Started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Learn how to authenticate and make your first API call
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Detailed guide on JWT tokens and Supabase Auth
  </Card>

  <Card title="API Reference" icon="book" href="/cutmake/staging/api-reference">
    Browse the API reference inside Mintlify
  </Card>

  <Card title="Production API" icon="browser" href="https://vinmake-erp.onrender.com/">
    Access the VinMake production API endpoint
  </Card>
</CardGroup>

## API Overview

The VinMake API is organized into functional modules:

* **Authentication** — Login and password reset
* **Clients** — Customer management
* **Materials** — Fabric, trims, accessories inventory
* **BOM** — Bill of materials with versioning
* **Production** — Production orders and production lines
* **Sales Orders** — Customer orders and delivery notes
* **Purchase Orders** — Direct cost and fixed cost procurement
* **Financial** — Invoices, bills, bank statements, budgets
* **System** — API keys, webhooks, user management

All endpoints follow the `/api/v1/` prefix for consistent versioning.

## Base URL

```
https://vinmake-erp.onrender.com
```

<Warning>
  This is the **production** backend — the same one that serves
  [app.cutmake.ai](https://app.cutmake.ai). There is currently no public staging environment, so
  requests you send here, including writes, hit real data.
</Warning>

## Support

For questions or issues, contact the VinMake development team:

* **Email:** [thai@vinmake.com](mailto:thai@vinmake.com)
* **Production API:** [vinmake-erp.onrender.com](https://vinmake-erp.onrender.com/)