# ZEENO ERP POS
## PROJECT.md

# Project Name

ZEENO ERP POS

---

# Project Objective

Develop a modern Enterprise Resource Planning (ERP) and Point of Sale (POS) system using:

- PHP 8.3
- Laravel
- MySQL 8
- Livewire
- Alpine.js
- Tailwind CSS

The application must support small, medium, and large trading businesses.

---

# Business Type

- Trading
- Wholesale
- Retail
- Distribution
- Multi-Branch
- Multi-Warehouse

---

# Core Features

- Multi Company
- Multi Branch
- Multi Warehouse
- Fiscal Years
- User Roles
- Permissions
- Dashboard
- POS
- Sales
- Sales Return
- Purchase
- Purchase Return
- Inventory
- Customers
- Suppliers
- Cash Book
- Bank Book
- Journal Vouchers
- Financial Statements
- Reports
- Audit Logs
- Notifications
- FBR Integration

---

# Accounting Requirements

Use a Four-Level Chart of Accounts.

Example:

10
10-01
10-01-0001
10-01-0001-00000001

Only Level 4 accounts accept transactions.

Every business transaction must automatically create journal entries.

---

# Inventory Requirements

Support:

- Batch
- Expiry
- Serial Number
- Warehouse
- Rack
- Bin
- FIFO
- Weighted Average Cost

Every inventory movement must create stock ledger records.

---

# Sales Requirements

- POS
- Quotations
- Sales Orders
- Sales Invoices
- Returns
- Credit Notes
- Customer Receipts

---

# Purchase Requirements

- Purchase Orders
- Goods Receipts
- Purchase Invoices
- Returns
- Supplier Payments

---

# Financial Reports

- Trial Balance
- General Ledger
- Profit & Loss
- Balance Sheet
- Cash Flow
- Customer Ledger
- Supplier Ledger

---

# Dashboard

Display:

- Today's Sales
- Today's Purchases
- Gross Profit
- Cash Balance
- Bank Balance
- Receivables
- Payables
- Low Stock
- Top Customers
- Top Products

---

# Security

- Role Based Permissions
- Branch Restrictions
- Warehouse Restrictions
- Audit Logs
- Database Transactions
- CSRF Protection
- XSS Protection

---

# Coding Standards

- Clean Architecture
- Repository Pattern
- Service Layer
- Form Requests
- Policies
- Events
- Notifications

---

# UI Requirements

Modern enterprise interface inspired by:

- Oracle Fusion
- Microsoft Dynamics 365
- SAP Fiori
- Odoo Enterprise

Use:

- Tailwind CSS
- Livewire
- Responsive Layout
- Dark Mode Support

---

# Target

Create a production-ready ERP that can scale for thousands of users while maintaining accurate accounting and inventory control.