📋 Portfolio Project: Enterprise Laundry Management System

⚠️ Confidentiality Notice: Specific details omitted to maintain confidentiality. Code samples are conceptual implementations.


🎯 Project Overview

Project Type: Enterprise Laundry Operations & Monitoring System

Role: Full-Stack Developer

Industry: Laundry Service / Operations Management

Status: Production - actively used by operations team


💡 Summary

Built an enterprise-level laundry management system end-to-end, used to manage high-volume laundry business operations.

  • Multi-stage process tracking for laundry workflow (receiving → processing → delivery)
  • Dual database architecture for integration with HR/attendance systems
  • Multi-level approval workflows for critical operations
  • Role-based access control with 8 distinct user roles
  • Comprehensive reporting with Excel & PDF export

The system is actively used by operational teams daily.


🛠️ Technology Stack

Backend

TechnologyPurpose
Laravel 10Core PHP Framework
PHP 8.2+Server-side Language
MySQLDual Database Architecture
Spatie PermissionRole-Based Access Control
Maatwebsite ExcelExcel Import/Export
DomPDFPDF Generation
Intervention ImageImage Processing

Frontend

TechnologyPurpose
Vue.js 3Reactive UI Framework
Inertia.jsModern SPA Architecture
Tailwind CSS 3Utility-First Styling
Ant Design VueEnterprise UI Components
Element PlusAdditional UI Components
DataTablesAdvanced Data Grid

📊 Project Scale

30+
Controllers
70+
Database Models
80+
Migrations
300+
API Routes
100+
Vue.js Pages
8
User Roles
15+
Approval Workflows

✨ Key Features Developed

🔄 1. Multi-Stage Process Tracking

Tracking system for laundry workflow with multiple processing stages.

What I Built:

  • • Real-time status updates per item
  • • Stage-based processing with dedicated UI per stage
  • • Rollback/cancel capability for each stage
  • • Operator assignment and accountability tracking
  • • History log for audit purposes

Technical Highlights:

  • • State machine pattern for workflow management
  • • Optimized queries for real-time dashboard
  • • Session-based operator tracking

💾 2. Dual Database Architecture

Integration of main system with existing HR/attendance system.

  • • Multi-connection database configuration
  • • Cross-database data synchronization
  • • Unified user experience across systems

✅ 3. Multi-Level Approval Workflow System

Approval system for critical operations requiring oversight.

Covered Operations:

  • • Data modifications (create/edit/delete)
  • • Inventory adjustments
  • • Transaction cancellations
  • • Master data changes
  • • Dedicated approval tables per entity type
  • • Status flow: Pending → Approved/Rejected
  • • Role-based approval authority
  • • Complete audit trail
  • • Notification system for pending approvals

🔐 4. Role-Based Access Control (RBAC)

Role CategoryDescription
Admin/ITFull system access, user management
ExecutiveReports, final approvals
SupervisorMonitoring, team approvals
OperatorDay-to-day operations
Limited RolesSpecific function access
  • • Permission-based middleware
  • • Dynamic menu based on roles
  • • Granular feature access control
  • • Role hierarchy for approvals

📦 5. Inventory & Stock Management

  • • Stock input with approval workflow
  • • Usage tracking per operation
  • • Real-time availability calculation
  • • Low stock alerts
  • • Stock history and audit trail

📊 6. Transaction & POS System

  • • Cart management with real-time validation
  • • Barcode scanning integration
  • • Multi-location support
  • • Invoice generation
  • • Transaction history with advanced filtering

👥 7. Customer/Client Management

  • • Customer data management with approval workflow
  • • Category/group management
  • • Transaction history per customer
  • • Bulk operations support

💬 8. Internal Ticketing System

  • • Ticket creation and tracking
  • • Chat thread per ticket
  • • Status workflow (Open → In Progress → Resolved)
  • • Assignment and escalation

📈 9. Comprehensive Reporting System

  • • Operational reports (daily/weekly/monthly)
  • • Performance reports per operator/location
  • • Inventory reports
  • • Export: Excel, PDF

📱 10. Mobile API

  • • RESTful API endpoints
  • • Token-based authentication
  • • Optimized responses for mobile

🏗️ Architecture Decisions

Inertia.js SPA Architecture

Challenge: Need SPA experience without complexity of separate API development.

Solution: Inertia.js as bridge between Laravel and Vue.js.

Result: Full SPA experience with server-side routing, direct Eloquent access, reduced development time.

Dual Database Integration

Challenge: Integration with existing HR system without disrupting main operations.

Solution: Laravel multi-database configuration with model-level connection.

Result: Seamless data sync, single codebase, unified user experience.

Stage-Based Processing

Challenge: Track items through multiple processing stages with different operators.

Solution: Status-based tracking with dedicated controllers and views per stage.

Result: Real-time visibility, bottleneck detection, operator accountability.


🔧 Technical Challenges Solved

1. Complex Multi-Stage Workflow

Challenge: Multiple processing stages with rollback capability.

Solution: State machine pattern with cancel functions, history logging per transition.

2. Real-Time Stock Validation

Challenge: Stock accuracy accounting for pending transactions.

Solution: Custom calculation method that considers all states.

3. Multi-Role Permission Complexity

Challenge: 8 different roles with overlapping permissions.

Solution: Spatie Permission with middleware-based route protection.

4. Large-Scale Data Exports

Challenge: Export thousands of records without memory issues.

Solution: Chunked processing, lazy collections, streaming responses.


🎯 Skills Demonstrated

CategorySkills
Full-Stack DevelopmentLaravel + Vue.js + Inertia.js
Database DesignComplex relational schema, Multi-database
API DevelopmentRESTful patterns, Mobile-ready API
SecurityRBAC, Authentication, Authorization
PerformanceQuery optimization, Caching strategies
Workflow DesignState machines, Approval systems
ReportingExcel/PDF generation
IntegrationBarcode, Multi-system sync

💡 Key Learnings

  1. 1. Enterprise Workflow Complexity: Real-world business processes often require multi-level approvals - designing flexible approval patterns early saves significant refactoring later.
  2. 2. Multi-Database Architecture: Integrating with existing systems requires careful planning around data consistency and connection management.
  3. 3. State Machine Importance: Complex workflows with multiple stages greatly benefit from formal state machine patterns for maintainability.
  4. 4. Role-Based Design: Starting with clear role definitions and permission matrices makes implementation much smoother.
  5. 5. Audit Trail Value: Comprehensive logging is not only for compliance but also invaluable for debugging and user support.

Specific implementation details have been omitted to maintain confidentiality.