deexsed.ru - Сайт-портфолио

Современное веб-приложение для персонального сайта-портфолио с системой управления контентом (CMS).

⚠️ Важно: Настройка персональных данных

Перед использованием проекта необходимо настроить персональные данные!

Все персональные данные (имя, фамилия) настраиваются через переменные окружения в файле frontend/.env.

Обязательно создайте файл frontend/.env со следующим содержимым:

VITE_OWNER_NAME=Ваше Имя
VITE_OWNER_NAME_GENITIVE=Вашего Имени
VITE_SITE_NAME=Название сайта
VITE_DEFAULT_SEO_TITLE=Ваше Имя - Разработчик C++

Без настройки в проекте будут использоваться плейсхолдеры ("Ваше Имя" и т.д.), что не подходит для продакшена.

Подробные инструкции см. в разделе Быстрый старт.

Технологический стек

Frontend

• React 18+ с TypeScript
• Vite - инструмент сборки
• Tailwind CSS - стилизация
• React Router - маршрутизация
• Axios - HTTP-клиент
• React Markdown - рендеринг Markdown
• React Hook Form - управление формами

Backend

• FastAPI - веб-фреймворк для Python
• SQLite - база данных
• SQLAlchemy - ORM
• JWT - аутентификация
• Pillow - обработка изображений

Инфраструктура

• Docker & Docker Compose
• Nginx - reverse proxy и статические файлы

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

deexsed-website/
├── frontend/          # React приложение
├── backend/           # FastAPI приложение
├── nginx/            # Конфигурация Nginx
├── docker-compose.yml
└── README.md

Быстрый старт

Разработка

1. Клонируйте репозиторий:

   git clone <repository-url>
   cd resume-website

2. Настройте переменные окружения для frontend (ОБЯЗАТЕЛЬНО):

   Создайте файл frontend/.env и настройте персональные данные:

   cd frontend
   # Создайте файл .env со следующим содержимым:
   VITE_OWNER_NAME=Ваше Имя
   VITE_OWNER_NAME_GENITIVE=Вашего Имени  # Для родительного падежа
   VITE_SITE_NAME=Название сайта  # Опционально
   VITE_DEFAULT_SEO_TITLE=Ваше Имя - Разработчик C++  # Опционально

   ⚠️ ВАЖНО: Без настройки этих переменных в проекте будут использоваться плейсхолдеры. Это критично для продакшена!

3. Запустите backend:

   cd backend
   pip install -r requirements.txt
   uvicorn app.main:app --reload

4. Запустите frontend:

   cd frontend
   npm install
   npm run dev

Продакшен (Docker)

1. Настройте переменные окружения (ОБЯЗАТЕЛЬНО):

   Создайте файл frontend/.env с вашими персональными данными (см. раздел выше).

2. Соберите frontend:

   cd frontend
   npm install
   npm run build

3. Запустите через Docker Compose:

   docker-compose up -d

4. Приложение будет доступно по адресу:

   • Frontend: http://localhost
   • API: http://localhost/api
   • Swagger: http://localhost/docs

Первоначальная настройка

При первом запуске автоматически создается базовый администратор:

• Username: admin
• Password: admin
• Email: admin@deexsed.ru

Важно: При первом входе система обязательно требует смену всех учетных данных (username, password, email).

API Документация

После запуска приложения API документация доступна по адресу:

• Swagger UI: http://localhost/docs
• ReDoc: http://localhost/redoc

Развертывание на Dell Wyse 3040

См. подробные инструкции в файле ТЗ.md, раздел 8.

Лицензия

GPL-3.0

Контакты

• Email: listev.2002@ya.ru