=== WholeStock – Wholesale & Inventory Management ===
Contributors: wpfinity
Tags: wholesale, inventory, warehouse, stock management, invoices
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A wholesale and inventory management system for WordPress — products, shipments, customers, orders, payments, stock tracking, and invoices.

== Description ==

WholeStock is a complete wholesale and warehouse management system built for import-based product businesses. Manage your entire inventory pipeline from incoming shipments to customer sales orders, all from within WordPress.

**Core Features (Lite):**

* **Products** — Create a product catalog with flexible multi-unit conversions (e.g., cartons, dozens, boxes → individual pieces).
* **Shipments** — Track incoming inventory shipments with line items, carton counts, and per-unit costs in any supported unit.
* **Customers** — Manage customer profiles with lifetime due tracking and order history.
* **Sales Orders** — Create orders drawn from specific shipment batches with full stock validation and status workflow (pending → confirmed → delivered).
* **Payments** — Record payments against orders with automatic status tracking (unpaid/partial/paid).
* **Stock View** — Real-time inventory at the shipment-item level with batch traceability.
* **Audit Logs** — Track every action with user, timestamp, and before/after values.
* **Invoices** — Public or private invoice URLs with print and PDF download support.
* **Currency** — Select from 40+ world currencies with customizable formatting.
* **Settings** — Business info, number prefixes, invoice configuration, and more.

== Installation ==

1. Upload `wholestock` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to the 'WholeStock' menu in wp-admin to get started.
4. Configure your business info and currency in Settings.

== Frequently Asked Questions ==

= What PHP version is required? =

PHP 8.0 or higher is required.

= Does this work with WooCommerce? =

WooCommerce integration is planned for an upcoming release.

= Can I use custom units? =

Yes! Each product can define its own unit conversions (e.g., 1 carton = 24 pcs).

== Changelog ==

= 1.0.0 =
* Initial release.

== Source Code & Build ==

The uncompiled Vue 3 source code for the admin interface is included in the `frontend/` directory.

To build the production assets from source:
1. Navigate to the `frontend/` directory: `cd frontend`
2. Install dependencies: `npm install`
3. Run the build script: `npm run build`

Output assets will be generated in `assets/dist/`.