Introduction

Welcome to MIZAN, a comprehensive enterprise resource planning application designed to help you manage projects, track time, and organize your team efficiently.

Key Features

• Project Management - Create and manage projects with status tracking and client assignment
• Employee Management - Organize your workforce with departments, job titles, and skills tracking
• Multi-Tenant - Manage multiple organizations with complete data isolation via Row-Level Security
• Cross-Platform - Access from Windows, macOS, Linux, iOS, Android, or any web browser
• Real-time Sync - Changes appear instantly across all devices via SignalR
• Multilingual - Full support for English, Russian, and Turkmen languages

Installation

MIZAN is available for multiple platforms. Choose the installation method that works best for you.

Windows

1. Download the installer from the Downloads page
2. Run the .exe installer
3. Follow the installation wizard
4. Launch Ak.Mizan from the Start Menu

macOS

1. Download the .dmg file from the Downloads page
2. Open the DMG and drag Ak.Mizan to your Applications folder
3. Launch from Applications or Spotlight

Linux

AppImage (Universal):

chmod +x AkMizan-1.0.0.AppImage
./AkMizan-1.0.0.AppImage

Debian/Ubuntu:

sudo dpkg -i akmizan_1.0.0_amd64.deb
sudo apt-get install -f

Fedora/RHEL:

sudo rpm -i akmizan-1.0.0.x86_64.rpm

iOS

1. Open the App Store on your iPhone or iPad
2. Search for "MIZAN"
3. Tap "Get" to download and install
4. Open the app and sign in

Alternatively, visit the Downloads page and tap "Get on App Store" to be redirected.

Android

From APK (Direct Download):

1. Download the APK from the Downloads page
2. Open your device Settings → Security
3. Enable "Install from unknown sources" for your browser
4. Open the downloaded APK file
5. Tap "Install" and wait for completion
6. Open MIZAN and sign in

Web Version

No installation required! Simply navigate to the web application URL in your browser. The web version works best with Chrome, Firefox, Edge, or Safari.

First Steps

After launching MIZAN for the first time, you'll need to set up your account and organization.

Creating an Account

1. Click "Create Account" on the login screen
2. Enter your email address and create a password
3. Verify your email address
4. Complete your profile information

Joining or Creating an Organization

After registration, you'll need to either join an existing organization or create a new one:

• Accept an Invitation - If someone invited you, you'll see the invitation on your dashboard
• Create New Organization - Click "Create Organization" to set up your own workspace

Account Setup

Configure your account settings and preferences for the best experience.

Profile Settings

• Update your display name and profile picture
• Set your timezone for accurate time tracking
• Configure notification preferences

Language Settings

MIZAN supports multiple languages:

• English - Default language
• Russian (Русский) - Full translation
• Turkmen (Türkmençe) - Full translation

Change your language in Settings → Language.

Managing Projects

Projects are the core of MIZAN. Learn how to create, manage, and track your projects effectively.

Creating a Project

1. Navigate to Projects from the main menu
2. Click "New Project" or press Ctrl+N
3. Fill in the project details:
   • Name - A descriptive project name
   • Code - A short identifier (e.g., "PROJ-001")
   • Client - The client or customer
   • Start/End Date - Project timeline
   • Budget - Estimated hours or cost
4. Click "Save" to create the project

Project Status

Projects can have the following statuses:

• Draft - Initial setup, not yet active
• Active - Work in progress
• On Hold - Temporarily paused
• Completed - Finished successfully
• Cancelled - Terminated before completion

Desktop Tabs

On desktop, you can open multiple projects in tabs for easy switching:

• Click a project to open it in a new tab
• Right-click a tab for options (close, close others)
• Drag tabs to reorder them

Employee Management

Organize your team with departments, roles, and skills tracking.

Adding Employees

Invite team members to your organization:

1. Go to Settings → Team Members
2. Click "Invite Member"
3. Enter their email address
4. Select their role (Admin, Manager, Member, Viewer)
5. Send the invitation

Departments

Create departments to organize your workforce:

• Engineering, Design, Marketing, etc.
• Assign employees to departments
• Set department managers

Skills

Track employee skills for resource allocation:

• Add skills from a predefined list
• Set proficiency levels
• Search employees by skills when staffing projects

Organizations

MIZAN supports multiple organizations (tenants) with complete data isolation.

Switching Organizations

If you belong to multiple organizations:

1. Click your profile icon in the header
2. Select "Switch Organization"
3. Choose the organization from the list

Organization Settings

Tenant Admins can configure organization settings:

• Organization name and logo
• Default timezone
• Currency and date formats
• Billing information

User Roles

Real-time Synchronization

MIZAN uses SignalR to keep all connected clients in sync. When a team member makes changes, they appear instantly on your screen.

How It Works

• Changes are broadcast to all connected users in your organization
• Lists automatically refresh when items are added/updated/deleted
• Edit forms show a notification when someone else modifies the same record

Connection Status

The connection indicator in the app shows your sync status:

• Green - Connected and syncing
• Yellow - Reconnecting
• Red - Offline

Auto-Updates

MIZAN can automatically check for and install updates to ensure you always have the latest features and security fixes.

Update Behavior by Platform

Update Settings

Configure update behavior in Settings → Updates:

• Auto-check for updates - Automatically check for new versions on app startup
• Auto-download updates - Download updates in the background when available
• Download source (Android only) - Choose between website download or Play Store

Manual Update Check

1. Open Settings from the main menu
2. Scroll to the "Updates" section
3. Tap "Check for Updates"
4. If an update is available, follow the prompts to download and install

Update Notifications

When a new version is available:

• A banner appears at the top of the screen
• Tap the banner to view release notes and download
• You can dismiss the banner and update later

Languages

MIZAN is fully localized in multiple languages.

Supported Languages

• English (en) - Default
• Russian (ru) - Русский
• Turkmen (tk) - Türkmençe

Changing Language

1. Open Settings from the main menu
2. Select "Language"
3. Choose your preferred language
4. The app will refresh with the new language

Your language preference is saved and will be remembered on all devices.

Keyboard Shortcuts

Work faster with keyboard shortcuts (desktop only).

Global Shortcuts

Navigation

API Reference

MIZAN provides a RESTful API for integrations and automation.

Base URL

https://api.mizan.app/api/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer <your-access-token>

Common Endpoints

For complete API documentation, see the OpenAPI specification at /swagger.

Frequently Asked Questions

How many users can I have?

There's no limit on the number of users in an organization. Pricing may vary based on your plan.

Is my data secure?

Yes. We use industry-standard encryption, JWT authentication, and row-level security to protect your data. Each organization's data is completely isolated using PostgreSQL Row-Level Security policies.

Can I import data from other tools?

Yes, we support importing from CSV files. Contact support for migrations from specific tools.

Can I self-host MIZAN?

Enterprise customers can request self-hosted deployment options using Docker. Contact sales for details.

What languages are supported?

MIZAN is fully localized in English, Russian, and Turkmen. We also include a custom Turkmen locale for date/time formatting.

Troubleshooting

App won't start

• Ensure your system meets the minimum requirements
• Try reinstalling the application
• Check if antivirus is blocking the app

Can't log in

• Verify your email and password are correct
• Check if Caps Lock is on
• Try resetting your password
• Ensure you have internet connectivity

Data not syncing

• Check the connection status indicator
• Try refreshing the page/screen (pull down on mobile)
• Log out and log back in
• Check your internet connection

Performance issues

• Close unused tabs (desktop)
• Clear the app cache in Settings
• Ensure you have sufficient RAM
• Update to the latest version