feat: Initialize VitePress documentation system with multi-language content, custom theme, and assets.

This commit is contained in:
dyzulk
2026-01-16 15:05:45 +07:00
parent 1ae69f53f7
commit 0e38dcccc6
80 changed files with 73916 additions and 121 deletions

View File

@@ -0,0 +1,28 @@
# Dashboard & Monitoring
The Dashboard provides a real-time command center for your Mikrotik router. It aggregates critical data from the Mikrotik API to give you an immediate overview of your network's health.
## <Icon name="LineChart" color="primary" /> Real-time Traffic Monitor
MIVO features a live traffic monitor that communicates directly with your Mikrotik interfaces.
- **Interface Selection**: Choose any physical or virtual interface (e.g., `ether1`, `wlan1`, `bridge-hotspot`).
- **Live Graphing**: View incoming and outgoing traffic in bits/sec or bytes/sec.
- **Peak Tracking**: Quickly identify bandwidth spikes.
## <Icon name="Cpu" color="warning" /> Router Resources
Monitor the physical health of your Mikrotik hardware:
- **CPU Load**: Displayed as a percentage. High CPU load may indicate the need for hardware upgrades or configuration optimization.
- **Memory**: Tracks free vs. total RAM.
- **Uptime**: Shows how long the router has been running since the last reboot.
- **Disk/Storage**: Monitor available space on your router's flash memory.
## <Icon name="Smartphone" color="success" /> Active Sessions
A quick summary of currently authenticated users:
- **Total Online**: Real-time count of users currently using the hotspot.
- **Active IP/MAC**: Monitor connected devices on a high level.
> [!TIP]
> Keep the Dashboard open during peak hours to monitor for congestion or unauthorized access attempts.

View File

