apps/docs/docs/development/commands.md

@@ -37,7 +37,7 @@
 
 | Команда | Описание |
 |---|---|
-| `npm run dev -w apps/frontend` | `vite` |
+| `npm run dev -w apps/frontend` | `vite` (`VITE_API_MOCK=true` включает browser MSW)` |
 | `npm run build -w apps/frontend` | `tsc -b && vite build` |
 | `npm run preview -w apps/frontend` | `vite preview` |
 | `npm run codegen -w apps/frontend` | `openapi-typescript` из Swagger → `src/shared/api/types.ts` |

apps/docs/docs/frontend/overview.md

@@ -97,6 +97,12 @@ apps/frontend/src/
 - `app/layouts/` — AppLayout (шапка + Outlet)
 - `app/App.tsx` — RouterProvider → router
 
+### Runtime config
+
+- `shared/config/env.ts` — Zod-схема для `VITE_*` переменных, валидируется на старте приложения
+- `mocks/browser.ts` — browser MSW worker, включается только при `VITE_API_MOCK=true`
+- `mocks/handlers.ts` — общий набор mock handlers для browser- и test-mode
+
 ### entities
 
 Домены бизнес-сущностей переведены в FSD: