linic-wellness-shadcn/AGENTS.md

# AGENTS.md

Northline Clinic — planned care clinic template: пациентский маршрут, triage-запись, подготовка к визиту, документы, privacy, специалисты и координатор без медицинских обещаний результата.

## Project Specifics

- Source content lives in `src/entities/site-content.ts`; keep visible copy there or directly in route JSX.
- `src/app` — только route wrappers; композиция каждой страницы живёт в отдельном widget (`src/widgets/<page>-page.tsx`). Header/footer — `src/widgets/site-shell.tsx`. См. File Map.
- Keep cards at 8px radius or less and preserve the selected palette in `src/app/globals.css`.
- This is a static frontend template: do not add real payments, auth, persistence, external API calls, or backend contracts without an explicit product request.
- Keep the domain specific: planned care, triage, preparation, diagnostic route, result review, insurance/privacy and non-emergency boundaries. Do not flatten it into generic wellness cards.
- Never add diagnoses, treatment schemes, dosage advice, guaranteed outcomes, emergency-care replacement, real EHR behavior or patient-data submission.
- After changes run `pnpm lint` and `pnpm build`.

## Визуальные правки

- Кириллица обязательна для видимого текста и выбранных Google Fonts.
- При AI-правках сохраняйте доменные блоки этого шаблона: они отличают проект от generic landing.

## Design System

Источник токенов — `src/app/globals.css` (`@theme inline` + `:root`/`.dark`). Шрифты: заголовки и `.font-display` — **Manrope** (`--font-display`), body — **Source Sans 3** (`--font-sans`); mono замаплен на display. Работай через семантические классы Tailwind (`bg-primary`, `text-muted-foreground`, `border-border`, `border-primary/30`), не хардкодь hex/oklch.

Личность: **calm clinical / planned care** — тёплый кремово-бежевый фон (low-chroma), приглушённый сине-зелёный teal `primary` (oklch 0.46 0.07 173) как доверие и навигация, мягкий мятный `secondary`, тёплый терракотовый `accent` (oklch 0.72 0.12 34) для редких сигналов. Текст — тёмный teal-ink, а не чистый чёрный. Никакой «больничной» стерильности и никакого агрессивного маркетинга — спокойная, аккуратная среда.

| Роль | Light | Характер |
|---|---|---|
| `background` | тёплый кремово-бежевый (0.976) | основной фон страниц |
| `foreground` | тёмный teal-ink (0.18) | текст |
| `primary` | приглушённый teal | доверие: иконки, CTA, бейджи (`text-primary`), eyebrow, `border-primary/30` |
| `secondary` | мягкий мятный | вторичные бейджи (теги маршрутов) |
| `accent` | тёплый терракот | редкий сигнал (используется сдержанно) |
| `muted` | тёплый серо-бежевый | чипы, фон-плашки, вторичный текст |
| `card` | почти белый тёплый (0.995) | панели `ClinicalPanel` |
| `border` | мягкий тёплый серый | тонкие границы (`border border-border`) |

Узнаваемые приёмы (держи их, это и есть «лицо» проекта):
- **Мягкие, но не круглые углы:** `--radius` = 0.5rem; почти всё — `rounded-md`. Спокойная гладкость без пузырей.
- **`ClinicalPanel` как базовый блок:** `rounded-md border border-border bg-card shadow-[0_1px_0_rgba(24,74,68,0.05)]` — почти плоская карточка с едва заметной teal-линией снизу. Это основной строительный кирпич контента.
- **Тонкие границы, плоскость:** `border border-border` (1px), без жёстких теней и offset-shadow. Глубина — минимальная.
- **Цветная семантика teal:** иконки, цифры-метрики, eyebrow и активные подписи — `text-primary`; границы-акценты — `border-primary/30`.
- **Типографика:** заголовки — `font-semibold` (не black), `text-5xl`/`text-6xl`, спокойный `leading-tight`/`leading-[1.04]`; eyebrow — `uppercase tracking-[0.16em] text-primary`.
- **Safety-блоки:** предупреждения о неэкстренном характере — `border-amber-200 bg-amber-50 text-amber-900/950` (единственное место с янтарём, намеренно).
- **Фон-фактура:** `.clinic-soft-grid` — мягкая teal/терракотовая сетка под hero с маской снизу; контент в `Container` (`max-w-[1320px]`), фото — `object-cover` БЕЗ grayscale (живые, тёплые снимки).

Do / Don't:
- **Do:** держи спокойную кремово-teal палитру, плоские `ClinicalPanel`, тонкие границы, доменный язык (маршрут, подготовка, координатор, неэкстренный формат), amber только для safety.
- **Don't:** яркие/насыщенные цвета, жёсткие тени, grayscale-фото, `font-black`, агрессивные CTA, медицинские обещания/диагнозы — это ломает доверительную клиническую личность.

## File Map

| Route | Widget |
|---|---|
| `/` | `src/widgets/home-page.tsx` (`HomePage`) |
| `/services` | `src/widgets/services-page.tsx` (`ServicesPage`) |
| `/specialists` | `src/widgets/specialists-page.tsx` (`SpecialistsPage`) |
| `/booking` | `src/widgets/booking-page.tsx` (`BookingPage`) |
| `/patient-info` | `src/widgets/patient-info-page.tsx` (`PatientInfoPage`) |
| `/contacts` | `src/widgets/contacts-page.tsx` (`ContactsPage`) |

Переиспользуемые блоки:
- `src/widgets/site-shell.tsx` — `SiteHeader` + `SiteFooter` (обёртка всех страниц через `app/layout.tsx`).
- `src/widgets/patient-journey.tsx` — `PatientJourney` (Home, Booking).
- `src/widgets/featured-grid.tsx` — `FeaturedGrid` (Home, Services).
- `src/widgets/specialist-schedule.tsx` — `SpecialistSchedule` (Home, Booking, Specialists).
- `src/widgets/patient-checklist.tsx` — `PatientChecklist` (Home, Patient info, Booking).
- `src/widgets/facility-board.tsx` — `FacilityBoard` (Home, Contacts).
- `src/widgets/safety-notes.tsx` — `SafetyNotes` (Home, Patient info, Booking).
- `src/widgets/clinical-disclaimer.tsx` — `ClinicalDisclaimer` (Home, Patient info, Booking, Services).
- `src/widgets/metric-strip.tsx` — `MetricStrip` (переиспользуемый блок-кит, готов к композиции).
- `src/shared/ui/container.tsx` — `Container` (контентная обёртка `max-w-[1320px]`, база всех секций).
- `src/shared/ui/clinical-panel.tsx` — `ClinicalPanel` (базовая карточка-панель).
- `src/shared/ui/section-header.tsx` — `SectionHeader` (eyebrow + заголовок + текст секции).
- `src/shared/ui/inner-hero.tsx` — `InnerHero` (заголовочная секция внутренних страниц).
- `src/shared/ui/icon-cards.tsx` — `IconCards` (Contacts, Services).
- `src/shared/ui/info-columns.tsx` — `InfoColumns`, `src/shared/ui/split-story.tsx` — `SplitStory` (переиспользуемые presentational-блоки-кит).

Одноразовые блоки колоцированы со своей страницей: `PageHero`/`TestimonialBand` в `home-page.tsx`, `ServiceMatrix`/`PricingTiles` в `services-page.tsx`, `DoctorGrid`/`CtaPanel` в `specialists-page.tsx`, `ReservationForm` в `booking-page.tsx`, `InsurancePanel` в `patient-info-page.tsx`, `ContactForm` в `contacts-page.tsx`.