Midnight Edition • Build v4.0

DISTRIBUTION
PERFECTED

A role-based operating system for inventory tracking, point-of-sale execution, and automated partnership ledgers.

VIEW SPECS

// THE CORE CONCEPT

Imagine running a giant store where some friends supply the products (Growers), other friends help sell them (Middlemen), and customers buy them.

Without this program: You have to remember who gave you what, who owes you money, and how much stock is left on a messy piece of paper.

With Distro V4: It's a "Magic Ledger." It automatically tracks every single item from the moment it arrives until it is sold, and calculates exactly how much money everyone is owed, down to the penny, instantly.

What does it actually do?

It's a full-stack ERP (Enterprise Resource Planning) tool built specifically for distribution networks with complex profit-sharing models.

Role-Based Logic

Admins see everything. Partners (Growers/Sellers) only see what they need to. It keeps sensitive data secure.

Profit Splitting Engine

Selling for a partner? The system automatically calculates the split (e.g., 50/50), updates your debt to them, and logs the profit.

Digital Paper Trail

Generates receipts, verifies pending payments (CashApp, Zelle), and maintains an immutable history log.

Under the Hood

System Modules

Live Inventory

Real-time tracking of stock levels, cost-basis vs. sale price, and product categorization (Flower, Edible, etc.). Includes low-stock alerts.

Intelligent POS

A Point-of-Sale interface that handles "Stock In" (Intake) and "Sale" (Stock Out). Supports overrides, carts, and client tracking.

Partner Analytics

Instantly see "Owed To Me" vs "Owed Out". The system aggregates transaction history to show net standing with every partner.

Workflow Execution

Complex logic hidden behind a simple UI. Here is the typical lifecycle of a product in the system.

1

Authentication

Login securely. Admins access the global dashboard; Partners access their specific portal.

2

Intake (Stock In)

Use the POS to intake items. Select the "Source" (Partner). The system credits the stock and logs the acquisition cost.

3

Distribution (Sale)

Process a sale. Select Payment Method (Cash, Zelle). Apply a "Split" if a partner is owed a % of profit.

4

Reconciliation

Check the History tab. Verify pending payments. View the Partner Ledger to settle debts.

admin@distro-v4:~
➜ ~ ./system_init --theme=midnight
[INFO] Firebase Connection... ESTABLISHED
[INFO] Loading Inventory... 142 SKUs Found
[SUCCESS] Dashboard Loaded. Welcome, Admin.
➜ ~ query --partner="TopGrower_LLC"
--------------------------------
PARTNER ID: 8821X
TOTAL SALES: $12,450.00
OWED TO THEM: $4,200.00
--------------------------------
➜ ~ transaction --type=sale --split=50%
[PROCESSING] Calculating profit split...
[UPDATE] Inventory deducted. Ledger updated.
[SUCCESS] Receipt generated #TX-9902
➜ ~

LIVE LOGIC SIMULATION