# E-Internet Management Service — Overview

## What is EIMS?

E-Internet Management Service (EIMS) is a multi-tenant SaaS platform designed for
Internet Service Providers (ISPs) to manage customers, packages, billing, and
payments from a single web-based interface.

Each ISP (tenant) gets its own subdomain (e.g. `isinternet.eims.test`) and sees
only its own data. A platform super-admin can view and manage all tenants.

---

## Key Features

- **Customer registry** — Shared, globally deduplicated by CNIC and contact number
- **Package management** — Define internet plans with speeds and prices
- **Billing** — Auto-generate monthly bills with configurable taxes and discounts
- **Payments** — Record cash, EasyPaisa, JazzCash, bank transfer, cheque payments
- **Installment plans** — Split large bills into scheduled installments
- **Payment gateways** — EasyPaisa and JazzCash live gateway integration
- **Reports** — Monthly income, outstanding dues, package-wise revenue
- **REST API** — Mobile app support via Laravel Sanctum tokens
- **Role-based access** — Six roles from viewer to super-admin
- **Activity logs** — Full audit trail of all changes

---

## Roles at a Glance

| Role | Who uses it |
|---|---|
| `super-admin` | Platform owner — full access to all tenants |
| `admin` | ISP owner — full access within their tenant |
| `manager` | Office manager — customers, billing, payments |
| `billing-staff` | Billing clerk — bills and payments only |
| `support-staff` | Support agent — view-only customers and bills |
| `viewer` | Dashboard and reports read-only |

---

## Tenant URL Structure

```
https://eims.test              ← Platform (super-admin)
https://{slug}.eims.test       ← Each ISP tenant
```

---

## See Also

- [02-installation.md](02-installation.md)
- [03-tenants.md](03-tenants.md)
- [04-users-roles.md](04-users-roles.md)
