# mujeeburahman1124/visa-portal-company-management architecture

> Architecture diagram of the GitHub repository mujeeburahman1124/visa-portal-company-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mujeeburahman1124/visa-portal-company-management
- Repository: https://github.com/mujeeburahman1124/visa-portal-company-management

## Overview

VISA TRACK is a global visa-management portal for staff, applicants, agents, and suppliers. Staff initiate and manage applications; the system applies visa rules, tracks lifecycle stages, and supports document collection and verification, while customer and partner portals expose application information and related services. Payments, notifications, tasks, appointments, reporting, and workforce operations form supporting product branches. The sampled excerpts show several service calls; other links rely on the SOURCE INDEX references or are omitted where dispatch details are not visible.

Main entry points: [`app/Config/Database.php`](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Config/Database.php) (Database connection), [`app/Controllers/ApplicationController.php`](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/ApplicationController.php) (Application management), [`public/index.php`](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/public/index.php) (Web entry and routing), [`app/Controllers/PaymentController.php`](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/PaymentController.php) (Payments and invoices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and access"]
  node_web["Web entry and routing<br/>[index.php]"]
  node_auth["Authentication<br/>[AuthMiddleware.php]"]
  node_database["Database connection<br/>[Database.php]"]
  node_schema["Schema bootstrap"]
end

subgraph group_cases["Visa casework"]
  node_application["Application management"]
  node_application_api["Application API"]
  node_visa_rules["Visa eligibility and pricing"]
  node_stages["Stage transitions"]
  node_customers["Applicant records"]
  node_duplicates["Duplicate detection"]
  node_documents["Document management"]
  node_checklist["Document checklist"]
  node_verification["Document verification"]
  node_expiry["Document expiry"]
end

subgraph group_portals["Customer and partner portals"]
  node_agent_portal["Agent portal"]
  node_customer_portal["Customer portal"]
  node_supplier_portal["Supplier portal"]
  node_tracking["Application tracking"]
end

subgraph group_finance["Payments and finance"]
  node_payments["Payments and invoices"]
  node_payment_links["Payment links"]
  node_wallets["Wallets<br/>[WalletService.php]"]
  node_finance_service["Finance calculations<br/>[FinanceService.php]"]
end

subgraph group_operations["Operations and communications"]
  node_appointments["Appointments"]
  node_tasks["Tasks and action center<br/>[TaskController.php]"]
  node_health["Application health"]
  node_notifications["Notifications"]
  node_email["Email delivery<br/>[EmailService.php]"]
  node_audit["Audit logging<br/>[AuditService.php]"]
  node_staff_ops["Staff and attendance"]
  node_reports["Reports and dashboard"]
end

node_staff(("Staff user"))
node_customer(("Customer"))
node_partner(("Agent or supplier"))

node_staff -->|"uses"| node_web
node_customer -->|"uses"| node_web
node_partner -->|"uses"| node_web
node_web -->|"bootstraps"| node_schema
node_web -->|"routes"| node_application
node_web -->|"routes"| node_customers
node_web -->|"routes"| node_documents
node_web -->|"routes"| node_payments
node_web -->|"routes"| node_tracking
node_application -->|"checks access"| node_auth
node_application -->|"resolves rules"| node_visa_rules
node_application -->|"uses transitions"| node_stages
node_application -->|"uses checklist"| node_checklist
node_application -->|"checks duplicates"| node_duplicates
node_application -->|"calculates health"| node_health
node_application -->|"uses finance"| node_payments
node_application_api -->|"transitions stage"| node_stages
node_application -->|"queries"| node_database
node_application_api -->|"queries"| node_database
node_customers -->|"checks duplicates"| node_duplicates
node_customers -->|"queries"| node_database
node_documents -->|"verifies documents"| node_verification
node_documents -->|"checks expiry"| node_expiry
node_documents -->|"queries"| node_database
node_checklist -->|"checks expiry"| node_expiry
node_verification -->|"updates health"| node_health
node_verification -->|"notifies"| node_notifications
node_payments -->|"uses calculations"| node_finance_service
node_payments -->|"uses wallets"| node_wallets
node_payments -->|"uses links"| node_payment_links
node_payment_links -->|"uses calculations"| node_finance_service
node_payment_links -->|"uses wallets"| node_wallets
node_payment_links -->|"notifies"| node_notifications
node_notifications -->|"dispatches email"| node_email
node_notifications -->|"sends updates"| node_customer
node_agent_portal -.->|"queries"| node_database
node_customer_portal -.->|"queries"| node_database
node_supplier_portal -.->|"queries"| node_database
node_tracking -.->|"queries"| node_database
node_appointments -.->|"queries"| node_database
node_tasks -.->|"queries"| node_database
node_health -->|"reads records"| node_database
node_audit -->|"writes logs"| node_database
node_staff_ops -.->|"queries"| node_database
node_reports -.->|"queries"| node_database
node_schema -->|"initializes schema"| node_database

click node_web "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/public/index.php"
click node_auth "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Middleware/AuthMiddleware.php"
click node_database "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Config/Database.php"
click node_schema "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Database/DatabaseBootstrapper.php"
click node_application "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/ApplicationController.php"
click node_application_api "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/Api/ApplicationApiController.php"
click node_visa_rules "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/VisaRuleEngineService.php"
click node_stages "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/StageTransitionService.php"
click node_customers "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/CustomerController.php"
click node_duplicates "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DuplicateDetectionService.php"
click node_documents "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/DocumentController.php"
click node_checklist "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentChecklistService.php"
click node_verification "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentVerificationService.php"
click node_expiry "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentExpiryService.php"
click node_agent_portal "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/AgentPortalController.php"
click node_customer_portal "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/PortalController.php"
click node_supplier_portal "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/SupplierPortalController.php"
click node_tracking "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/TrackingController.php"
click node_payments "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/PaymentController.php"
click node_payment_links "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/PaymentLinkService.php"
click node_wallets "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/WalletService.php"
click node_finance_service "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/FinanceService.php"
click node_appointments "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/AppointmentController.php"
click node_tasks "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/TaskController.php"
click node_health "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/HealthCalculatorService.php"
click node_notifications "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/NotificationService.php"
click node_email "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/EmailService.php"
click node_audit "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/AuditService.php"
click node_staff_ops "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/StaffController.php"
click node_reports "https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/ReportController.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_auth,node_database,node_schema,node_staff toneBlue
class node_application,node_application_api,node_visa_rules,node_stages,node_customers,node_duplicates,node_documents,node_checklist,node_verification,node_expiry toneAmber
class node_agent_portal,node_customer_portal,node_supplier_portal,node_tracking toneMint
class node_payments,node_payment_links,node_wallets,node_finance_service toneRose
class node_appointments,node_tasks,node_health,node_notifications,node_email,node_audit,node_staff_ops,node_reports,node_customer,node_partner toneIndigo
```

## Components

### Runtime and access

- [Web entry and routing](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/public/index.php): `public/index.php`
- [Authentication](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Middleware/AuthMiddleware.php): `app/Middleware/AuthMiddleware.php`
- [Database connection](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Config/Database.php): `app/Config/Database.php`
- [Schema bootstrap](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Database/DatabaseBootstrapper.php): `app/Database/DatabaseBootstrapper.php`

### Visa casework

- [Application management](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/ApplicationController.php): `app/Controllers/ApplicationController.php`
- [Application API](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/Api/ApplicationApiController.php): `app/Controllers/Api/ApplicationApiController.php`
- [Visa eligibility and pricing](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/VisaRuleEngineService.php): `app/Services/VisaRuleEngineService.php`
- [Stage transitions](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/StageTransitionService.php): `app/Services/StageTransitionService.php`
- [Applicant records](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/CustomerController.php): `app/Controllers/CustomerController.php`
- [Duplicate detection](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DuplicateDetectionService.php): `app/Services/DuplicateDetectionService.php`
- [Document management](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/DocumentController.php): `app/Controllers/DocumentController.php`
- [Document checklist](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentChecklistService.php): `app/Services/DocumentChecklistService.php`
- [Document verification](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentVerificationService.php): `app/Services/DocumentVerificationService.php`
- [Document expiry](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/DocumentExpiryService.php): `app/Services/DocumentExpiryService.php`

### Customer and partner portals

- [Agent portal](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/AgentPortalController.php): `app/Controllers/AgentPortalController.php`
- [Customer portal](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/PortalController.php): `app/Controllers/PortalController.php`
- [Supplier portal](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/SupplierPortalController.php): `app/Controllers/SupplierPortalController.php`
- [Application tracking](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/TrackingController.php): `app/Controllers/TrackingController.php`

### Payments and finance

- [Payments and invoices](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/PaymentController.php): `app/Controllers/PaymentController.php`
- [Payment links](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/PaymentLinkService.php): `app/Services/PaymentLinkService.php`
- [Wallets](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/WalletService.php): `app/Services/WalletService.php`
- [Finance calculations](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/FinanceService.php): `app/Services/FinanceService.php`

### Operations and communications

- [Appointments](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/AppointmentController.php): `app/Controllers/AppointmentController.php`
- [Tasks and action center](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/TaskController.php): `app/Controllers/TaskController.php`
- [Application health](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/HealthCalculatorService.php): `app/Services/HealthCalculatorService.php`
- [Notifications](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/NotificationService.php): `app/Services/NotificationService.php`
- [Email delivery](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/EmailService.php): `app/Services/EmailService.php`
- [Audit logging](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Services/AuditService.php): `app/Services/AuditService.php`
- [Staff and attendance](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/StaffController.php): `app/Controllers/StaffController.php`
- [Reports and dashboard](https://github.com/mujeeburahman1124/visa-portal-company-management/blob/main/app/Controllers/ReportController.php): `app/Controllers/ReportController.php`

### Other components

- **Staff user**
- **Customer**
- **Agent or supplier**

## Connections

- Staff user → Web entry and routing: uses (evidence: `public/index.php`)
- Customer → Web entry and routing: uses (evidence: `public/index.php`)
- Agent or supplier → Web entry and routing: uses (evidence: `public/index.php`)
- Web entry and routing → Schema bootstrap: bootstraps (evidence: `public/index.php`)
- Web entry and routing → Application management: routes (evidence: `public/index.php`)
- Web entry and routing → Applicant records: routes (evidence: `public/index.php`)
- Web entry and routing → Document management: routes (evidence: `public/index.php`)
- Web entry and routing → Payments and invoices: routes (evidence: `public/index.php`)
- Web entry and routing → Application tracking: routes (evidence: `public/index.php`)
- Application management → Authentication: checks access (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Visa eligibility and pricing: resolves rules (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Stage transitions: uses transitions (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Document checklist: uses checklist (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Duplicate detection: checks duplicates (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Application health: calculates health (evidence: `app/Controllers/ApplicationController.php`)
- Application management → Payments and invoices: uses finance (evidence: `app/Controllers/ApplicationController.php`)
- Application API → Stage transitions: transitions stage (evidence: `app/Controllers/Api/ApplicationApiController.php`)
- Application management → Database connection: queries (evidence: `app/Controllers/ApplicationController.php`)
- Application API → Database connection: queries (evidence: `app/Controllers/Api/ApplicationApiController.php`)
- Applicant records → Duplicate detection: checks duplicates (evidence: `app/Controllers/CustomerController.php`)
- Applicant records → Database connection: queries (evidence: `app/Controllers/CustomerController.php`)
- Document management → Document verification: verifies documents (evidence: `app/Controllers/DocumentController.php`)
- Document management → Document expiry: checks expiry (evidence: `app/Controllers/DocumentController.php`)
- Document management → Database connection: queries (evidence: `app/Controllers/DocumentController.php`)
- Document checklist → Document expiry: checks expiry (evidence: `app/Services/DocumentChecklistService.php`)
- Document verification → Application health: updates health (evidence: `app/Services/DocumentVerificationService.php`)
- Document verification → Notifications: notifies (evidence: `app/Services/DocumentVerificationService.php`)
- Payments and invoices → Finance calculations: uses calculations (evidence: `app/Controllers/PaymentController.php`)
- Payments and invoices → Wallets: uses wallets (evidence: `app/Controllers/PaymentController.php`)
- Payments and invoices → Payment links: uses links (evidence: `app/Controllers/PaymentController.php`)
- Payment links → Finance calculations: uses calculations (evidence: `app/Services/PaymentLinkService.php`)
- Payment links → Wallets: uses wallets (evidence: `app/Services/PaymentLinkService.php`)
- Payment links → Notifications: notifies (evidence: `app/Services/PaymentLinkService.php`)
- Notifications → Email delivery: dispatches email (evidence: `app/Services/NotificationService.php`)
- Notifications → Customer: sends updates (evidence: `app/Services/NotificationService.php`)
- Agent portal → Database connection: queries
- Customer portal → Database connection: queries
- Supplier portal → Database connection: queries
- Application tracking → Database connection: queries
- Appointments → Database connection: queries
- Tasks and action center → Database connection: queries
- Application health → Database connection: reads records (evidence: `app/Services/HealthCalculatorService.php`)
- Audit logging → Database connection: writes logs (evidence: `app/Services/AuditService.php`)
- Staff and attendance → Database connection: queries
- Reports and dashboard → Database connection: queries
- Schema bootstrap → Database connection: initializes schema (evidence: `app/Database/DatabaseBootstrapper.php`)
