День 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.
Цель была простая: не распылять знания по чатам и заметкам, а держать структурное описание проекта в одном месте и обновлять его так же аккуратно, как и весь сайт.
Что сделали
- Добавили OFFROAD38 в раздел "Проекты" на
homelab.kobelkov.ru. - Сделали отдельную страницу проекта с понятным описанием (вместо пары строк).
- Привели список проектов к формату "плиток": заходишь в проект и читаешь детали.
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
Меньше магии - больше предсказуемости.