astro_avtourist/frontend/README.md
2026-04-10 01:28:31 +05:00

149 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚗 Автоюрист Сургут — Центр защиты прав водителей
> Профессиональная юридическая помощь для автомобилистов в Сургуте
![Автоюрист Сургут](/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)
---
## 📝 Лицензия
Все права защищены © Автоюрист Сургут