╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║   ██████╗ █████╗ ██████╗ ██╗███╗   ██╗███████╗████████╗       ║
║  ██╔════╝██╔══██╗██╔══██╗██║████╗  ██║██╔════╝╚══██╔══╝       ║
║  ██║     ███████║██████╔╝██║██╔██╗ ██║█████╗     ██║          ║
║  ██║     ██╔══██║██╔══██╗██║██║╚██╗██║██╔══╝     ██║          ║
║  ╚██████╗██║  ██║██████╔╝██║██║ ╚████║███████╗   ██║          ║
║   ╚═════╝╚═╝  ╚═╝╚═════╝ ╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝          ║
║                                                               ║
║              ╦ ╦╦ ╦╔╗                                         ║
║              ╠═╣║ ║╠╩╗                                        ║
║              ╩ ╩╚═╝╚═╝                                        ║
║                                                               ║
║    > System Initialized                                       ║
║    > Connecting modules...                                    ║
║    > Ready to orchestrate your organization                   ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

Imagine a single platform where every thread of your organization-people, resources, maintenance schedules, purchases, and audits-weaves together into a living tapestry of operational clarity.

CabinetHub was born from a simple napkin sketch and a bold question: What if managing complexity didn't have to feel complex?

Built for organizations that refuse to settle for fragmented tools and scattered data, CabinetHub transforms the chaos of daily operations into a symphony of coordinated action. It's not just a management system-it's a digital nervous system for your entire enterprise.

From tracking employee journeys to monitoring asset lifecycles, from purchase requests to real-time auditing, CabinetHub ensures that nothing slips through the cracks. Every click, every update, every decision leaves a traceable footprint in an audit trail designed for transparency and accountability.

This isn't about managing your organization. This is about orchestrating it.

At the heart of CabinetHub lies a carefully orchestrated seven-layer architecture-each layer a stepping stone from user interaction to data permanence, from request to insight.

At the center lives the Laravel Core, orchestrating every cabinet, every collaborator, every audit trail. Requests flow upward through authentication gates, business logic transformers, and data persistence layers. Insights flow downward through analytical engines and dashboard renderers.

And at every step, the EventAudit and SecurityAudit systems watch, record, and remember.

CabinetHub is more than a monolith-it's a constellation of interconnected modules, each serving a distinct purpose, yet all orbiting the same gravitational center.

At the heart of every organization are its people. The HR module manages:

• Collaborateurs - Employee profiles, contact details, career history
• Postes - Job positions, hierarchies, departmental structures
• Congés - Leave requests, approvals, balance tracking
• Présence - Attendance logging, shift management
• Evolution - Performance reviews, promotions, career progression

From desks to servers, every resource has a story. This module tells it:

• Ressources - Physical and digital assets inventory
• Categories - Classification schemas for organized retrieval
• Inventaires - Periodic audits, condition assessments
• Maintenance - Scheduled repairs, service history, downtime tracking

Each resource is tagged, tracked, and auditable-ensuring nothing disappears into the organizational void.

Every purchase tells a story of need, approval, and fulfillment:

• Demande_Achat - Purchase requisitions from any department
• Document_Achat - Contracts, invoices, proof of purchase
• EventAudit - Timestamp-stamped logs of every action
• SecurityAudit - Compliance checks, access monitoring

The audit trail ensures that every franc, every decision, every approval is eternally transparent.

Behind the interface, behind the workflows, lies the Entity-Relationship Model-the DNA of CabinetHub.

Every Collaborateur belongs to a Poste.
Every Ressource has a Category.
Every EventAudit echoes the action of a User.
Every Demande_Achat flows through an approval chain.

These aren't just tables-they're relationships. They're the invisible threads that bind an organization together, now made visible, queryable, and actionable.

The data model is designed for:

• Referential Integrity - No orphaned records, no broken links
• Audit Traceability - Every insert, update, delete is logged
• Scalable Extensibility - New modules can plug in without disruption

Every user embarks on a journey through CabinetHub. Here's what that journey looks like:

1. Login → Authentication gates verify identity and permissions
2. Dashboard Awakens → Real-time metrics, pending approvals, notifications
3. Interaction Begins → Requests are made, resources are booked, forms are submitted
4. Data Flows → Every action ripples through the system, updating states
5. Audits Echo → Silently, invisibly, every event is chronicled
6. Insights Emerge → Dashboards refresh, reports generate, trends surface

The user never sees the complexity. They only experience the clarity.

Ready to summon CabinetHub into your local environment? Follow the sacred steps:

• PHP >= 8.2
• Composer
• MySQL >= 5.7
• Node.js & NPM

# Clone the repository from the void
git clone https://github.com/zakariaayl/CabinetHub.git
cd CabinetHub

# Summon the dependencies
composer install

# Prepare the environment
cp .env.example .env

# Generate the application key
php artisan key:generate

# Configure your database in .env
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_DATABASE=cabinethub
# DB_USERNAME=root
# DB_PASSWORD=

# Forge the database schema
php artisan migrate --seed

# Awaken the server
php artisan serve

💡 Pro Tip: Use php artisan db:seed to populate your database with sample data-Collaborateurs, Ressources, and Audits-so you can explore the system immediately.

⚠️ Warning: Ensure your .env file points to a real MySQL database. CabinetHub's migrations are extensive and expect a relational database.

CabinetHub is not finished-it's evolving. Here are the coming planets in our galaxy:

• 🧠 Predictive Analytics - AI-driven insights into resource utilization, employee turnover, maintenance schedules
• ☁️ Cloud Integration - Sync with Google Drive, Dropbox, and cloud-based ERP systems
• 📱 Mobile App - Native iOS and Android companions for on-the-go management
• 🔒 Advanced RBAC - Granular role-based access control with custom permission sets
• 🌐 Multi-Tenancy - Host multiple organizations on a single CabinetHub instance
• 📊 BI Dashboards - Embedded Power BI / Tableau-style analytics

CabinetHub is crafted with care by:

• Zakariae Ayougil - Developer & System Architect
• Omar Lahjouji - Developer & System Architect

"Great systems are not coded-they're cultivated."

We believe that software should feel alive-responsive, intuitive, and ever-adapting to the needs of those who use it. CabinetHub is our attempt to bring that philosophy to life.

Every commit, every feature, every line of code is written with the user in mind. We don't build for machines. We build for humans.

   ⭐  ⭐  ⭐  ⭐  ⭐
 
  Every star is a signal.
  Every fork is a conversation.
  Every contribution is a gift.