HomeLab

День 8 - Сдули пыль с проекта OFFROAD38 и добавили информацию в HomeLab

15 мая 2026, 07:51
День 8 - Сдули пыль с проекта OFFROAD38 и добавили информацию в HomeLab

Схема: добавили проект в HomeLab

projects/index.md  -> render_static_page.py  ->  /projects/index.html
       |
       +--> project page (.md) -> render -> /projects/<slug>.html

Сегодня вернулись к OFFROAD38 и нормально оформили его как проект в нашем контуре homelab.kobelkov.ru.

Цель была простая: не распылять знания по чатам и заметкам, а держать структурное описание проекта в одном месте и обновлять его так же аккуратно, как и весь сайт.

Что сделали

  1. Добавили OFFROAD38 в раздел "Проекты" на homelab.kobelkov.ru.
  2. Сделали отдельную страницу проекта с понятным описанием (вместо пары строк).
  3. Привели список проектов к формату "плиток": заходишь в проект и читаешь детали.

OFFROAD38 - кратко

OFFROAD38 - это платформа для offroad-маршрутов, выездов и сообщества (домен: https://offroad38.ru).

Изначально проект жил на WordPress, но для этой задачи он быстро стал тупиком:

  • треки превращались в обычные посты
  • структура держалась на костылях (ACF)
  • админка была перегружена
  • масштабирование почти отсутствовало

Поэтому сделали то, что обычно откладывают: переписали проект с нуля.

Что зафиксировали на странице проекта

На странице OFFROAD38 описали:

  • почему ушли с WordPress
  • что сделали (backend, frontend, миграция, прод)
  • архитектуру (Node.js + REST API + SPA)
  • модель данных (Track / Ride / Media)
  • минималистичную админку (без лишних ролей и настроек)
  • базовую инфраструктуру (VPS, systemd, nginx, ssh-only, fail2ban/firewall)
  • дальнейшие планы (карта, фильтры, Telegram-интеграция)

Это важно не для "красоты", а чтобы проект оставался управляемым: быстро вернуться в контекст, объяснить решение, продолжить разработку.

Где это лежит в HomeLab

  • список проектов: /projects/
  • страница OFFROAD38: /projects/offroad38.html

Почему так

Я сознательно не менял пайплайн публикации и не "пересобирал" сайт заново.
Все изменения внесены так же, как и остальной контент:

  • markdown в репозитории
  • генерация HTML существующими скриптами
  • публикация через publish.sh

Меньше магии - больше предсказуемости.