chore(openspec): archive replace-mock-api-wave-5

The merge creates the store-directory capability (two requirements, six
scenarios) and updates the mall's store-and-marketing requirement so the store
directory and store home read live shops and order surfaces name their shop.

openspec validate --all --strict stays green at 13 specs.
This commit is contained in:
2026-09-17 17:13:49 +00:00
parent d0b6350d2d
commit b44ba39e8c
8 changed files with 46 additions and 2 deletions
+36
View File
@@ -0,0 +1,36 @@
# store-directory Specification
## Purpose
The buyer-facing view of a shop: its public profile — identity, contact and service copy — alongside the products it sells, so the store directory, a store's home page and the store card on a product page all read real shops.
## Requirements
### Requirement: Public shop directory
`GET /api/shops` SHALL list the active shops without authentication, and `GET /api/shops/{slug}` SHALL return one shop by slug, answering 404 for an unknown slug or a suspended shop. Each entry SHALL carry the shop's id, slug, bilingual name and its profile: logo and banner URLs, company, region, bilingual address, bilingual notice and after-sale copy, and four score values. A shop with no profile row SHALL still be returned, with the profile fields absent rather than invented.
#### Scenario: directory lists active shops only
- **WHEN** a suspended shop exists alongside active ones
- **THEN** the directory lists only the active shops
#### Scenario: store home by slug
- **WHEN** a shopper opens a shop's slug
- **THEN** the profile and the shop's products are available, with the products filtered by that shop through the catalog API
#### Scenario: unknown slug is a 404
- **WHEN** a shopper opens a slug that does not exist
- **THEN** the API answers 404 rather than an empty profile
### Requirement: Shop profile management
A platform admin SHALL set a shop's profile with `PUT /api/admin/shops/{id}/profile`, which upserts the profile row and returns the composed shop. Bilingual fields SHALL carry non-empty `en` and `zh` text, and the write SHALL require the `platform_admin` role.
#### Scenario: profile upsert round-trips
- **WHEN** an admin sets a profile and then reads the shop publicly
- **THEN** the public read returns those values
#### Scenario: incomplete bilingual text is refused
- **WHEN** an admin submits a notice with only `en` text
- **THEN** the request is refused and the stored profile is unchanged
#### Scenario: only platform admins may write
- **WHEN** a shop owner or customer submits a profile
- **THEN** the API refuses the write