# Devix AccessOne — Complete Build Inventory

**Product:** Devix AccessOne (ISP Operations Platform)  
**Version:** 0.5.52 (panel) · Marketing site `accessone.com` (this wave)  
**Updated:** 2026-07-20  
**Live ops panel (Mansoorah):** https://operations.mtcl.net.pk  
**Marketing:** https://accessone.com (host `175.29.56.13`)

Yeh file **ab tak jo bana hai** ka master index hai — phases, modules, recent waves, deploy scripts, aur marketing. Day-to-day detail ke liye `docs/modules/` + `CHANGELOG.md` dekho.

---

## 1. Product summary

AccessOne ek **modular monolith** hai:

| Layer | Path |
|--------|------|
| Backend API (Go) | `radius-manager/backend/` |
| Admin UI (Next.js) | `radius-manager/frontend/` |
| FreeRADIUS / DB | `deployment/docker/` + migrations |
| Module docs | `docs/modules/` |
| Blueprint (long-term spec) | `docs/blueprint/` |
| Marketing site | `marketing/` |

Stack: PostgreSQL · FreeRADIUS · Docker Compose · host nginx TLS · WireGuard mgmt VPN · GenieACS (TR-069).

---

## 2. Phases (1–16) — build status

| Phase | Focus | Status |
|-------|--------|--------|
| 1 | Core — RADIUS, subscribers, packages, partners, admin UI | Done |
| 2 | Billing — invoices, wallet, partner ledger, gateways | Done |
| 3 | CRM — leads, KYC, CSA, field ops, dealer deals | Done |
| 4 | MikroTik — API, sessions, traffic, pools, Winbox console | Done |
| 5 | Migration — CSV, Zal Pro/Ultra | Done |
| 6 | Developer API — scoped keys, OpenAPI, NMS scopes | Done |
| 7 | OLT / FTTH — VSOL / Huawei / ZTE / BDCOM / HSGQ | Done |
| 8 | Network inventory — switches, wireless, VLANs, ports | Done |
| 9 | Ticketing — SLA, assign, types | Done |
| 10 | Notifications — SMS / email / WhatsApp templates | Done |
| 11 | Reports & export | Done |
| 12 | Client portal — renew, invoices, tickets | Done |
| 13 | Security & compliance | Done |
| 14 | Mobile (Flutter scaffold) | Done |
| 15 | Enterprise / SaaS / AdminCP | Done |
| 16 | Devix AI Assistant (Urdu + English) | Done |

Source: `docs/IMPLEMENTATION-PLAN.md`, `radius-manager/ROADMAP.md`.

---

## 3. Module docs (feature matrices)

Full table: [`docs/modules/README.md`](./modules/README.md)

Highlights:

| Area | Doc |
|------|-----|
| Customers / filters / profile | `customers-ops-console.md`, `customers-filters.md`, `customer-profile.md` |
| Partners / pricing / owned packages | `partner-pricing.md`, `partner-owned-packages.md`, `isp-assign-owner.md` |
| Billing / ledger | `billing-ledger.md`, `billing-phase2.md` |
| Online sessions | `online-sessions.md` |
| OLT / NMS | `olt-drivers.md`, `nms-phases.md`, `nms-final.md`, `olt-onu-realtime.md` |
| Network devices / airMAX | `inventory.md`, `ubnt-airmax-bras.md` |
| Mgmt VPN | `mgmt-wireguard-vpn.md` |
| Bandwidth scheduler | `bandwidth-scheduler.md` |
| CRM / sales | `crm-sales.md`, `crm-dealer-deals.md`, `sales-officer-login.md` |
| Tickets / portal / AI | `tickets.md`, `client-portal.md`, `devix-ai.md`, `ai-agent-v2.md` |
| Voice | `../VOICE-ASTERISK-SETUP.md` |

---

## 4. Recent delivery waves (v0.5.47 → 0.5.52)

| Ver | Wave | Deploy script |
|-----|------|----------------|
| 0.5.52 | UBNT airMAX telemetry via BRAS (SSID/signal/stations) | `scripts/nms_airmax_bras_telemetry_deploy.py` |
| 0.5.51 | monitoring_source chips + Stale Online + WG hub restore | `scripts/nms_monitoring_source_deploy.py` |
| 0.5.50 | ISP package owner cascade unassign + edit owner | `scripts/isp_package_owner_unassign_deploy.py` |
| 0.5.49 | Branch portal wallet (`branch` role) | `scripts/branch_portal_wallet_deploy.py` |
| 0.5.48 | ISP admin partner-owned packages view/edit | `scripts/isp_admin_partner_owned_packages_deploy.py` |
| 0.5.47 | Zero-price activate + pending RADIUS Reject | `scripts/zero_price_activate_pending_radius_deploy.py` |

