# Business Overview

## Executive Summary

The Smart Estate Visitor Management Platform is a multi-tenant access control and visitor management system for gated estates, residential communities, and managed properties. It helps estate teams digitize resident records, visitor invitations, gate check-in, incidents, subscriptions, payment activation, and audit trails.

The current backend supports a production-oriented MVP with estate onboarding, subscription plans, hosted and manual payment flows, OTP authentication, role-based access, feature toggles, resident and guard management, visitor passes, QR/manual check-in, offline sync, incident reporting, notifications, and audit logs.

## Problem

Many estates still manage gate access with paper logs, phone calls, WhatsApp messages, manual ID checks, and fragmented spreadsheets. This creates practical business problems:

- slow visitor verification at the gate
- weak accountability for security staff and residents
- poor visibility into who entered, who approved the visit, and when visitors left
- inconsistent resident and guard records
- limited control when internet access is unreliable
- difficulty charging, onboarding, and supporting many estates from one platform

## Solution

The platform provides a shared backend for estate security operations. Each estate is tenant-scoped, meaning users, residents, visitors, guards, passes, incidents, payments, and logs are separated by estate.

Core capabilities include:

- OTP login for residents, guards, estate admins, sales admins, and super admins
- estate signup review and payment activation
- subscription plans for different estate sizes
- configurable payment providers: Flutterwave, Monnify, Paystack, and Stripe
- resident and guard account management
- visitor profile and pass creation
- QR and manual visitor code check-in
- visitor checkout and visit sessions
- offline gate device bootstrap and sync
- incident reporting
- audit logging for operational accountability
- feature access settings by role

## Target Customers

Primary buyers:

- gated residential estates
- apartment communities
- property management companies
- facility management firms
- estate resident associations
- private residential developments with controlled access points

Primary users:

- estate admins
- security supervisors
- guards
- residents
- platform super admins
- platform sales admins

## Value Proposition

For estate managers, the product reduces gate friction and improves security visibility. For residents, it makes visitor access predictable and faster. For guards, it provides clear pass validation and offline support. For the platform operator, it creates a repeatable subscription business with central onboarding, billing, feature control, and support.

Key value messages:

- faster visitor entry with QR and manual pass validation
- better accountability through audit logs and guard-linked sessions
- controlled estate onboarding with payment confirmation before activation
- offline continuity for gate operations
- flexible role and feature access for different estate policies
- centralized platform administration for scaling across many estates

## Product Readiness

The workspace indicates that the backend MVP is in an advanced state. Implemented areas include:

- NestJS API under `apps/api`
- Prisma/PostgreSQL data model
- seeded estate, users, plans, and payment provider settings
- Swagger documentation and browser sandbox
- unit tests for core services
- production deployment notes
- frontend and mobile API guidance

The remaining business requirement is to package the implemented capabilities into clear customer-facing plans, sales materials, onboarding SOPs, and operational reporting.

## Differentiation

The platform can be positioned around practical estate operations rather than generic access control:

- built for estate admins, residents, and guards
- tenant-aware by design
- subscriptions and payment activation are part of the platform workflow
- offline gate operation is treated as a first-class need
- super admin and sales admin roles support multi-estate business operations
- feature toggles allow the operator to package capabilities by role or estate

## Business Assumptions

These documents assume:

- Nigeria is an initial target market because existing docs reference NGN pricing and local payment providers.
- `gatewise.ng` is the intended production brand/domain, pending final brand approval.
- Starter and Growth plans use current seeded prices.
- Enterprise pricing remains custom.
- Hosted payment checkout should be preferred over manual payment references when provider credentials are configured.

