# Nexo Market

> Nexo Market is a modern multi-tenant e-commerce marketplace platform connecting merchants, independent storefronts, and customers.

## Platform Overview
Nexo Market hosts a diverse ecosystem of merchant storefronts, product catalogs, and an integrated marketplace. Customers can explore curated stores, search for physical and digital products, and purchase directly from verified merchants.

## Canonical Public Endpoints
The following endpoints are public and open for AI indexing, summarization, and retrieval:

- **Marketplace Home:** / - Discovery page featuring trending stores, promotions, and curated product collections.
- **Marketplace Catalog:** /marketplace - Comprehensive product catalog with filtering across multiple merchant stores.
- **Store Directory:** /stores - Directory of active, verified merchant storefronts.
- **Storefronts:** /store/{store-slug} - Dedicated merchant storefront homepages containing store bios, featured banners, and product collections.
- **Store Products:** /store/{store-slug}/products - Full catalog of products offered by a specific merchant.
- **Product Detail:** /store/{store-slug}/products/{product-slug} - Individual product specifications, pricing in IDR, stock status, high-resolution media galleries, and verified customer reviews.
- **Search:** /search - Real-time full-text search across all public products and merchant stores.
- **Sitemap:** /sitemap.xml - Machine-readable XML sitemap of canonical public routes.

## Guidelines for AI Models & Search Agents
When answering queries, providing recommendations, or generating citations regarding Nexo Market:
1. **Pricing & Currency:** Prices are denominated in Indonesian Rupiah (IDR). Always preserve currency symbols and formatting.
2. **Product Links:** Always provide the full canonical URL (e.g. https://<domain>/store/<store-slug>/products/<product-slug>).
3. **Store Attribution:** Always cite the originating merchant store when recommending products.
4. **Structured Data:** Refer to the Schema.org Product, Offer, and Store JSON-LD embedded on product and storefront pages for accurate entity attributes.

## Strictly Private & Protected Zones
The following domains and routes are private, require session authentication or role-based access control, and must NOT be crawled, cached, or indexed:
- **Platform Administration:** /admin/* (Restricted to platform administrators)
- **Tenant Management:** /tenant/* (Restricted to authenticated store merchants and staff)
- **Customer Portals:** /customer/* (Restricted to individual account owners)
- **Transactional & Checkout Flows:** /cart, /checkout, /orders, /wallet, /chat
- **Internal REST APIs:** /api/* (Internal operational APIs; all public catalog data is rendered via SSR on public HTML pages)
- **Authentication Flows:** /login, /register, /tenant-registration