Portal Features

Pages & Navigation

The portal has role-based navigation. Available pages depend on user role:

All Users

• Projects (/project) — Supplier/e-commerce project management
• Documentation (/documentation) — Documentation hub with search
• Support (/support) — Support ticket system

Admin & Developer

• Dashboard (/dashboard) — Statistics and monitoring
• Tenant Manager (/tenant) — Deploy and rebuild tenants
• Ports (/ports) — Port registry and asset management
• Nginx URLs (/nginx-urls) — Service URL overview
• Gatekeeper (/gatekeeper) — IP whitelist management
• CRM Leads (/leads) — Lead pipeline management

Admin Only

• Admin Panel (/admin) — User, client, and project management

Tenant Manager

The tenant manager enables deploying code changes and rebuilding containers:

Deploy Projects

1. Select a dev project
2. Choose target tenants (multi-select)
3. Select components (backend, storefront, or both)
4. Start deployment — copies code from magic_development to selected tenants

Rebuild Process

1. Select tenant(s) to rebuild
2. Choose backend, storefront, or both
3. Sequential rebuild with real-time progress polling
4. Logs deployment history with timestamps

Documentation Hub

Structure

• Categories — Organized by topic
• Documents — Markdown with Mermaid diagram support
• System Updates — Severity-tagged announcements
• Release Notes — Version history

Search

Full-text search across all documentation articles, filtering by category.

Support System

Ticket Lifecycle

Open → In Progress → Waiting Customer / Waiting Internal → Resolved → Closed
                                                        ↳ Archived (soft delete, restorable)

Features

• Category-based organization
• Staff assignment
• Comment threads with timestamps
• Reporter management
• Knowledge base articles
• URL deep-linking: Share ticket URLs via ?ticket={id} — ticket opens automatically
• Dev Project integration: Staff can create linked dev projects directly from tickets, with bidirectional navigation between Portal and Medusa admin

Ticket Detail Sidebar

The ticket detail view uses a structured sidebar with four sections:

1. Info card — Ticket number (monospace, top-right), created/modified/resolved/archived dates on separate rows
2. Beheer card — All management controls in a single card with visual group dividers:
   • Group 1: Status + Priority dropdowns
   • Group 2: Assignment, Category, Tenant, Agent dropdowns
   • Group 3: Dev Project link (clickable to Medusa admin) or “Dev Project Aanmaken” button
3. Deploy Flow — Compact progress indicator showing ticket lifecycle stages (Open → In Progress → Waiting → Resolved → Closed) with connected dots
4. Archive — Archive/restore action at the bottom

Support Tabs

The support page has three navigation tabs: Tickets, Behandelaars (Staff), and Melders (Reporters). Active tabs are styled with a pink bottom border and pink text on a transparent background. CSS is scoped to .support-tabs .tab-btn to avoid conflicts with global tab styles.

CRM Lead Manager

Pipeline Stages

New → Contacted → Qualified → Proposal → Negotiation → Won / Lost / Churned

Lead Features

• Priority levels: Hot, Warm, Cold
• Activity logging (calls, meetings, emails)
• Task management with due dates
• Quick call logging
• Conversion tracking
• CRM statistics dashboard

File Management

Supplier Projects

• Hierarchical project tree navigation
• Section-based file organization
• Upload/download with metadata tracking
• OnlyOffice integration for document editing
• Notes per section

E-Commerce Projects

• File management organized by sections
• Office document editing (OnlyOffice)
• File versioning via upload timestamps

Customer Dashboard

Client users have access to a dedicated customer dashboard:

• Endpoint: /api/customer-dashboard
• Overview of assigned projects and their status
• Quick access to support tickets and documentation
• Role-restricted: only visible to users with client role

Password Management

• Users can change their password via /api/auth/change-password
• must_change_password flag on user record forces password change on first login
• Password reset emails with activation links
• Bcrypt-hashed passwords stored in MySQL users table

System Updates & Alerts

• Endpoint: /api/updates
• Severity levels: critical, high, medium, low
• System-wide announcements displayed on the documentation hub
• Used for security alerts, feature announcements, and maintenance notices

Email System

SMTP Configuration

• Server: mail.magiceverse.nl:587
• From: portal@magiceverse.nl
• Branded HTML templates with Magic e-VERSE styling

Email Types

• Welcome email with temporary password
• Password reset with activation link
• User invitations
• 2FA codes via WhatsApp (Facebook Graph API)