Files
orion/TERMINOLOGY.md
Samir Boulahtit e9253fbd84 refactor: rename Wizamart to Orion across entire codebase
Replace all ~1,086 occurrences of Wizamart/wizamart/WIZAMART/WizaMart
with Orion/orion/ORION across 184 files. This includes database
identifiers, email addresses, domain references, R2 bucket names,
DNS prefixes, encryption salt, Celery app name, config defaults,
Docker configs, CI configs, documentation, seed data, and templates.

Renames homepage-wizamart.html template to homepage-orion.html.
Fixes duplicate file_pattern key in api.yaml architecture rule.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 16:46:56 +01:00

1.7 KiB

Terminology Guide

This document defines the standard terminology used throughout the Orion codebase.

Core Multi-Tenant Entities

Term Definition Database Table Example
Platform The marketplace itself — the top-level entity that hosts merchants platforms "Letzshop.lu"
Merchant A business entity that signs a contract with the platform merchants "Boulangerie Dupont SARL"
Store A specific shop/location operated by a merchant stores "Boulangerie Dupont - Kirchberg"
Storefront The customer-facing view of a store (URL namespace, not a model) https://dupont.letzshop.lu/

Entity Hierarchy

Platform
└── Merchant (the business / legal entity)
    └── Store (the individual shop / brand)
        └── Storefront (customer-facing view — URL namespace only)

Historical Mapping

These terms were renamed from the original codebase terminology:

Old Term New Term Reason
Company Merchant "Merchant" is industry-standard (Shopify, Stripe, Square) for the business entity selling on a platform
Vendor Store "Vendor" in e-commerce commonly means "supplier" (someone who sells TO a platform), not a seller on a platform. "Store" is unambiguous.

Usage Guidelines

  • Use Merchant when referring to the business entity, contracts, billing, legal matters
  • Use Store when referring to the specific shop, its products, inventory, orders, and customer-facing operations
  • Use Storefront only when referring to the customer-facing URL or display layer
  • Never use "Company" or "Vendor" in new code — always use the terms above