astro_minivan/.opencode/skills/minivan/SKILL.md

minivan

Проект: minivan-berlin.de — сервис аренды автомобилей (Minivan) в Берлине.

Стек: Astro (SSR) + SolidJS + PocketBase + Tailwind CSS v4.

Коллекции PocketBase

• users — пользователи
• cars — автомобили
• bookings — бронирования
• reviews — отзывы
• posts — статьи блога
• faq_items — FAQ вопросы
• slider_cars — автомобили для слайдера
• site_settings — настройки сайта
• t_navbar — пункты верхнего меню
• b_navbar — пункты нижнего меню (Footer)
• t_top_header — баннер в шапке
• pages — мета-данные страниц
• preise_services — услуги и цены
• preise_cta — CTA секции цен
• comments — комментарии блога

Структура проекта

frontend/
├── src/
│   ├── pages/
│   │   ├── api/
│   │   │   ├── auth/           # Авторизация
│   │   │   │   ├── login.ts
│   │   │   │   ├── register.ts
│   │   │   │   ├── logout.ts
│   │   │   │   ├── check-auth.ts
│   │   │   │   └── google/
│   │   │   ├── contact.ts
│   │   │   ├── reviews/
│   │   │   └── send-booking.ts
│   │   ├── index.astro           # Главная
│   │   ├── kontakt.astro        # Контакты
│   │   ├── preise.astro        # Цены
│   │   ├── impressum.astro    # Impressum
│   │   ├── datenschutz.astro # Privacy
│   │   ├── agb.astro        # Terms
│   │   ├── stornierung.astro # Cancellation
│   │   ├── zahlungsarten.astro # Payment
│   │   ├── bewertungen.astro # Reviews
│   │   ├── partner.astro    # Partner
│   │   ├── karriere.astro   # Careers
│   │   ├── hilfe.astro      # FAQ/Help
│   │   ├── premium-flotte.astro # Premium fleet
│   │   ├── vip-services.astro # VIP services
│   │   ├── ueber-uns.astro  # About
│   │   ├── action.astro     # Special offer
│   │   ├── blog/
│   │   │   ├── [slug].astro
│   │   │   ├── [...page].astro
│   │   │   └── tags/
│   │   │       └── [tag].astro
│   │   └── auth/
│   │       ├── login.astro
│   │       ├── register.astro
│   │       ├── verify-email.astro
│   │       ├── forgot-password.astro
│   │       └── reset-password.astro
│   ├── components/
│   │   ├── layouts/
│   │   │   ├── header/
│   │   │   │   ├── Header.astro
│   │   │   │   ├── TopHeader.astro
│   │   │   │   ├── SiteHeader.astro
│   │   │   │   ├── Logo.astro
│   │   │   │   └── UserAvatar.astro
│   │   │   └── footer/
│   │   │       ├── Footer.astro
│   │   │       ├── FooterInfo.astro
│   │   │       └── FooterLinkColumn.astro
│   │   ├── base/
│   │   │   ├── Button.astro
│   │   │   ├── Link.astro
│   │   │   ├── Modal.astro
│   │   │   └── Breadcrumbs.astro
│   │   ├── home/
│   │   │   ├── hero/
│   │   │   └── howIt/
│   │   ├── blog/
│   │   ├── reviews/
│   │   ├── premium/
│   │   ├── preise/
│   │   ├── services/
│   │   ├── partner/
│   │   ├── career/
│   │   └── contacts/
│   ├── lib/
│   │   ├── authService.ts
│   │   ├── emailService.ts
│   │   └── pocketbase.js
│   ├── types/
│   │   ├── globalInterfaces.ts
│   │   └── types.ts
│   ├── constants/
│   ├── layouts/
│   │   └── Layout.astro
│   └── env.d.ts
├── public/
│   ├── robots.txt
│   └── favicon.ico
├── astro.config.mjs
└── package.json

Страницы

URL	Файл	Описание
/	index.astro	Главная
/kontakt	kontakt.astro	Контакты
/preise	preise.astro	Цены
/bewertungen	bewertungen.astro	Отзывы
/partner	partner.astro	Партнёры
/karriere	karriere.astro	Вакансии
/hilfe	hilfe.astro	FAQ
/premium-flotte	premium-flotte.astro	Премиум флот
/vip-services	vip-services.astro	VIP услуги
/ueber-uns	ueber-uns.astro	О нас
/action	action.astro	Акция
/blog	blog/[...page].astro	Блог
/blog/[slug]	blog/[slug].astro	Статья
/auth/login	auth/login.astro	Вход
/auth/register	auth/register.astro	Регистрация
/impressum	impressum.astro	Impressum
/datenschutz	datenschutz.astro	Privacy
/agb	agb.astro	Terms
/stornierung	stornierung.astro	Cancellation
/zahlungsarten	zahlungsarten.astro	Payment methods

Компоненты

Layout

• Header.astro — основной header с навигацией
• TopHeader.astro — верхняя панель с контактами
• SiteHeader.astro — обёртка header
• Footer.astro — footer с ссылками
• FooterLinkColumn.astro — колонка ссылок
• FooterInfo.astro — информация о компании

Base

• Button.astro — кнопка с вариантами
• Link.astro — ссылка с prefetch
• Modal.astro — модальное окно
• Breadcrumbs.astro — хлебные крошки

Навигация

• Верхнее меню (Header): t_navbar — первые 5 пунктов (order 1-5)
• Нижнее меню (Footer): b_navbar — группировка по order: 1-3, 4-6, 7-10, 11-13

Типы

Все типы в frontend/src/types/globalInterfaces.ts:

• User
• Car
• Booking
• Review
• Post
• SiteSettings

API-эндпоинты

• /api/auth/login — вход
• /api/auth/register — регистрация
• /api/auth/logout — выход
• /api/auth/check-auth — проверка авторизации
• /api/auth/google/* — Google OAuth
• /api/contact — контактная форма
• /api/reviews — отзывы (GET/POST/DELETE)
• /api/send-booking — бронирование
• /api/files-proxy/* — прокси файлов

Переменные окружения

PB PocketBase URL=https://minivan-berlin.de
MAIL_* — почта
SMTP_* — SMTP
SENDER_* — отправитель
ADMIN_* — админ

Правила

1. SolidJS компоненты — .tsx расширение
2. Astro компоненты — .astro расширение
3. Запросы к PB — через authService
4. Типизация в types/globalInterfaces.ts
5. Не использовать any без крайней необходимости
6. Tailwind CSS v4
7. Картинки — в astro:assets

Особенности

• SSR mode с @astrojs/node
• Sitemap автоматически @astrojs/sitemap
• prefetching страниц
• Session via cookies
• Аутент<EFBFBD><EFBFBD>фикация через PocketBase