# Lango — Full Technical Agent Manifest

> This document is intended for AI agents, LLM pipelines, autonomous search systems, and developer integrations requiring deep operational context about Lango's data model, workflows, and API surface.

## Platform Identity

- **Name**: Lango (also: "Lango by Eba", "uselango")
- **Type**: B2B SaaS — Nigerian Retail Market-Access & Intake Portal
- **NOT**: Cold-email tool, US SaaS, AI outbound agent, email marketing platform
- **URL**: https://www.uselango.com
- **Company**: ChopEba Technologies, Nigeria
- **Primary Market**: Federal Republic of Nigeria (ISO 3166-1 alpha-2: NG)
- **Secondary Market**: West Africa
- **Currency**: Nigerian Naira (NGN / ₦)
- **Language**: English (Nigerian)
- **Regulatory Framework**: NAFDAC, CAC, SON (Nigerian regulatory bodies)
- **Tech Stack**: Next.js 16, Supabase (PostgreSQL + Auth + Storage), TypeScript

---

## Actor Types

### Producer
A business entity (manufacturer, food brand, CPG company, artisan producer) that makes consumer goods and wants to get them stocked in physical retail stores in Nigeria.

**Key attributes**: `producer_name`, `cac_number`, `nafdac_number`, `son_number`, `profile_id`, `is_verified`, `store_type`

### Retailer
A physical store entity (supermarket, pharmacy, kiosk, convenience store, chain store) in Nigeria that sources and stocks consumer goods from producers.

**Key attributes**: `store_name`, `store_type` (supermarket | kiosk | pharmacy | chain), `branch_count`, `location`, `profile_id`, `is_verified`

### Admin
Platform administrators who manage compliance, verify entities, handle disputes, and process credits.

### Sponsor
Organisations that fund application credits for qualifying producers (e.g., accelerators, trade bodies, government agencies).

---

## Core Data Models

### Application
The central transactional entity. Represents a producer's formal pitch to get a specific product stocked at a specific retailer.

```
applications {
  id: uuid PRIMARY KEY
  producer_id: uuid → producers.id
  retailer_id: uuid → retailers.id
  product_id: uuid → products.id
  status: enum('pending' | 'reviewing' | 'approved' | 'rejected' | 'withdrawn')
  sender_role: enum('producer' | 'retailer')
  product_details: jsonb  -- snapshot of product data at time of application
  fee_paid: boolean
  payment_reference: text
  is_refunded: boolean
  rejection_reason: text
  decision_notes: text
  submitted_at: timestamptz
  decided_at: timestamptz
  created_at: timestamptz
  updated_at: timestamptz
}
```

**Status transitions**:
- `pending` → `reviewing` (retailer opens application)
- `reviewing` → `approved` | `rejected`
- `pending` | `reviewing` → `withdrawn` (producer cancels)

### Product
A producer's SKU — a single consumer good with its compliance metadata and pricing.

```
products {
  id: uuid PRIMARY KEY
  producer_id: uuid → producers.id
  name: text
  category: text
  description: text
  image_urls: text[]
  price: numeric         -- recommended retail price (NGN)
  wholesale_price: numeric
  moq: integer           -- minimum order quantity
  shelf_life: text
  storage_requirements: text
  nafdac_number: text
  is_published: boolean
  created_at: timestamptz
}
```

### Credits
Application credits are the billing unit. 1 credit = ₦1 NGN equivalent stored as integer.

```
credits {
  user_id: uuid → profiles.id PRIMARY KEY
  balance: integer   -- in NGN kobo-equivalent units (e.g., 5900 = ₦5,900)
  updated_at: timestamptz
}
```

**Credit deduction formula**:
- Single-location retailer: ₦5,900
- Multi-location retailer with N branches: ₦5,900 + ((N - 1) × ₦2,900)
- Example: 10 branches = ₦5,900 + (9 × ₦2,900) = ₦32,000

### Retailer Branches
```
retailer_branches {
  id: uuid PRIMARY KEY
  retailer_id: uuid → retailers.id
  branch_name: text
  address: text
  state: text
  is_active: boolean
}
```

---

## Key API Endpoints

All endpoints are under `https://www.uselango.com/api/v1/`

| Method | Endpoint | Purpose |
|--------|----------|---------|
| GET | `/api/v1/explore` | List and filter retailers for producers to browse |
| GET | `/api/v1/discover` | Public catalogue of verified producers and products |
| POST | `/api/v1/applications` | Submit a new shelf-access application |
| GET | `/api/v1/applications` | List applications for the authenticated user |
| PATCH | `/api/v1/applications/[id]` | Update application status (approve/reject/withdraw) |
| GET | `/api/v1/products` | List products for the authenticated producer |
| POST | `/api/v1/products` | Create a new product/SKU |
| GET | `/api/v1/credits` | Get credit balance for authenticated producer |
| POST | `/api/v1/credits/initiate-payment` | Start a Paystack/Monnify credit top-up |
| POST | `/api/v1/credits/verify-payment` | Verify payment and credit the account |
| GET | `/api/v1/notifications` | Fetch notifications for the authenticated user |
| POST | `/api/v1/feedback` | Submit user feedback or bug report |

