Acculance – POS, Inventory, Accounting Application

✨ Key Features

• POS (Register): Fast barcode scanning, SKU search, hold/resume cart, discounts, customer selection, taxes, multi-tender (cash/card/wallet), and receipts (A4/80mm).
• Inventory Control: Products, variants & units, batches/expiry (optional), minimum stock alerts, stock adjustments, multi-warehouse transfers, and bulk import via CSV.
• Purchasing & Suppliers: Purchase orders, bills, returns, landed-cost allocation, supplier ledger, and aging.
• Customers & CRM: Customer profiles, credit limits, price levels, due tracking, loyalty points (optional), and statements.
• Accounting (Double-Entry): Chart of accounts, journals, payments/receipts, bank/cash accounts, reconciliation, and closing balances.
• Taxes & Compliance: VAT/GST per item or invoice, multiple tax groups, tax-inclusive/exclusive pricing, and period summaries.
• Reports: Sales by day/store/cashier, product performance, stock on hand, valuation (FIFO/Avg*), aging, P&L, balance sheet, trial balance, and audit trail.
• Multi-Store/Branch: Per-store catalogs, roles, permission sets, and consolidated HQ reporting.
• Hardware & Peripherals: Thermal printers (ESC/POS), barcode scanners, cash drawer kick, and label printing.
• User & Security: Role-based access control, activity log, session lock, 2-step prompts for risky actions.
• Localization: Multi-currency, multiple locales, RTL layouts, and regional number/date formats.
• Integrations (optional): Email/SMS notifications, payment links, webhooks, and REST API for 3rd-party services.

*Valuation method depends on your configuration and data completeness.

⚙️ Technical Stack

• Backend: PHP 8.1+ with Laravel 10+ (typical implementation)
• Frontend: Blade/Tailwind or Vue 3 + Vite (SPA/Inertia) with responsive layouts
• Database: MySQL 8.x / MariaDB 10.6+ (PostgreSQL optional)
• Cache/Queue: Redis (for sessions, queues, broadcasting)
• Server: Nginx or Apache, HTTPS enabled; PHP-FPM recommended
• Printing: ESC/POS over network/USB; PDF receipts via DOMPDF/Snappy
• Optional: Docker Compose for local dev; Supervisor for queue workers; S3-compatible storage for backups
• Minimum client: Modern browsers (Chromium/Firefox/Safari); Android/iOS via PWA or native wrapper

🧩 Installation Guide

1. Requirements: PHP 8.1+, MySQL/MariaDB, Composer, Node.js 18+, and Redis (optional but recommended).
2. Clone & install: composer install → cp .env.example .env → set DB/APP_URL/MAIL.
3. Key & migrate: php artisan key:generate → php artisan migrate --seed.
4. Build assets: npm install → npm run build (or dev for local).
5. Queues & cache: php artisan queue:work (Supervisor in prod) and php artisan config:cache.
6. Printing: Configure printer endpoints (USB/network) and receipt templates (80mm/A4).
7. Go live: Set up HTTPS, schedule artisan tasks (backups), and create user roles & branches.

📦 Deliverables

• Complete Laravel project with POS, Inventory, and Accounting modules
• Seed data (sample products, taxes, chart of accounts)
• Receipt/label templates (80mm/A4) and printer configuration samples
• Import/Export CSV samples (products, customers, suppliers)
• Environment templates (.env.example) and Docker files (optional)
• Quick-start & admin guide, report dictionary, and backup checklist
• GPL license file and redistribution notice

📱 Supported Platforms

• Web: Chrome/Firefox/Edge/Safari (desktop POS recommended)
• Mobile: Android/iOS via responsive PWA or native wrappers for kiosks
• Peripherals: ESC/POS thermal printers, barcode scanners (keyboard/USB/HID), cash drawers

🧠 Notes

• License: Distributed under the GPL for learning, audits, and derivative works.
• Customization tips (Expertise): Parameterize taxes and price levels; map warehouses to branches; use roles for cashier/manager/accountant; enable Redis queues for responsive POS and reporting.
• Performance: Index SKU/barcode, paginate heavy reports, offload PDFs to queues, and use backups + binlog for point-in-time recovery.
• Accounting integrity: Lock closed periods; restrict edits to posted entries; reconcile bank accounts monthly; keep audit log immutable.
• SEO/ASO (if wrapping): Use “POS, Inventory, Accounting, GST/VAT” keywords; localize store listings; add screenshots of receipts and reports.

👨‍💻 Original Developer Credit

This description acknowledges the original “Acculance” author(s) commonly published on marketplaces like
CodeCanyon.
Please support the original developer if you rely on their commercial edition or require premium support/updates.

🔒 Disclaimer

Provided for educational and evaluation purposes under the GPL.
Third-party assets (logos, fonts, barcode fonts, templates) and integrations (email/SMS/payment gateways) require your own licenses/keys.
You are responsible for legal and tax compliance in your jurisdiction (invoice formats, VAT/GST rules, record retention) and for honoring any original developer terms, including purchasing a commercial license if required. No demo links are included.