# nekomaa110-gif/zeronet architecture

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

- Interactive diagram: https://gitdiagram.com/nekomaa110-gif/zeronet
- Repository: https://github.com/nekomaa110-gif/zeronet

## Overview

ZeroNet is a Laravel management panel, customer portal, and public website for MikroTik/FreeRADIUS-based WiFi businesses. Admins manage RADIUS subscribers and billing, generate and sell router-local hotspot vouchers, monitor routers, and operate WhatsApp messaging; customers check account status and invoices, request renewal, and submit payment evidence. Background commands and queued jobs support recurring synchronization and notifications. The README documents the main integrations and shared database; sampled source confirms selected controller, service, and authentication responsibilities. Other feature links are shown only where documented.

Main entry points: [`bootstrap/app.php`](https://github.com/nekomaa110-gif/zeronet/blob/master/bootstrap/app.php) (Laravel application), [`app/Http/Controllers/Admin`](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Http/Controllers/Admin) (Admin panel), [`app/Console/Commands`](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Console/Commands) (Scheduled commands), [`app/Http/Controllers/Site/SiteController.php`](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Site/SiteController.php) (Public website)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experiences"]
  node_laravel["Laravel application<br/>[app.php]"]
  node_publicsite["Public website<br/>[SiteController.php]"]
  node_customer["Customer portal"]
  node_admin["Admin panel"]
  node_identity["Admin identity and 2FA"]
end

subgraph group_operations["Subscriber operations"]
  node_activity["Activity logging"]
  node_billing["Invoices and renewals"]
  node_radius["RADIUS subscribers"]
  node_packages["Packages and coverage<br/>[Package.php]"]
end

subgraph group_network["Network and vouchers"]
  node_voucheradmin["Voucher management"]
  node_voucherruntime["Voucher router operations"]
  node_routerservices["Router management<br/>[RouterGateway.php]"]
  node_traffic["Network monitoring<br/>[TrafficService.php]"]
end

subgraph group_background["Background and integrations"]
  node_database[("MariaDB and RADIUS tables")]
  node_mikrotik["MikroTik routers"]
  node_freeradius["FreeRADIUS"]
  node_scheduler["Scheduled commands"]
  node_queues["Queue jobs"]
  node_wa_service["WhatsApp service"]
  node_wa_gateway["WhatsApp gateway<br/>[server.js]"]
  node_whatsapp["WhatsApp"]
end

node_visitors(("Visitors and users"))

node_visitors -->|"use in browser"| node_laravel
node_laravel -->|"serves pages"| node_publicsite
node_laravel -->|"serves portal"| node_customer
node_laravel -->|"serves panel"| node_admin
node_laravel -->|"handles login"| node_identity
node_identity -->|"records events"| node_activity
node_customer -->|"requests renewal"| node_billing
node_billing -->|"reads and writes"| node_database
node_publicsite -->|"reads account data"| node_database
node_admin -->|"manages accounts"| node_radius
node_radius -->|"writes RADIUS tables"| node_database
node_packages -->|"stores package data"| node_database
node_admin -->|"manages vouchers"| node_voucheradmin
node_voucheradmin -->|"dispatches router actions"| node_voucherruntime
node_voucherruntime -->|"creates local users"| node_mikrotik
node_admin -->|"manages routers"| node_routerservices
node_routerservices -->|"uses RouterOS API"| node_mikrotik
node_scheduler -->|"samples traffic"| node_traffic
node_scheduler -->|"runs periodic work"| node_database
node_scheduler -->|"polls routers"| node_mikrotik
node_mikrotik -->|"authenticates users"| node_freeradius
node_freeradius -->|"reads and writes"| node_database
node_queues -.->|"sends messages"| node_wa_service
node_wa_service -->|"calls gateway"| node_wa_gateway
node_wa_gateway -->|"connects messaging"| node_whatsapp

click node_laravel "https://github.com/nekomaa110-gif/zeronet/blob/master/bootstrap/app.php"
click node_publicsite "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Site/SiteController.php"
click node_customer "https://github.com/nekomaa110-gif/zeronet/tree/master/app/Http/Controllers/Customer"
click node_admin "https://github.com/nekomaa110-gif/zeronet/tree/master/app/Http/Controllers/Admin"
click node_identity "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Auth/TwoFactorChallengeController.php"
click node_activity "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/ActivityLogService.php"
click node_billing "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Customer/DashboardController.php"
click node_radius "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Admin/RadiusUserController.php"
click node_packages "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Models/Package.php"
click node_voucheradmin "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Admin/VoucherController.php"
click node_voucherruntime "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/VoucherRouterService.php"
click node_routerservices "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/RouterGateway.php"
click node_traffic "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/TrafficService.php"
click node_scheduler "https://github.com/nekomaa110-gif/zeronet/tree/master/app/Console/Commands"
click node_queues "https://github.com/nekomaa110-gif/zeronet/tree/master/app/Jobs"
click node_wa_service "https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/WhatsAppService.php"
click node_wa_gateway "https://github.com/nekomaa110-gif/zeronet/blob/master/deploy/wa-gateway/server.js"

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_laravel,node_publicsite,node_customer,node_admin,node_identity,node_visitors toneBlue
class node_activity,node_billing,node_radius,node_packages toneAmber
class node_voucheradmin,node_voucherruntime,node_routerservices,node_traffic toneMint
class node_database,node_mikrotik,node_freeradius,node_scheduler,node_queues,node_wa_service,node_wa_gateway,node_whatsapp toneRose
```

## Components

### Web experiences

- [Laravel application](https://github.com/nekomaa110-gif/zeronet/blob/master/bootstrap/app.php): `bootstrap/app.php`
- [Public website](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Site/SiteController.php): `app/Http/Controllers/Site/SiteController.php`
- [Customer portal](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Http/Controllers/Customer): `app/Http/Controllers/Customer`
- [Admin panel](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`
- [Admin identity and 2FA](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Auth/TwoFactorChallengeController.php): `app/Http/Controllers/Auth/TwoFactorChallengeController.php`

### Subscriber operations

- [Activity logging](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/ActivityLogService.php): `app/Services/ActivityLogService.php`
- [Invoices and renewals](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Customer/DashboardController.php): `app/Http/Controllers/Customer/DashboardController.php`
- [RADIUS subscribers](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Admin/RadiusUserController.php): `app/Http/Controllers/Admin/RadiusUserController.php`
- [Packages and coverage](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Models/Package.php): `app/Models/Package.php`

### Network and vouchers

- [Voucher management](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Http/Controllers/Admin/VoucherController.php): `app/Http/Controllers/Admin/VoucherController.php`
- [Voucher router operations](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/VoucherRouterService.php): `app/Services/VoucherRouterService.php`
- [Router management](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/RouterGateway.php): `app/Services/RouterGateway.php`
- [Network monitoring](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/TrafficService.php): `app/Services/TrafficService.php`

### Background and integrations

- **MariaDB and RADIUS tables**
- **MikroTik routers**
- **FreeRADIUS**
- [Scheduled commands](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Console/Commands): `app/Console/Commands`
- [Queue jobs](https://github.com/nekomaa110-gif/zeronet/tree/master/app/Jobs): `app/Jobs`
- [WhatsApp service](https://github.com/nekomaa110-gif/zeronet/blob/master/app/Services/WhatsAppService.php): `app/Services/WhatsAppService.php`
- [WhatsApp gateway](https://github.com/nekomaa110-gif/zeronet/blob/master/deploy/wa-gateway/server.js): `deploy/wa-gateway/server.js`
- **WhatsApp**

### Other components

- **Visitors and users**

## Connections

- Visitors and users → Laravel application: use in browser (evidence: `README.md`)
- Laravel application → Public website: serves pages (evidence: `README.md`)
- Laravel application → Customer portal: serves portal (evidence: `README.md`)
- Laravel application → Admin panel: serves panel (evidence: `README.md`)
- Laravel application → Admin identity and 2FA: handles login (evidence: `app/Http/Controllers/Auth/TwoFactorChallengeController.php`)
- Admin identity and 2FA → Activity logging: records events (evidence: `app/Http/Controllers/Auth/TwoFactorChallengeController.php`)
- Customer portal → Invoices and renewals: requests renewal (evidence: `app/Http/Controllers/Customer/DashboardController.php`)
- Invoices and renewals → MariaDB and RADIUS tables: reads and writes (evidence: `app/Http/Controllers/Customer/DashboardController.php`)
- Public website → MariaDB and RADIUS tables: reads account data (evidence: `app/Http/Controllers/Site/SiteController.php`)
- Admin panel → RADIUS subscribers: manages accounts (evidence: `README.md`)
- RADIUS subscribers → MariaDB and RADIUS tables: writes RADIUS tables (evidence: `README.md`)
- Packages and coverage → MariaDB and RADIUS tables: stores package data
- Admin panel → Voucher management: manages vouchers (evidence: `README.md`)
- Voucher management → Voucher router operations: dispatches router actions (evidence: `app/Http/Controllers/Admin/VoucherController.php`)
- Voucher router operations → MikroTik routers: creates local users (evidence: `README.md`)
- Admin panel → Router management: manages routers (evidence: `README.md`)
- Router management → MikroTik routers: uses RouterOS API (evidence: `README.md`)
- Scheduled commands → Network monitoring: samples traffic (evidence: `README.md`)
- Scheduled commands → MariaDB and RADIUS tables: runs periodic work (evidence: `README.md`)
- Scheduled commands → MikroTik routers: polls routers (evidence: `README.md`)
- MikroTik routers → FreeRADIUS: authenticates users (evidence: `README.md`)
- FreeRADIUS → MariaDB and RADIUS tables: reads and writes (evidence: `README.md`)
- Queue jobs → WhatsApp service: sends messages
- WhatsApp service → WhatsApp gateway: calls gateway (evidence: `README.md`)
- WhatsApp gateway → WhatsApp: connects messaging (evidence: `README.md`)
