# Order Flow by Feasibility Status

## Overview
The order flow is determined by the feasibility check result. All products now have real pricing displayed. This document outlines the different flows based on feasibility status and product type.

## Product Categories

### Products Requiring Feasibility Check
These products require coverage check before ordering:
1. **Magellan Metro-VPN** (40Mbps to 2000Mbps) - $85 to $963/month
2. **Shared Business Broadband** (Channel 50 to 250) - $67.98 to $339.89/month
3. **Dedicated Burst Internet** (20Mbps to 40Mbps base) - $407.87 to $815.74/month

### Products NOT Requiring Feasibility Check (Custom Quote Only)
These products always require custom quotation regardless of location:
1. **Dedicated Internet Access (DIA)** - Custom pricing
2. **IP Transit (IPT)** - Custom pricing
3. **Dark Fibre Lease** - Custom pricing
4. **International Private Line Circuit (IPLC)** - Custom pricing
5. **InterCity-VPN** - Custom pricing

## Feasibility Status Types

### 1. High Feasibility (Fibre Available)
**Indicator:** ✅ Green - "Fibre available at your location"

**Characteristics:**
- Fibre infrastructure already exists at location
- No extension required
- Standard installation (21 working days)
- No additional infrastructure costs
- Pricing is transparent and fixed

**Order Flow:**
1. Customer completes coverage check → High feasibility result
2. Full product catalogue displayed with real monthly prices
3. Customer selects package → **"Order Now"** button ONLY
4. Proceeds directly to shopping cart
5. Checkout with installation date selection
6. Payment
7. Order confirmed → Installation scheduled

**UI Behavior:**
- Product details page shows: **"Order Now"** button only
- No "Request Quote" button shown
- Message: "✅ Fibre available at your location - Order instantly and proceed to checkout"
- Displays real monthly pricing (e.g., $85.00/month for Magellan 40Mbps)

---

### 2. Medium Feasibility (Fibre Nearby - Extension Required)
**Indicator:** ⚠️ Yellow - "Fibre available nearby – extension required"

**Characteristics:**
- Fibre within 500m-2km road distance
- Extension/trenching required
- Additional infrastructure costs apply (calculated per meter)
- Extended installation lead time (30-45 working days)
- Base monthly price is known, but extension cost needs quotation

**Order Flow:**
1. Customer completes coverage check → Medium feasibility result
2. Product catalogue displayed with base monthly prices
3. System shows estimated extension cost
4. Customer selects package → **"Request Quote"** button ONLY
5. Completes quotation request form:
   - Selected package (with known monthly price)
   - Preferred installation date
   - Service address (auto-filled)
   - Contact details
   - Special requirements
   - Optional: Site photos/floor plan
6. System creates quotation in Odoo CRM
7. Sales rep coordinates site survey to confirm exact extension cost
8. Sales rep prepares formal quotation including:
   - Monthly package price (e.g., $152.00/month for Magellan 100Mbps)
   - Installation/activation fee
   - **Confirmed extension cost** (from site survey)
   - Equipment costs
   - Total upfront payment
   - Monthly recurring charges
   - Contract terms
9. Customer receives quotation in portal
10. Customer accepts quotation → Converts to order
11. Proceeds to payment
12. Order confirmed → Installation scheduled

**UI Behavior:**
- Product details page shows: **"Request Quote"** button only
- No "Order Now" button shown
- Message: "⚠️ Fibre available nearby - Extension required. Request a quote for accurate pricing including extension costs."
- Displays base monthly pricing but notes extension costs apply

---

### 3. Low/No Feasibility (No Fibre Coverage)
**Indicator:** ❌ Red - "Fibre not currently available at your location"

**Characteristics:**
- Beyond 2km road distance from fibre
- No immediate fibre availability
- Alternative solutions available (V-SAT, Starlink, Wireless)
- Custom feasibility study may be requested (charges may apply)

**Order Flow:**
1. Customer completes coverage check → Low feasibility result
2. Alternative solutions displayed:
   - V-SAT Satellite
   - Starlink
   - Wireless Broadband
3. Customer options:
   - **Option A:** View alternative solutions (Starlink, V-SAT)
   - **Option B:** Register interest for future fibre rollout
   - **Option C:** Contact sales team for custom feasibility study

**UI Behavior:**
- Product details page shows:
  - **"View Alternative Solutions"** button (redirects to coverage check)
  - **"Contact Sales Team"** button (mailto: sales@afinet.africa)
- Message: "❌ Fibre not currently available at your location. Check alternative solutions (Starlink, V-SAT) or contact our sales team for custom feasibility study."
- Coverage check page shows:
  - Alternative solution cards (V-SAT, Starlink, Wireless)
  - "Register Interest for Future Rollout" button
  - "Contact Sales Team" button

