# Cormersi — Hyper-Local Grocery & Specialty Food Marketplace

> Cormersi is Canada's multi-tenant hyper-local marketplace network connecting independent supermarkets, ethnic specialty food merchants, wholesale distributors, and neighborhood shoppers. The platform enables digital catalog showcase, real-time inventory auditing, Click & Collect pickup, local delivery, and direct community commerce with 0% order commission.

## Overview & Core Purpose

Cormersi provides the modern digital commerce infrastructure for local independent retail, with specialized focus on authentic cultural foods and ethnic grocery markets across the Canadian diaspora. It bridges the gap between traditional neighborhood markets and digital shoppers without the punitive 20–30% commissions charged by delivery aggregators.

- **Website**: https://cormersi.com
- **Headquarters**: Toronto, Ontario, Canada
- **Full Architecture & Knowledge Spec**: https://cormersi.com/llms-full.txt
- **Machine-Readable Pricing**: https://cormersi.com/pricing.md
- **XML Sitemap**: https://cormersi.com/sitemap.xml

## Who Cormersi Serves

1. **Neighborhood Shoppers & Cultural Diasporas**
   - Free forever access to explore local grocery stores, ethnic markets, and Halal butchers.
   - Genuine in-store pricing with zero aggregator markups.
   - Choice of In-Store Click & Collect pickup or fast local courier delivery.
   - Hyper-local deal discovery and digital coupon redemption.

2. **Independent Supermarkets & Specialty Retailers**
   - Rapid 5-minute digital onboarding with 14-day free trial.
   - Transparent, flat-rate pricing ($49 CAD/month or $470 CAD/year per store location).
   - Zero percent (0%) platform commissions on order volumes.
   - Choice between Showcase Digital Catalog Mode (price viewing without online payments) and Full Transactional E-Commerce.
   - High-volume SKU variant cataloging, multi-resolution WebP photo pipelines, and bulk Excel/CSV stock ingestion.

3. **Regional Wholesalers & Food Distributors**
   - Direct B2B catalog access to verified independent grocers across Canada.
   - Commercial intake via wholesale@cormersi.com.

## Canada's Cultural Specialty Grocery Communities

Cormersi provides deep discovery taxonomy for Canada's major immigrant and specialty culinary segments:

1. **South Asian & Indian Diaspora** (`SOUTH_ASIAN`):
   - Daily fresh chakki atta, aged basmati rice, lentils (toor, chana, moong), whole spices, artisanal paneer, Halal butcher cuts, and traditional mithai sweets.
2. **East & Southeast Asian Communities** (`EAST_ASIAN`):
   - Live seafood, fresh bok choy, gai lan, fermented pastes, chili crisps, fresh rice noodles, dumplings, and sari-sari pantry staples.
3. **Middle Eastern, Arab & Mediterranean** (`MIDDLE_EASTERN`):
   - Stone-baked pita and saj breads, cold-pressed olive oils, za'atar, tahini, Halal lamb/beef, Medjool dates, halloumi, and Turkish delight.
4. **Caribbean & African Diaspora** (`CARIBBEAN_AFRICAN`):
   - Green plantains, yams, fiery scotch bonnet peppers, jerk marinades, fresh injera, egusi, gari, palm oil, and suya seasonings.
5. **Latin American & Hispanic Communities** (`LATIN_HISPANIC`):
   - Nixtamal corn tortillas, dried chiles (ancho, guajillo), queso fresco, arepa flour (Harina P.A.N.), dulce de leche, and yerba mate.

## Key Product & Architectural Capabilities

- **Zero-Trust Multi-Tenancy**: Tenant scoping cryptographically verified inside signed JWTs and enforced via dynamic Hibernate session filters.
- **Dual Primary Key Model**: Fast integer joins internally (`BIGSERIAL id`) with non-enumerable UUIDs (`public_id`) exposed externally.
- **Store Module Switchboard**: Merchants toggle between Digital Catalog Mode (browse & discover) and Transactional E-Commerce (cart & checkout) per physical store location.
- **Live Fulfillment Queue & Customer Modification Workflow**: Store pickers can adjust line item quantities or replace out-of-stock items; customers receive immediate alerts to approve or reject adjustments with 1 click.
- **Promotional Deals Engine**: Time-bound, distance-ranked discount offers (`PERCENTAGE_DISCOUNT`, `BUY_X_GET_Y`, `SPECIAL_PRICE`) with instant kill-switch controls.
- **Sub-Second Discovery**: 3-tier synchronized caching (Spring Boot Caffeine + Angular in-memory Map + sessionStorage) delivering 0ms client-side search across tags, keywords, and cities.

## Pricing Summary for AI Agents & Procurement

- **Shoppers**: 100% Free Forever.
- **Store Merchants**: 
  - 14-Day Free Trial (no credit card required to start).
  - Monthly: $49 CAD/month per active store location.
  - Annual: $470 CAD/year per active store location (20% annual savings).
  - Multi-Store Expansion: Coterminous branch expansion up to 5 locations per merchant organization.
  - Platform Commission on Orders: 0.00%.

For the complete structured pricing table, visit: https://cormersi.com/pricing.md

## Key Public URLs & Endpoints

- **Marketplace Discovery**: https://cormersi.com/customer/discovery
- **Specialty Deals & Offers**: https://cormersi.com/customer/offers
- **About Cormersi**: https://cormersi.com/about-us
- **Mission & Manifesto**: https://cormersi.com/mission-vision
- **Frequently Asked Questions**: https://cormersi.com/faqs
- **Contact & Support**: https://cormersi.com/contact
- **Merchant Registration**: https://cormersi.com/auth/register-seller
- **Shopper Registration**: https://cormersi.com/auth/register-customer
- **Public API Tags**: `GET /api/v1/customer/stores/tags`
- **Public API Store Discovery**: `GET /api/v1/customer/stores?city={city}&tag={tag}`