create mvp path

2026-08-02 20:01:31 +03:30
parent 72ab290da1
commit fb58ca54e1
203 changed files with 863 additions and 156 deletions
@@ -16,7 +16,7 @@ color schemes on the first try.

 **Precedence.** This skill is the **design** contract — brand, tone, and the visual
 decisions. The **engineering** contract is [client/CLAUDE.md](../../../client/CLAUDE.md)
-(hard rules) plus [docs/rules/client/](../../../docs/rules/client/) (one reference file
+(hard rules) plus [docs/rules/client/](../../../archive/docs/rules/client/) (one reference file
 per area). Where the two overlap — tokens, typography, the component library, shells,
 icons — **`docs/rules/client/` is authoritative and this skill defers to it.** Read the
 relevant one before touching layout, provider, or data code; don't restate it here, and
@@ -24,10 +24,10 @@ never violate it.

 | For | Read |
 |-----|------|
-| Tokens, palette, dark mode, RTL, fonts, motion | [docs/rules/client/theme.md](../../../docs/rules/client/theme.md) |
-| The `App*` library, shells, navigation, icons | [docs/rules/client/components.md](../../../docs/rules/client/components.md) |
-| Copy and Persian orthography | [docs/rules/client/i18n.md](../../../docs/rules/client/i18n.md) |
-| Forms | [docs/rules/client/forms.md](../../../docs/rules/client/forms.md) |
+| Tokens, palette, dark mode, RTL, fonts, motion | [docs/rules/client/theme.md](../../../archive/docs/rules/client/theme.md) |
+| The `App*` library, shells, navigation, icons | [docs/rules/client/components.md](../../../archive/docs/rules/client/components.md) |
+| Copy and Persian orthography | [docs/rules/client/i18n.md](../../../archive/docs/rules/client/i18n.md) |
+| Forms | [docs/rules/client/forms.md](../../../archive/docs/rules/client/forms.md) |

 **Stack:** Next.js 16 (App Router, Turbopack) · React 19 · MUI v9 (`@mui/material`) ·
 Emotion (RTL via `stylis-plugin-rtl`) · next-intl v4 · notistack. Everything below
@@ -128,7 +128,7 @@ these; they're define-only in CSS):
 - **Map** — `--bal-pin-shadow`, the address-picker pin.

 Full catalogue, with what each group backs:
-[docs/rules/client/theme.md](../../../docs/rules/client/theme.md) §2.
+[docs/rules/client/theme.md](../../../archive/docs/rules/client/theme.md) §2.

 ---

@@ -188,7 +188,7 @@ Beyond the `App*` wrappers there is a **state kit** — `EmptyState`, `ErrorStat
 `InitialsAvatar`, `FormDialogShell` — with **one pattern per state**. Never hand-roll a
 dashed-border "nothing here" block or a per-screen pager; and **an error state is never an
 empty state.** Catalogue in
-[docs/rules/client/components.md](../../../docs/rules/client/components.md).
+[docs/rules/client/components.md](../../../archive/docs/rules/client/components.md).

 For layout/spacing use MUI primitives directly: `Box`, `Stack`, `Container`, `Grid`,
 `Paper`, `Card`. Use the `spacing`/`sx` system (theme spacing unit = 8px) — never inline
@@ -197,18 +197,18 @@ pixel margins for rhythm.
 **New shared component?** Put it in `src/components/<Name>/<Name>.tsx` with an
 `index.tsx` barrel, follow the `App*` prop-spreading + JSDoc style of `AppButton.tsx`,
 and add a co-located `.test.tsx` (mandatory for anything imported in >1 place — see
-[docs/rules/client/testing.md](../../../docs/rules/client/testing.md); wrap with
+[docs/rules/client/testing.md](../../../archive/docs/rules/client/testing.md); wrap with
 `<ThemeProvider>`, never mock MUI). If it goes at the top of the `@/components/common`
 barrel, prefer **caller-owned copy** (required `title`/`body`/`retryLabel` string props)
 over calling `useTranslations` inside it — `next-intl` is ESM-only and poisons every test
 that transitively imports the barrel. `ErrorBoundary`/`ErrorState` are the model;
-[components.md](../../../docs/rules/client/components.md) has the why.
+[components.md](../../../archive/docs/rules/client/components.md) has the why.

 **Any form with more than one field is a react-hook-form form**, bound through the
 `@/components/common/form` wrappers (`RhfTextField`, `RhfChipSelect`,
 `RhfJalaliDateField`, `RhfControlGroup`) and grouped into `FormSection`s. A single-field
 control is state, not a form. Full pattern:
-[docs/rules/client/forms.md](../../../docs/rules/client/forms.md).
+[docs/rules/client/forms.md](../../../archive/docs/rules/client/forms.md).

 ---

@@ -341,14 +341,14 @@ Every screen/component you produce must satisfy **all** of these:
   switches automatically. Verify on both schemes — never assume a light background.
 4. **Tokens, not hexes.** No raw color literals in `sx`/`styled`/components (§2).
 5. **Constants, not magic values.** Cookie names, routes, repeated dimensions, event
-   names → named constants ([components.md](../../../docs/rules/client/components.md) §5).
+   names → named constants ([components.md](../../../archive/docs/rules/client/components.md) §5).
 6. **Use the wrappers** (§4) and the **icon registry** (§6) before bare MUI.
 7. **Shared component ⇒ co-located test** (§4).
 8. **MUI v9 API only.** No v5/v6-era props (e.g. `Stack` `useFlexGap`, `storageWindow`).
   Avoid deprecated APIs that throw.
 9. **Persian copy follows the style guide** — «بالین‌یار» with a ZWNJ, تأیید with a hamza,
   جستجو in one form, formal شما. `npm run lint:copy` fails the gate on a banned variant.
-   Glossary and the full rules: [i18n.md](../../../docs/rules/client/i18n.md) §4.
+   Glossary and the full rules: [i18n.md](../../../archive/docs/rules/client/i18n.md) §4.
 10. **A screen never fabricates a figure.** A summary reads only off a query that already
    answers it; a count still in flight is omitted, never faked or defaulted.

@@ -366,10 +366,10 @@ Every screen/component you produce must satisfy **all** of these:
 5. **Verify the four axes:** `/fa` (RTL) and `/en` (LTR) × light and dark. The default
   route is `/fa` — start there.
 6. **Tests** for any new shared component; **never** add a layout above `[locale]`
-   (breaks locale/dir — see [structure.md](../../../docs/rules/client/structure.md)).
+   (breaks locale/dir — see [structure.md](../../../archive/docs/rules/client/structure.md)).
 7. Data/fetch/auth/cookies/toasts → follow
-   [services.md](../../../docs/rules/client/services.md) and
-   [auth.md](../../../docs/rules/client/auth.md) (`serverFetch`/`clientFetch`,
+   [services.md](../../../archive/docs/rules/client/services.md) and
+   [auth.md](../../../archive/docs/rules/client/auth.md) (`serverFetch`/`clientFetch`,
   `@/lib/cookies/*`, `dispatchToast`/`useSnackbar`). Don't reinvent these.

 ---