@@ -0,0 +1,40 @@
# Hotspot Management
Comprehensive tools to manage your Mikrotik Hotspot server, from user creation to advanced access control.
## <Icon name="Users" color="primary" /> Hotspot Users {#users}
The Users page (`/hotspot/users`) is the central database for all your wifi accounts.
- **Manual Creation**: Add individual users with specific usernames and passwords.
- **Individual Printing**: Hover over a user to see the print icon. It uses the default template assigned to their profile.
- **Batch Printing**: Select multiple users and use the **Batch Actions** menu to print them all at once on a single page.
- **Status Monitor**: See if a user is currently logged in (Active) directly in the list.
## <Icon name="Layers" color="info" /> User Profiles {#profiles}
User Profiles (`/hotspot/profiles`) define the rules for each type of voucher (e.g., 1 Hour, 1 Day).
- **Rate Limit**: Control upload and download speeds (e.g., `512k/1M`).
- **Shared Users**: Limit how many devices can use the same account simultaneously.
- **Validity**: Set how long the account remains active after the first login.
- **Price**: Store the selling price for reporting purposes.
## <Icon name="Ticket" color="success" /> Voucher Generator {#generate}
Generate hundreds of vouchers in seconds (`/hotspot/generate`).
1. **Quantity**: Choose how many vouchers to create.
2. **Server**: Select which hotspot server to target (usually `all`).
3. **User Mode**: Choose between `Username & Password` or `Username = Password`.
4. **Prefix**: Add a constant prefix to every generated username.
## <Icon name="Zap" color="warning" /> Active Sessions & Cookies {#active}
Monitor and control current connections (`/hotspot/active` and `/hotspot/cookies`).
- **Kick User**: Forcefully disconnect an active user session.
- **Cookies**: Manage 'remember me' tokens. Deleting a cookie forces the user to log in again on their next connection.
## <Icon name="ShieldCheck" color="danger" /> Security & Access {#security}
Advanced settings for network access without typical voucher requirements.
- **IP Bindings**: Bypass the hotspot login for specific MAC or IP addresses (e.g., for office printers or servers).
- **Walled Garden**: Allow access to specific websites or domains (e.g., your bank's portal) even before users log in.

View File

@@ -0,0 +1,16 @@
# Router Operations
Router operations are session-specific tasks performed once connected to a Mikrotik device. These settings vary depending on which router session you are currently in.
## <Icon name="Activity" color="primary" /> Overview
Once you select a session from the sidebar, you gain access to these tools:
- **[Dashboard](/manual/router/dashboard)**: Real-time traffic monitoring.
- **[Hotspot Management](/manual/router/hotspot)**: Users, Profiles, and Vouchers.
- **[Reports](/manual/router/reports)**: Sales reports and system logs.
- **[System Tools](/manual/router/tools)**: Reboot, Scheduler, and DHCP.
## <Icon name="Zap" color="warning" /> Real-time Sync
MIVO communicates directly with your Mikrotik API. Most changes take effect immediately on your device.

View File

@@ -0,0 +1,27 @@
# Quick Print
Quick Print is a specialized module for high-speed voucher vending. It allows you to display only the specific packages you want to sell and print them with a single click.
## <Icon name="BarChart2" color="primary" /> Vending Dashboard
The main page (`/quick-print`) displays your "Packets" as large, clickable cards.
- **Instant Generation**: Clicking a packet immediately requests the router to create a new user.
- **Auto-Print**: Once the user is created, the print dialog for that voucher opens automatically.
## <Icon name="Library" color="info" /> Packet Management
Access the **Manage** section (`/quick-print/manage`) to customize your vending dashboard.
### <Icon name="PlusCircle" color="success" /> Adding Packets
- **Profile**: Choose a Mikrotik user profile.
- **Price**: Set the display price (can differ from Mikrotik comment).
- **Template**: Assign a specific voucher template for this packet.
### <Icon name="Trash2" color="danger" /> Removing Packets
Deleting a packet here only removes it from the Quick Print dashboard; it does **not** delete the profile from your Mikrotik router.
## <Icon name="Printer" color="warning" /> Workflow
1. **Admin** chooses a packet from the dashboard.
2. **MIVO** creates a random username/password account on the Mikrotik.
3. **MIVO** fetches the assigned template and sends it to the browser's print engine.

View File

@@ -0,0 +1,28 @@
# Reports & Logs
Analyze your business performance and monitor system activity through detailed reporting tools.
## <Icon name="BarChart" color="success" /> Selling Reports {#selling}
The Selling Reports page (`/reports/selling`) provides a detailed breakdown of your revenue.
- **Timeline**: View sales by day, month, or a custom date range.
- **Details**: See which profile was sold, the timestamp, and the price.
- **Export**: (If available) Export your data for offline accounting.
## <Icon name="BarChart2" color="primary" /> Sales Resume {#resume}
The Resume page (`/reports/resume`) offers a simplified high-level view of your business growth.
- **Total Income**: Combined revenue from all voucher sales.
- **Voucher Count**: Total number of vouchers sold vs. generated.
- **Session Comparison**: Compare performance across different router sessions.
## <Icon name="ClipboardList" color="info" /> System Logs {#logs}
Monitor real-time events from your Mikrotik router (`/reports/user-log`).
- **Events**: Track user logins, logouts, script executions, and system errors.
- **Troubleshooting**: Use these logs to identify why a user cannot connect or when a session was disconnected.
- **Live Stream**: The logs update automatically as events occur on the router.
> [!NOTE]
> MIVO fetches these logs directly from the Mikrotik circular buffer. Clear your logs on the Mikrotik terminal if the buffer becomes too large.

View File

@@ -0,0 +1,26 @@
# System Tools
Essential utilities for maintaining, scheduling, and monitoring your Mikrotik router's core functions.
## <Icon name="Network" color="info" /> DHCP Leases
The DHCP Leases page (`/network/dhcp`) allows you to monitor all devices connected to your LAN or Hotspot network, even before they log in.
- **Lease Tracking**: View IP assignments, MAC addresses, and hostnames of connected devices.
- **Pre-Login Monitor**: Useful for identifying devices that are connected but having trouble reaching the hotspot login page.
## <Icon name="Clock" color="primary" /> Router Scheduler
MIVO provides a full interface (`/system/scheduler`) to manage Mikrotik's internal scripts and schedules.
- **Tasks List**: View all active and disabled scheduled tasks on your router.
- **Manage Tasks**: Add, edit, or delete tasks directly from MIVO.
- **Automation**: Use this for periodic script execution, such as clearing expired users or generating automated reports.
## <Icon name="Zap" color="warning" /> Critical Actions
Directly trigger system-level commands from the MIVO interface:
- **<Icon name="RefreshCw" color="info" /> Reboot**: Safely restart your Mikrotik hardware.
- **<Icon name="Power" color="danger" /> Shutdown**: Power off the device. Note that you will need physical access to the router to turn it back on.
> [!WARNING]
> These actions are executed immediately on your Mikrotik router. Ensure no critical operations are running before rebooting.