# Ecommerce template (llms.txt)

## Site purpose
This is a minimal, mobile-first commerce template: product gallery, guest checkout, cash on delivery. No payment processor in the app.

## Contact & operations
- Contact, phone, and social links are configured via environment / `site` config.
- Public policy pages are not included by default; add your own and link them from the footer if needed.

## Catalog
- Products and images are managed in MongoDB. Product images are **external URLs** (not uploaded to the server in v1).
- Canonical product pages on the storefront are **`/{locale}/p/{slug}`** (e.g. `/en/p/linen-dress`). The old `.../products/...` path redirects to that URL.
- Optional **size/color** variants and **supplier** name are supported on products.
- The **admin** area and **admin API** use a **hidden path** from `ADMIN_BASE_PATH` (not a public `/admin` link). See deployment documentation.

## API (automation)
- Public: `GET /api/products`, `GET /api/products/[slug]`, `POST /api/orders` (COD, `locale` in body, optional `Idempotency-Key`).
- Admin: `POST` bulk products to `/{ADMIN_BASE_PATH}/api/products` with `Authorization: Bearer` or `X-Admin-Secret` and optional `?validateOnly=true` for dry-run. See `docs/API.md` in the repository.

## Language
- Storefront is internationalized (e.g. en, fr, ar) with Arabic RTL.

## Do not
- Do not guess the admin URL; it is intentionally unlisted.
- Do not store secrets in `NEXT_PUBLIC_*` variables.