---

## Custom Enterprise Services (No Feasibility Required)
**Products:** DIA, IP Transit, Dark Fibre, IPLC, InterCity-VPN

**Order Flow:**
1. Customer views custom enterprise package
2. **"Request Custom Quote"** button only
3. No feasibility check required
4. Sales team prepares tailored quotation based on:
   - Bandwidth requirements
   - Geographic locations
   - SLA requirements
   - Contract terms
5. Custom pricing and terms provided

**UI Behavior:**
- Message: "💼 This service requires a custom quotation. Our sales team will prepare a tailored quote based on your specific requirements."
- No pricing displayed (custom quote only)

---

## Product Pricing Reference

### Magellan Metro-VPN
| Capacity | Monthly Price | Description |
|----------|--------------|-------------|
| 40 Mbps | $85.00 | Metro ethernet connection |
| 100 Mbps | $152.00 | Metro ethernet connection |
| 200 Mbps | $274.00 | Metro ethernet connection |
| 300 Mbps | $375.00 | Metro ethernet connection |
| 600 Mbps | $457.00 | Metro ethernet connection |
| 1000 Mbps | $522.00 | Metro ethernet connection |
| 2000 Mbps | $963.00 | Metro ethernet connection |
| 1000 Mbps NNI | $80.00 | NNI connection fee |

### Shared Business Broadband
| Channel | Monthly Price | Effective Bandwidth | Description |
|---------|--------------|-------------------|-------------|
| Channel 50 | $67.98 | 3.33 Mbps | Shared internet up to 50Mbps (1:15 contention) |
| Channel 100 | $135.96 | 6.67 Mbps | Shared internet up to 100Mbps (1:15 contention) |
| Channel 200 | $271.91 | 13.33 Mbps | Shared internet up to 200Mbps (1:15 contention) |
| Channel 250 | $339.89 | 16.67 Mbps | Shared internet up to 250Mbps (1:15 contention) |

### Dedicated Burst Internet
| Configuration | Monthly Price | Description |
|--------------|--------------|-------------|
| 20 Mbps Burst to 100 | $407.87 | Dedicated 20Mbps, burst to 100Mbps |
| 30 Mbps Burst to 150 | $611.80 | Dedicated 30Mbps, burst to 150Mbps |
| 40 Mbps Burst to 200 | $815.74 | Dedicated 40Mbps, burst to 200Mbps |

---

## Summary Table

| Feasibility | Button(s) Shown | Flow Type | Quotation Required | Pricing Display |
|-------------|----------------|-----------|-------------------|----------------|
| High | Order Now | Direct Order | No | Real monthly price |
| Medium | Request Quote | Quotation First | Yes | Base price + extension TBD |
| Low | View Alternatives + Contact Sales | Alternative Solutions | N/A | N/A |
| Custom Enterprise | Request Custom Quote | Custom Quotation | Yes | Custom pricing |
| No Check Done | Check Coverage First | Coverage Check | N/A | Real monthly price shown |

---

## Implementation Notes

### Frontend Changes
1. **Product Details Page** (`afinet-portal/src/app/(portal)/products/[id]/page.js`)
   - Reads feasibility status from localStorage
   - Shows appropriate buttons based on status and product type
   - High: Order Now only (for feasibility-required products)
   - Medium: Request Quote only
   - Low: View Alternatives + Contact Sales
   - Custom Enterprise: Request Custom Quote (no feasibility check)
   - No check: Check Coverage First

2. **Coverage Check Page** (`afinet-portal/src/app/(portal)/coverage-check/page.js`)
   - Stores both `id` (database ID) and `check_id` in localStorage
   - Low feasibility shows alternative solutions
   - Added "Contact Sales Team" button for low feasibility

### Backend Validation
- Quotation requests require valid `feasibility_check_id` (database ID) for feasibility-required products
- Custom enterprise services (DIA, IP Transit, Dark Fibre, IPLC, InterCity-VPN) bypass feasibility check requirement
- Extension costs calculated and included in medium feasibility quotations
- All products now have real pricing in database

---

## User Experience Goals

1. **High Feasibility:** Frictionless ordering - see real price, direct to cart/checkout
2. **Medium Feasibility:** Transparent about extension costs - quotation ensures accurate total pricing
3. **Low Feasibility:** Clear alternatives and sales contact - no dead ends
4. **Custom Enterprise:** Clear that custom quote is needed - no false expectations
5. **All Cases:** Real pricing displayed where applicable - no surprises

---

Last Updated: 2026-02-23