astro_avtourist/frontend/README.md

# 🚗 Автоюрист Сургут — Центр защиты прав водителей

> Профессиональная юридическая помощь для автомобилистов в Сургуте

![Автоюрист Сургут](/public/images/home/avtourist-surgut.avif)

**🌐 Сайт:** [avtourist-surgut.ru](https://avtourist-surgut.ru/)

---

## О проекте

**Автоюрист 086** — современный веб-сайт юридической компании, специализирующейся на защите прав водителей. Сайт предоставляет информацию об услугах, реальных кейсах, отзывах клиентов и полезных материалы в блоге.

### 📍 Контакты

- **Адрес:** г. Сургут, пр. Комсомольский, д. 19
- **Телефон:** [+7 (922) 253-83-75](tel:+79222538375)
- **Email:** [redibedi2019@gmail.com](mailto:redibedi2019@gmail.com)
- **Часы работы:** Пн-Пт: 9:00 - 18:00

---

## 🚀 Технологии

| Технология | Назначение |
|------------|------------|
| [Astro 6](https://astro.build/) | Фреймворк для серверного рендеринга |
| [Tailwind CSS 4](https://tailwindcss.com/) | Утилитарный CSS-фреймворк |
| [MDX](https://mdxjs.com/) | Контент с JSX-компонентами |
| [Node.js](https://nodejs.org/) | Серверный адаптер (standalone) |
| [TypeScript](https://www.typescriptlang.org/) | Типизация |

---

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

```
frontend/
├── public/
│   ├── images/          # Изображения по разделам
│   │   ├── blog/        # Для блога
│   │   ├── cases/       # Для кейсов
│   │   ├── contacts/    # Для контактов
│   │   ├── home/        # Для главной страницы
│   │   ├── posts/       # Для постов
│   │   ├── reviews/     # Для отзывов
│   │   └── services/    # Для услуг
│   └── favicons/        # Иконки сайта
├── src/
│   ├── components/      # Компоненты Astro
│   │   ├── auth/        # Аутентификация
│   │   ├── base/        # Базовые элементы
│   │   ├── blog/        # Компоненты блога
│   │   ├── cases/       # Компоненты кейсов
│   │   ├── home/        # Компоненты главной
│   │   ├── layout/      # Layout-компоненты
│   │   ├── reviews/     # Компоненты отзывов
│   │   └── services/    # Компоненты услуг
│   ├── content/         # Контент (блог, страницы)
│   ├── data/            # Данные (кейсы, отзывы)
│   ├── layouts/         # Основные layouts
│   ├── pages/           # Маршруты (SSR)
│   │   ├── auth/        # Страницы авторизации
│   │   ├── blog/        # Страницы блога
│   │   └── *.astro      # Основные страницы
│   ├── styles/          # Глобальные стили
│   ├── constants.ts     # Константы сайта
│   └── content.config.ts # Конфигурация контента
├── astro.config.mjs     # Конфигурация Astro
└── package.json         # Зависимости
```

---

## 📄 Страницы сайта

| Страница | URL | Описание |
|----------|-----|----------|
| Главная | `/` | Hero-секция, услуги, преимущества |
| Услуги | `/services` | Перечень юридических услуг |
| Кейсы | `/cases` | Реальные дела компании |
| Блог | `/blog` | Полезные статьи для водителей |
| Отзывы | `/reviews` | Отзывы клиентов |
| Контакты | `/contacts` | Адрес, карта, форма связи |
| FAQ | `/faq` | Часто задаваемые вопросы |
| Privacy | `/privacy` | Политика конфиденциальности |
| Terms | `/terms` | Пользовательское соглашение |

---

## 🛠️ Команды

Все команды выполняются через **Bun** из директории `frontend/`:

| Команда | Описание |
|---------|----------|
| `bun install` | Установить зависимости |
| `bun dev` | Запустить dev-сервер (`localhost:4321`) |
| `bun build` | Собрать production-версию в `./dist/` |
| `bun preview` | Превью production-сборки |
| `bun astro ...` | Astro CLI команды |

---

## ⚙️ Конфигурация

Проект работает в режиме **SSR** (Server-Side Rendering) с использованием адаптера **Node.js** в standalone-режиме.

```js
// astro.config.mjs
output: 'server',
adapter: node({ mode: 'standalone' }),
```

---

## 📋 Требования

- **Node.js:** `>=22.12.0`
- **Пакетный менеджер:** [Bun](https://bun.sh/)

---

## 🐳 Docker

Проект включает [Dockerfile](./Dockerfile) для контейнеризации и удобного развертывания.

---

## 👨‍💻 Разработка

1. Установите зависимости:
   ```bash
   bun install
   ```

2. Запустите dev-сервер:
   ```bash
   bun dev
   ```

3. Откройте [http://localhost:4321](http://localhost:4321)

---

## 📝 Лицензия

Все права защищены © Автоюрист Сургут