Basic Architecture of Sport Web

apps/storefront/src/features/account/README.md

@@ -0,0 +1,24 @@
+# feature: account
+
+Profile, addresses and account settings.
+
+## Structure
+
+```
+account/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/auth/README.md

@@ -0,0 +1,24 @@
+# feature: auth
+
+Sign in, register, password reset, and the session store the rest of the app reads.
+
+## Structure
+
+```
+auth/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/cart/README.md

@@ -0,0 +1,24 @@
+# feature: cart
+
+Bag drawer and page, line-item mutations, optimistic quantity updates.
+
+## Structure
+
+```
+cart/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/category/README.md

@@ -0,0 +1,24 @@
+# feature: category
+
+Category landing pages, breadcrumbs and the facet sidebar.
+
+## Structure
+
+```
+category/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/checkout/README.md

@@ -0,0 +1,24 @@
+# feature: checkout
+
+Multi-step checkout: address, delivery, payment, review.
+
+## Structure
+
+```
+checkout/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/collection/README.md

@@ -0,0 +1,24 @@
+# feature: collection
+
+Campaign and editorial collection pages.
+
+## Structure
+
+```
+collection/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/order/README.md

@@ -0,0 +1,24 @@
+# feature: order
+
+Order confirmation and order history views.
+
+## Structure
+
+```
+order/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/product/README.md

@@ -0,0 +1,24 @@
+# feature: product
+
+PDP: gallery, variant selector, price display, add-to-bag. Owns `<ProductCard>`.
+
+## Structure
+
+```
+product/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/search/README.md

@@ -0,0 +1,24 @@
+# feature: search
+
+Search input, suggestions, results and the shared filter state.
+
+## Structure
+
+```
+search/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.

apps/storefront/src/features/wishlist/README.md

@@ -0,0 +1,24 @@
+# feature: wishlist
+
+Save-for-later toggles and the wishlist page.
+
+## Structure
+
+```
+wishlist/
+├── components/   # UI specific to this feature
+├── hooks/        # React hooks (client-side only)
+├── services/     # Calls into @sport/api-client, plus query keys
+├── stores/       # Zustand slices, only if this feature owns client state
+└── types.ts      # View-model types. Domain types come from @sport/types.
+```
+
+## Rules
+
+- A feature may import from `@/components`, `@/lib`, `@/hooks` and any
+  `@sport/*` package.
+- A feature must **not** import from another feature's internals. If two
+  features need the same thing, it moves up to `@/components` or `@/lib`.
+  Cross-feature imports are what turn a feature folder into a second, worse
+  module system.
+- Data fetching goes through `@sport/api-client`. No raw `fetch` to the API.