Other notable waves (see CHANGELOG): Mgmt WireGuard VPN, bandwidth scheduler live queues, BRAS SNMP proxy for UBNT ACL, ONU realtime IF-MIB, partner cascade filters, Assign Package logout fixes (DuosLinks).

---

## 5. Production hosts

| Host | Role |
|------|------|
| `175.29.56.13` | Mansoorah — panel + marketing |
| https://operations.mtcl.net.pk | AccessOne admin UI + API (TLS host nginx → Docker 8080/8090) |
| https://accessone.com | Public marketing + product tour (static) |
| `110.39.164.50` | DuosLinks client instance |
| `devix.pk` / AdminCP | Central license / hub |

Mansoorah SSL template: `deployment/docker/nginx/mansoorah-host-ssl.conf`  
Marketing SSL template: `deployment/docker/nginx/accessone-com-host.conf`  
Deploy marketing: `scripts/accessone_com_marketing_deploy.py`

---

## 6. Admin UI — major surfaces (guided tour pages)

Marketing tour uses **demo-only** screens (no live API). Product login is separate.

| Tour screen | Product route (approx.) | What it shows |
|-------------|-------------------------|---------------|
| Dashboard | `/` | KPIs, online, revenue snapshot |
| Customers | `/customers` | List, partner filter, activate |
| Customer profile | `/customers/[id]` | Live link, packages, CRM |
| Partners | `/partners` | Hierarchy, wallet, packages |
| Service plans | `/service-plans/internet` | Packages, scheduler, owner |
| Sessions online | `/sessions/online` | PPPoE online table |
| Billing | `/billing` | Invoices / payments |
| OLT / FTTH | `/olt` | OLT cards, ONU counts |
| Network devices | `/network-devices` | Switch / Wireless tabs |
| Wireless detail | `/network-devices/[id]` | airMAX / AirFiber VIP |
| Mgmt VPN | `/nms/mgmt-vpn` | Hub peers, ping |
| Tickets | `/tickets` | SLA queue |
| Reports | `/reports` | Exports |
| Settings / Docs | `/settings` | In-app docs, sync |
| Client portal | `/portal` | Subscriber self-care |
| Devix AI | `/ai-assistant` | Roman Urdu assistant |

---

## 7. Key technical capabilities

- **RADIUS** — activate / renew / migrate; pending Reject until Activate; partner sale prices including Rs 0  
- **Partner tree** — ISP → branch → franchise → dealer; owned packages; cascade assign/unassign  
- **MikroTik BRAS** — live PPP, CoA, queues, Winbox-style console, mgmt VPN  
- **OLT NMS** — multi-vendor SNMP/CLI, optical, authorize wizard, TR-069  
- **Wireless NMS** — hub SNMP or **bras-snmp** proxy; airMAX + AirFiber LTU  
- **Billing** — invoices, multi-tax, JazzCash / EasyPaisa / Raast / bank  
- **CRM** — leads, CSA print/sign, field activities, dealer deals  
- **RBAC** — staff roles, branch scope on OLT/NAS/customers  
- **Developer API** — `ak_*` keys, `read:nms` / `write:nms`, subscribers, billing  

---

## 8. Documentation map

| File | Purpose |
|------|---------|
| `CHANGELOG.md` | What shipped / fixed |
| `docs/IMPLEMENTATION-PLAN.md` | Phase matrix |
| `docs/ACCESSONE-POORA-GUIDE.md` | Operator UI guide |
| `docs/DOCUMENTATION-GUIDE.md` | Doc checklist after features |
| `docs/brand/ACCESSONE-BRAND.md` | Colors / radius |
| `radius-manager/frontend/src/lib/product-docs.ts` | In-app Settings → Docs |
| `marketing/README.md` | Public site deploy notes |
| **This file** | Complete inventory |

---

## 9. Marketing site (`marketing/`)

- Static HTML/CSS/JS — **no live panel data**  
- Guided product tour with demo screenshots (SVG mockups)  
- CTA **Open live demo** → https://operations.mtcl.net.pk/login  
- Hosted as `accessone.com` / `www.accessone.com` on Mansoorah  

---

## 10. How to keep this file current

After each feature wave:

1. Update `CHANGELOG.md` + `docs/modules/<module>.md`  
2. Bump `product-docs.ts` version  
3. Add a row under §4 (Recent delivery waves) here if it is a major public-facing wave  
4. If UI pages change, update marketing tour screen + caption in `marketing/product-tour.html`