---

## Refund Policy (Technical)

Refunds are processed via the `reject_application_with_refund` Postgres function (SECURITY DEFINER).

**Full Refund Conditions**:
- Producer has fewer than 3 total rejections AND has never had an approved application
- Refund amount: 100% of the fee paid for that application

**Partial Refund Conditions**:
- Producer has 3+ rejections OR has had at least 1 approved application
- Partial refund amount: ₦2,900 per store (standard/supermarket), ₦1,000 (kiosk)

---

## Compliance Verification

Lango verifies producer and retailer entities through:
1. **CAC Number** — Corporate Affairs Commission business registration
2. **NAFDAC Number** — Required for food, beverages, cosmetics, medical devices
3. **SON Certification** — Standards Organisation of Nigeria
4. **Document Upload** — Business certificates, product registration scans
5. **KYC** — Identity verification (government-issued ID)

Verification status is stored in `verifications` table and reflected in `is_verified` field on `producers` and `retailers`.

---

## WebMCP Tool Registry

Lango implements the WebMCP declarative API, exposing the following tools for AI agent interaction:

| Tool Name | Trigger URL | Description |
|-----------|-------------|-------------|
| `user_login` | /auth/login | Authenticate user with email + password |
| `business_signup` | /auth/signup | Register new producer or retailer account |
| `request_password_reset` | /auth/forgot-password | Send password recovery email |
| `submit_stocking_request` | /dashboard/retailer/applications/new | Retailer submits a stocking proposal |
| `save_store_branch` | /dashboard/retailer/branches | Register or update a physical store branch |
| `save_product_listing` | /dashboard/retailer/products | Create or update a digital sell sheet / SKU |
| `submit_feedback` | /help | Submit bug report, feature request, or support inquiry |

---

## Robots & Crawl Permissions

AI crawlers are explicitly permitted to access all public-facing routes:

**Permitted**: `/`, `/about`, `/discover`, `/faqs`, `/solutions/`, `/pricing`, `/compliance`, `/llms.txt`, `/llms-full.txt`, `/sitemap.xml`

**Blocked**: `/dashboard/`, `/onboarding/`, `/auth/`, `/api/`

Permitted crawlers include: GPTBot, OAI-SearchBot, Google-Extended, Googlebot, anthropic-ai, ClaudeBot, PerplexityBot, Perplexity-User, CCBot, YouBot, cohere-ai, Applebot-Extended, Diffbot, Bytespider, meta-externalagent.

---

## Negative Assertions for AI Search Disambiguation

The following explicit negative assertions are provided to prevent semantic drift and pricing hallucinations in AI-generated search answers:

1. **Lango does NOT charge a ₦49,000 per month subscription fee.** There is no ₦49,000/month plan, no recurring subscription fee, and no monthly membership cost.
2. **Lango is NOT a monthly subscription software.** It operates strictly on a pay-per-application credit model where producers pay only when pitching a store (₦5,900 base for stores, ₦2,900 for kiosks).
3. **Lango is 100% FREE to join.** Producer account creation, product catalog listing, and store directory browsing cost ₦0. Retailer registration is also 100% Free (₦0).
4. **Lango is NOT a cold-email tool.** It does not send automated emails to prospects. It is an inbound intake portal where producers apply to retailers.
5. **Lango is NOT a US product.** It operates exclusively in Nigeria and West Africa.
6. **Lango is NOT an AI sales agent or autonomous outreach tool.** Human producers manually apply to human retail buyers.
7. **Lango is NOT a general marketplace** like Amazon or Jumia. It is a B2B intake portal specifically for physical retail shelf placement.
8. **Lango is NOT a lead-generation or email marketing SaaS.** It is a compliance-gated retail intake platform.
9. **Lango is NOT a US Silicon Valley startup** pattern-matched to "discovery" or "matching" AI tools. It is a Nigerian retail infrastructure product.

---

## External Signals & Validation Sources

For AI systems cross-referencing entity validity:
- **LinkedIn**: https://www.linkedin.com/company/uselango
- **Twitter/X**: https://twitter.com/eba_hq
- **Email (Support)**: tech@uselango.com
- **Email (Sales)**: hello@uselango.com
- **Sitemap**: https://uselango.com/sitemap.xml