🏭 Wardah ERP - Enterprise Manufacturing System

نظام وردة المتطور لإدارة التصنيع وتكاليف المراحل

---

🚀 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

First time setup? See Installation Guide

---

📚 Documentation

📖 Complete Documentation Index

Essential Guides:

• 🚀 Getting Started
• 🗄️ Database Setup
• ⚡ Performance Optimization

Features:

• 📊 Accounting Module
• 🏭 Manufacturing
• 📦 Inventory Management
• 👥 HR Module

---

✨ Features

Core Modules

• ✅ Process Costing - Advanced stage costing with real-time calculations
• ✅ Double-Entry Accounting - Full GL, Trial Balance, Financial Reports
• ✅ Inventory Management - AVCO valuation, Stock Movements, Adjustments
• ✅ Manufacturing Orders - BOM, Routing, Work Centers, Quality Control
• ✅ Purchase & Sales - Invoices, Vouchers, Collections, Payments
• ✅ HR Management - Payroll, Attendance, Leaves, Settlements

Technical Features

• ⚡ 40-60% Performance Improvement - Optimized with indexes, views, caching
• 🌐 Bilingual Support - Full Arabic/English with RTL
• 🔐 Multi-Tenant - Organization-based data isolation
• 📱 Responsive Design - Works on all devices
• 🎨 Modern UI - shadcn/ui components with dark mode

---

🛠️ Tech Stack

• Frontend: React 18 + TypeScript + Vite
• UI: Tailwind CSS + shadcn/ui
• State: Zustand + React Query
• Backend: Supabase (PostgreSQL)
• Forms: React Hook Form + Zod
• Charts: Recharts
• i18n: i18next

---

📁 Project Structure

wardah-process-costing/
├── src/                    # Frontend source code
│   ├── components/         # Reusable components
│   ├── features/           # Feature modules
│   ├── services/           # API services
│   └── lib/               # Utilities
│
├── docs/                   # Documentation
│   ├── getting-started/    # Installation & setup
│   ├── features/          # Feature documentation
│   ├── deployment/        # Deployment guides
│   └── troubleshooting/   # Common issues
│
├── sql/                   # Database scripts
│   ├── migrations/        # Schema migrations
│   ├── functions/         # RPC functions
│   ├── views/             # Database views
│   └── performance/       # Performance scripts
│
├── scripts/                # Automation scripts
│   ├── deploy/            # Deployment scripts
│   ├── check/             # Verification scripts
│   └── import/            # Data import scripts
│
└── tests/                  # Test files

---

🧪 Testing

# Run all tests
npm run test

# Run with coverage
npm run test:coverage

# Run specific tests
npm run test -- --filter="process-costing"

Metric	Value
Total Tests	1862
Test Files	85
Status	✅ All Passing

Key Test Areas:

• Process Costing Service (29 tests)
• Organization & Multi-Tenant (21 tests)
• RBAC Permissions (16 tests)
• Stock Adjustments (20 tests)
• UI Components (200+ tests)

See Testing Strategy for details

---

🎯 Performance

Module	Load Time	Status
Manufacturing Orders	385ms	⚡ Fast
Journal Entries	407ms	⚡ Fast
Trial Balance	400ms	⚡ Fast

See Performance Guide for details

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

---

📞 Support

• 📖 Full Documentation
• 🐛 Report Issues
• 💬 Discussions

---

📄 License

See LICENSE file for details.

---

🎉 Acknowledgments

Built with ❤️ for the manufacturing industry.

Status: ✅ Production Ready | Version: 2.0.0