نظام تخطيط موارد المؤسسات المتكامل

📖 System Overview Laravel ERP System is an advanced, fully integrated Enterprise Resource Planning (ERP) platform engineered to fulfill the operational, financial, and logistical requirements of trading companies, wholesale and retail enterprises, as well as supply chain and distribution networks. The system delivers a unified, comprehensive environment that bridges: Sales & Client Management: Featuring an interactive invoicing engine, payment tracking, and receipt vouchers. Procurement & Vendor Management: Covering warehouse receiving workflows, vendor opening balances, and account statements. Warehouse Management & Real-Time Inventory Valuation: Delivering granular precision via Weighted Average Cost (WAC), projected profit margins, and physical stocktaking sheets. Barcode Generation & Logistics Documentation: Including packaging stickers, delivery slips, and receiving checklists. Branch Management & Organizational Structure: Providing granular, role-based access control (RBAC) across departments and users. Modern, Dynamic UI: Built on Laravel Livewire for full-page reactivity without browser reloads, complete with bidirectional bilingual support (Arabic & English) and dynamic RTL / LTR layout adaptation. ⚡ Key Features & Capabilities ⚡ Livewire Reactivity (No Page Reloads): Real-time invoice building, instant line-item additions, automated tax and discount calculations, and live grand-total adjustments. 🏢 Multi-Branch Architecture: Centralized administration of multiple commercial branches, seamlessly linking employees, warehouses, and transactions to their respective locations. 🌐 Full Bilingual Support (Arabic & English) with RTL/LTR: Native interface switching between Arabic and English, utilizing premium typography (Tajawal, Noto Kufi Arabic, Nunito). 🔄 Instant Auto-Translation Engine: Programmatic integration with automated translation services to instantly translate category titles, job designations, permissions, and branch profiles during input. 🧾 End-to-End Invoicing Lifecycle (Sales & Purchases): Support for advance down payments, installments, partial settlements, multi-channel payment methods (cash, cheque, bank transfer), and digital document attachments. 📊 Real-Time Inventory Valuation: Continuous, accurate tracking of total stock value, average purchase cost, current retail price, projected gross profit, and weighted average cost. 🏷️ Dynamic Barcode & SKU Generator: Automated generation of unique SKU identifiers and visual 1D barcodes, complete with custom multi-label sheet printing. 🚚 Specialized Logistics Vouchers: Instant generation and export of PDF package stickers, delivery slips, and customer receiving checklists. 🛡️ Granular Role-Based Access Control (RBAC): Departmental permission grouping, with the ability to assign permissions directly to individual users or inherit them via predefined roles. 🔢 Sequential Numbering Engine: Fully customizable reference code prefixes and zero-padded sequence lengths for invoices, products, clients, and suppliers. 📄 Professional PDF & Excel Exports: High-resolution vector PDF generation via mPDF, alongside structured table exports to Excel / CSV. 📈 Interactive Analytics Dashboard: Real-time KPI summary cards and dynamic charts illustrating sales, purchases, and payment collection statuses. 🔍 Comprehensive Module Descriptions 1. 📊 Executive Dashboard & Analytics Real-Time KPI Cards: Total Sales (Annual & Monthly): Gross revenue paired with total executed sales invoice volume. Total Purchases: Aggregate procurement spend for cash-flow and expenditure analysis. Best-Selling Product: Identification of top-performing inventory items with total units sold. Top-Performing Sales Employee: Individual revenue generation and performance tracking for sales representatives. Interactive Sales Statistical Chart: Dynamic timeframe toggling: Daily, Weekly, Monthly, or Yearly. Dual Y-Axis visualization correlating gross monetary revenue against the total count of finalized invoices over the selected timeframe. Sales Payment Status Breakdown: Segmentation of receivables into: Unpaid, Partially Paid, and Paid. Multi-year historical filtering to benchmark payment collection efficiency over past and current fiscal periods. 2. 👥 Administration & Human Resources (HR) Users & Employees Management: Comprehensive personnel profiling (Full Name, Date of Birth, Gender, Verified Email, Validated Phone Numbers, Residential Address). User Account Classification: System User (equipped with dashboard authentication credentials) vs. Non-System Employee (field/desk staff without direct system access). Relational mapping to branch, administrative department, and official job title. Employee avatar upload with instant image preview. Direct account lifecycle management (Active / Banned status toggles). Organizational Chart: Administrative Departments (Permission Categories): Definition and grouping of organizational divisions with dual Arabic and English naming. Jobs Management: Corporate job title catalog backed by inline, real-time auto-translation. 3. 🏢 Branches Management Branches Directory: Multi-branch configuration with bilingual naming (Arabic & English). Detailed physical address logging in both languages. Assignment of a Responsible Manager per branch. Automated relational binding of personnel, storage warehouses, and commercial transactions to their parent branch. Data Integrity Safeguards: Validation rules that block branch deletion if linked to active staff, live stock, or open transactions. 4. 🛡️ Role-Based Access Control (RBAC) Roles Management: Custom role creation (Super Admin, Admin, Sales Rep, Accountant, Warehouse Keeper, Staff). Direct mapping of granular permission bundles to each role. Automated bilingual translation of role designations. Granular Permissions: Logical grouping of access privileges by module (Sales, Purchases, Warehouses, HR, Settings). Direct Permissions: Capability to grant specific permission overrides directly to an individual user, bypassing or expanding upon their base role. Hierarchical tree view displaying the user's aggregate inherited and direct permissions. 5. 💼 Sales & Client Management Clients Management: Comprehensive client records containing Commercial Name, Commercial Registration (CR), Tax Identification Number (TIN), Address, and Contact Details. Multiple Contacts Directory: Ability to record and maintain multiple points of contact per corporate account. Opening Balance: Ledger opening balance setup with effective date, modification tracking, and complete audit logging. Account Status Control: Suspend or activate client accounts to immediately restrict credit transactions upon default. Statement of Account: Detailed ledger summarizing transaction history, issued invoices, settled payments, and current outstanding liabilities. Interactive Livewire Sales Invoices: Instant Line-Item Entry: Real-time product search, inline description modifications, quantity updates, and dynamic unit pricing. Multi-Warehouse Fulfillment: Ability to source line items on the exact same invoice from multiple distinct warehouses. Dual-Tax Support: Simultaneous application of two separate tax rates per line item (e.g., 14% VAT + 2% Advance Income Tax / Stamp Duty). Flexible Discounts: Application of discounts as either a percentage or a fixed monetary deduction. Freight & Handling Fees: Dedicated fields for delivery and shipping costs, automatically factored into the net total. Down Payments: Direct capture of initial deposits during invoice creation, noting payment gateway/method and transaction reference numbers. Document Attachments: Secure file uploads for contracts and delivery slips with automated collision-free file renaming, inline previewing, and download access. Documents, Printouts & Output Deliverables: Print-Ready Layouts: Clean, branded invoice print templates with embedded invoice barcodes, QR codes, and official corporate headers. High-Fidelity PDF Export: Precise, vector-grade PDF compilation using mPDF. One-Click Email Dispatch: Direct automated transmission of finalized invoices to client email addresses. Package Stickers (PDF): Standardized warehouse carton labels displaying shipping destinations and consignee details. Delivery Stickers (PDF): Clear handling and routing stickers designed for freight carriers and delivery drivers. Receipt Checklists (PDF): Itemized manifest printouts designed for customer sign-off upon physical delivery. Payments & Receipt Vouchers: Progressive installment collection logs (Cash, Cheque, Bank Wire). Generation and PDF export of official Receipt Vouchers for every captured transaction or down payment. Real-time automated status transitions (Unpaid, Partially Paid, Paid). Sales Returns (Credit Notes): Processing of returned merchandise with automated restocking into originating warehouses and instant client ledger balance adjustments. 6. 🛒 Purchases & Supplier Management Suppliers Management: Centralized vendor database cataloging corporate profiles, contact persons, and terms. Configuration of supplier opening balance, default billing currency, CR number, and Tax ID. Vendor account activation and suspension toggles. Quick-view vendor metrics tracking unbilled balances, outstanding payables, and recent order history. Purchase Invoices: Structured recording of incoming vendor bills, including issue dates, payment due dates, and supplier invoice reference codes. Direct assignment of purchased lines to designated receiving warehouses. Receiving Status Tracking: Two-stage warehouse verification (Under Receive vs. Received), triggering automated inventory increments upon final confirmation. Supplier Payment Reconciliation: Processing full, partial, or advance payments while logging cheque numbers, wire transfers, and bank references. Export and printing of official Payment Vouchers (PDF) for all vendor disbursements. Direct email delivery of purchase orders and invoices to suppliers. Purchased Items Barcode Generation: A dedicated operational feature enabling receiving staff to immediately generate and print adhesive barcode labels for incoming quantities right at the receiving dock. 7. 📦 Inventory & Warehouse Management Warehouse Directory: Definition of multiple physical storage locations, receiving addresses, and assigned warehouse supervisors. Detailed transaction logs tracking stock inflows, outflows, and current on-hand quantities per facility. Inventory Valuation & Profitability Analytics: Real-time tracking of gross item turnover across sales, purchases, and customer/vendor returns. Comparative analytics comparing latest purchase price and Weighted Average Cost (WAC) against current retail listing prices. Total inventory valuation at cost vs. projected market valuation at selling price. Calculation of Expected Profit Margins to evaluate liquidity requirements and return on inventory investments. Stocktaking Sheets: Generation of print-ready physical inventory count sheets to reconcile theoretical ledger balances against physical floor stock. Stock Transfers & Adjustments: Audited recording of manual stock additions, write-offs, and inter-warehouse balance transfers. 8. 🏷️ Product Catalog & Barcode Engine 4-Tier Product Classification: Sections: Top-level broad operational divisions. Categories: Functional groups nested under sections. Subcategories: Granular classifications nested within categories. Brands: Commercial trade names with direct export to Excel. Product Profile & Pricing Configuration: Detailed naming, rich descriptions, supplier reference codes, and high-resolution product imagery. Multi-Tier Pricing: Purchase/Cost Price, Primary Selling Price, Floor Price (Lowest Sell Price), and Target Markup / Profit Margin percentage. Tax rule assignments (individual configurations for Primary and Secondary taxes). Low-Stock Alerts: Configurable reorder points that trigger automated dashboard warnings upon inventory depletion. Units of Measurement (UOM) Templates: Definition of primary and secondary packaging units (Piece, Dozen, Carton, Kilogram, Pallet). Setup of exact Conversion Factors between base units and bulk units to ensure error-free stock decrementation. Barcode & SKU Engine: Automatic generation of unique alphanumeric SKU codes linked to the global sequential numbering engine. Dynamic rendering of standard linear barcodes (1D Code128) with real-time visual previews during data entry. Mass adhesive label sheet printing with customizable label quantities per item. 9. ⚙️ System Settings & Customization General Company Profile: Corporate Legal Name, Commercial Registration (CR), Tax ID (VAT/TIN), and Postal Code. Telephones, mobile lines, fax numbers, physical headquarters address, city, and country. Official Company Logo: Centralized image repository automatically projected across all invoice headers, export documents, and reports. Base system currency, currency symbol, and exchange rates for supported secondary currencies. Global timezone selection and default application language. Sequential Numbering Engine: Customizable sequence patterns for all database entities (Sales Invoices, Purchase Invoices, Products, Suppliers, Clients, Users, Warehouses). Custom prefix configurations (e.g., SLS-INV-, PUR-INV-, PRO-, USER-). Configurable digit lengths with automated left-hand zero-padding. Tax Configuration: Bilingual tax rate definitions (e.g., Value Added Tax, Withholding Tax, Stamp Duty). Tax rate percentages and global toggles for tax-inclusive or tax-exclusive pricing defaults. 10. 🌐 Localization & Auto-Translation Engine Native Bilingual Architecture (AR / EN): Instant, context-preserving language toggling via the global top navigation bar. Native bidirectional document rendering supporting both Right-to-Left (RTL) and Left-to-Right (LTR) page layouts. Integration of corporate typography (Tajawal and Noto Kufi Arabic) to ensure legibility and professional visual balance. Instant Auto-Translation Engine: Deep programmatic integration utilizing stichoza/google-translate-php, allowing system operators to auto-translate department names, roles, job titles, and branch descriptions into the corresponding alternate language field at the click of a button.

Technologies Used