# Inventory Management System - User Guide

This guide explains how to use the decoupled Inventory Management module in your POS. This system is designed to track raw materials (items) independent of your menu products.

---

## 1. Core Concepts
*   **Inventory Items**: These are your raw materials (e.g., Milk, Flour, Sugar, Napkins). They are NOT your menu items.
*   **Suppliers**: The vendors you buy these items from.
*   **Purchases**: Professional recording of stock arrival with price and payment tracking.
*   **Stock In/Out**: Manual logs for opening stock, usage, or damage.

---

## 2. Setting Up Your Foundation
Before recording transactions, you must define your items and suppliers.

### A. Adding Inventory Items
1.  Go to **Inventory Items** > **Add New Item**.
2.  Enter the **Name**, **Unit** (Kg, Liter, Packet), and **Minimum Stock**.
3.  The **Minimum Stock** level will trigger "Low Stock" alerts on your dashboard when items run low.

### B. Adding Suppliers
1.  Go to **Suppliers** > **Add New Supplier**.
2.  Enter the contact details. This is essential for tracking who you owe money to (Debit).

---

## 3. The Purchase Workflow (Recommended)
This is the "Professional Way" to add stock to your system.

1.  Go to **Purchases** > **New Purchase**.
2.  Select a **Supplier** and enter the **Invoice Number**.
3.  Add items to the table. The system calculates the total automatically.
4.  **Payments**:
    *   If you pay in full, enter the total amount in the "Paid Amount" field.
    *   If you pay partially, enter the amount paid. The system will mark the invoice as **"Partial"** and track the **Remaining Debit**.
5.  **Result**: Inventory levels are updated automatically upon saving.

---

## 4. Stock Adjustments (Manual)
Use these modules only for non-purchase scenarios.

### A. Stock In (Manual)
*   **When to use**: Opening stock (when first starting), gifts from suppliers, or correcting a count error.
*   **Workflow**: Select items and quantities. No financial record is created.

### B. Stock Out (Usage)
*   **When to use**: Daily consumption (using items in the kitchen), damages, or expired goods.
*   **Workflow**: Select the **Reason** (Consumption/Damage) and quantity. The system will prevent you from removing more stock than you actually have.

---

## 5. Reporting & PDF Exports
The system includes a professional PDF reporting suite.

### A. Inventory Status
*   **Location**: **Stock Status** page.
*   **Action**: Click **"Export Full Status PDF"**.
*   **Use Case**: Full inventory audit showing healthy vs. low stock items.

### B. Monthly Purchase Ledger
*   **Location**: **Purchases** index.
*   **Action**: Select a **Month** from the filter and click **"Export Monthly PDF"**.
*   **Use Case**: Seeing total spending, amounts paid, and **Total Outstanding Debit** for the month.

### C. Daily Consumption Report
*   **Location**: **Stock Out (Usage)** index.
*   **Action**: Select a **Date** from the calendar and click **"Export Daily PDF"**.
*   **Use Case**: Tracking daily waste and usage efficiency in the kitchen.

---

## 6. Security & Permissions
Access is controlled via the **Admin Panel**:
*   **Admin**: Full access to all inventory modules.
*   **Manager/Cashier**: Access can be restricted. Go to **Roles & Permissions** to toggle "view/create/edit" access for specific staff members.

---

## 7. Professional Tips
*   **Consistency**: Always use the same units (e.g., if you buy Milk in Liters, always stock it out in Liters).
*   **Partial Payments**: You can record additional payments for a "Partial" purchase later by viewing the purchase details and clicking **"Add Payment"**.
*   **Low Stock Alerts**: Check your **Stock Status** dashboard daily to ensure you never run out of essential ingredients.
