# MagnusOp — Multi-Tenant Commerce Platform & AI Copilot

> MagnusOp is an all-in-one multi-tenant e-commerce platform designed for small-to-medium merchants. It provides branded online storefronts, integrated direct payments, inventory control, an RAG-powered AI Copilot, and allowlisted automated operations.

## Core Platform Capabilities

1. **Branded Public Storefronts**:
   - Each merchant gets an independent public storefront (`/storefront/[slug]`).
   - Customers browse active products, select variant SKUs, and checkout directly.
   - Payments are processed via Paystack or Flutterwave with direct subaccount routing.

2. **Merchant Dashboard & Multi-Tenant Boundaries**:
   - Authenticated merchant dashboard (`/dashboard`).
   - Strict database isolation using PostgreSQL Row-Level Security (RLS) and `app.current_business_id` session context.
   - Multi-user team seats with role-based access control (`OWNER`, `ADMIN`, `MEMBER`).

3. **Read-Only Merchant AI Copilot**:
   - Built on a 3-model RAG architecture (embedding, reranking, and reasoning).
   - Answers natural language questions using strictly tenant-isolated merchant sales and catalog data.
   - Operates in read-only mode and cannot mutate inventory or financial ledgers directly.

4. **Allowlisted Automation Engine**:
   - Merchants can opt into specific repeatable automation rule types (`WEEKLY_SALES_DIGEST`, `LOW_STOCK_NOTIFICATION`, `AUTO_TAG_LOW_STOCK`, `AUTO_ARCHIVE_OUT_OF_STOCK`, `DRAFT_REORDER_SUGGESTION`, `DRAFT_DISCOUNT_FOR_SLOW_MOVER`).
   - Hardcoded risk tiers (`SAFE_AUTOMATIC`, `CAPPED_AUTOMATIC`, `ALWAYS_APPROVAL`).
   - Any financial or inventory-modifying rule requires explicit human approval signoff.
   - Global emergency killswitch allows merchants to halt all automations instantly.

5. **Double-Entry Financial Ledgers & Minor Units**:
   - All financial amounts are stored as integer minor units (e.g. kobo for NGN).
   - Balanced double-entry debit/credit ledger records for every payment and order settlement.
   - Full Idempotency-Key deduplication on all state-changing operations.

## Target Audience & Outcomes
- Primary Users: Independent retail merchants, boutique brands, and growing commerce businesses.
- Key Outcomes: Sell online, receive instant direct bank/card payments, track inventory accurately, and automate daily routine tasks without hiring additional headcount.

## Canonical URLs
- Marketing Site: https://magnusop.com
- Pricing: https://magnusop.com/pricing
- Merchant Login: https://app.magnusop.com/login
- Merchant Signup: https://app.magnusop.com/signup
- Developer Documentation & API Contracts: https://app.magnusop.com/api/v1/docs