# Proposal

## Why

The store directory and store home still render four hard-coded shops, and the cart, payment and order surfaces fall back to a generic "Shop" label because nothing exposes a buyer-facing shop read. Products already carry `shop_id`; the missing piece is the profile.

## What Changes

- Add a `shop_profiles` table keyed to shops — logo, banner, company, region, address, notice, after-sale text and four scores — kept separate from `shops` so the admin and shop-admin contracts do not change.
- Add public `GET /api/shops` and `GET /api/shops/{slug}` returning a profile composed with its shop; the store directory, store home and product-page store card read them, taking products from the catalog API by `shop_id`.
- Add `PUT /api/admin/shops/{id}/profile` for platform admins, and fill the four demo shops from `seed-demo.mjs`, which is the only place that knows the shops exist.
- Retire the mock's `distanceKm`: there is no geo model behind it, so the distance column and its sort are removed rather than filled with an invented number.
- Let the cart, payment and order surfaces resolve `shop_id` to a real name from that read, retiring the generic "Shop" label.

## Capabilities

### New Capabilities

- `store-directory`: the buyer-facing view of a shop — its profile and its products — read publicly and maintained by platform admins.

### Modified Capabilities

- `frontend-mall`: the store directory and store home read live shops instead of fixed mock content, and order surfaces show real shop names.

## Impact

A new migration and route module; `packages/shared/src/{api,types}.ts`; `pages/stores/{index,[id]}.vue`, the store card in `pages/goods/[id].vue`, `pages/checkout/pay.vue` and `pages/user/orders/index.vue`; `scripts/seed-demo.mjs`; the mall's fixed-data adapter. The contract change rebuilds all three frontends.

## Non-goals

No reviews model: the four scores stay stored profile values, not derived ratings. No geo data or distance. No merchant self-service editing — platform admin only. No work on the seckill, collective or integral pages, nor coupons, favourites or addresses.