Samir Boulahtit
e9253fbd84
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>
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# 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
|