~ / проекты / educado

Educado_

Семьям экспатов в Испании приходится выбирать школу, не зная ни системы, ни языка. Платформа даёт искать и сравнивать школы и детские сады (guarderías) по языковым программам, стоимости, методике, транспорту и отзывам родителей. Данные о школах собирает и обогащает собственный конвейер, а каталог рассчитан на защиту от ИИ-агрегаторов контента.

Next.js 15.3 React 19 Go Catalog API Laravel 12 Console Go Parser PostgreSQL 16 Elasticsearch 8.18 Redis 7 & Horizon
4 языка интерфейса
4 стадии обогащения
4 уровня фильтров
190+ тестов

// архитектура

Монорепозиторий из развязанных сервисов: публичный фронтенд на Next.js, каталог-API на Go только на чтение и с низкой задержкой, консоль на Laravel 12 для бэк-офиса и авторизации, парсер на Go для фонового обогащения данных. Все компоненты работают с одной базой PostgreSQL 16 и индексами Elasticsearch 8.

$ cat architecture.txt
Браузер
│
Caddy / Next.js Rewrite
┌────────────┴────────────┐
Go Catalog API Laravel 12 Console
├ stdlib net/http ├ Filament Admin v3
├ raw SQL (pgx/v5) ├ Fortify & OAuth
├ Elasticsearch 8 ├ Redis 7 & Horizon
└ In-Memory LRU Cache └ Domain Events (Queues)
└────────────┬────────────┘
PostgreSQL 16
▲
│
Go Parser Daemon
(GORM & gocron/v2)
Контракт монорепозитория

Сервисы делят схему базы и описания индексов Elasticsearch, не завися друг от друга по коду

Переадресация API

Next.js проксирует поиск /api/v3/* в Go, а авторизацию и заявки /api/v2/* — в Laravel

Событийная очередь

13 доменных событий Laravel и 14 слушателей отрабатывают асинхронно через Redis и Horizon

Многоуровневый кеш

LRU-кеш в памяти и предохранитель, откатывающий запрос в PostgreSQL

Маршрутизация SSR и ISR

Серверные компоненты Next.js 15.3 и инкрементальная регенерация ради LCP

Необрутализм в дизайне

Своя система токенов Tailwind CSS v4 с микроанимациями и тёмной темой

// конвейер обогащения данных

Многопоточный фоновый демон-парсер на Go обогащает данные о школах конвейером из четырёх стадий. Каждая стадия идемпотентна: повторный прогон безопасен.

$ ./parser --run-pipeline
Этап 1
Интеграция с Google Places
Поиск школы по названию и адресу → координаты, рейтинги, отзывы, фотографии
Этап 2
Сбор данных с сайтов
Обход официальных сайтов школ → расписание, языковые программы, меню для аллергиков, режим работы
Этап 3
Генератор семантического SEO
Алгоритмическая сборка структурированных мета-данных и разметки Schema.org в JSON-LD
Этап 4
Локализация на четыре языка
Перевод описаний и текстовых блоков на es, en, ru, uk со слоем кеширования
// internal/parser/pipeline.go
type Pipeline struct {
stages []Stage
db *gorm.DB
}
type Stage interface {
Name() string
Run(ctx context.Context, school *School) error
ShouldRun(school *School) bool
}

// жизненный цикл карточки школы

01. RAW
Только сырые данные

Название и адрес из первичного импорта. В каталог не попадает.

02. ENRICHED
Обогащена конвейером

Обогащена парсером на Go, но не проверена. Помечена noindex.

03. PUBLISHED
Проверена и в индексе

Проверены минимум 4 из 6 ключевых полей (цены, бейдж, фото, группа/кухня/двор, разметка, форма заявки).

04. FEATURED
Премиум-карточка

Проверена, с премиальными галереями, расширенным описанием и приоритетом в выдаче.

// ключевые возможности

01. Каталог школ

  • ▶ Быстрый поиск через каталог-API на Go с поэтапными запросами
  • ▶ Четыре уровня фильтров: базовые, расширенные, для экспатов, сортировка
  • ▶ Карточки школ с валидной разметкой JSON-LD
  • ▶ Сравнение школ бок о бок (/comparar/{a}-vs-{b})

02. Кабинет родителя и заявки

  • ▶ Профили детей с точным подбором класса по возрасту
  • ▶ Избранное, личные заметки и история поиска
  • ▶ Формы заявок уходят в школу напрямую
  • ▶ Отзывы родителей с фильтрами по темам

03. SEO-движок районных адресов

  • ▶ Заранее собранные статические страницы-хабы по районам
  • ▶ Вложенность до района: /madrid/escuelas-infantiles/chamberi/bilingues/
  • ▶ Hreflang на четыре локали (es, en, ru, uk) и x-default
  • ▶ Разметка ChildCare, FAQPage, BreadcrumbList

04. Собственные данные

  • ▶ Стоимость обучения и вступительные взносы проверены напрямую
  • ▶ Описание маршрута по координатам: метро, автобус, время пешком
  • ▶ Детали: сколько детей на воспитателя, свой двор, тип кухни
  • ▶ Метки для экспатов: билингвальные, с упором на английский, guarderías

// качество и devops

Покрытие тестами

$ npm run test:ci && composer test
✓ ESLint & Pint ...... успешно
✓ Vitest (Front) ..... 77 тестов, 0 ошибок
✓ PHPUnit (Back) ...... 113 тестов, 0 ошибок

Конвейер CI/CD

$ gh workflow view deploy
✓ Поиск изменений .... front / parser / console
✓ Линтеры и тесты .... Pint, ESLint, PHPUnit, Vitest
✓ Сборка ассетов ..... npm run build
✓ Деплой (rsync) ..... без простоя
✓ Уведомление ........ Telegram

Безопасность

  • ▶ CSRF, ограничение частоты запросов и middleware SecurityHeaders
  • ▶ Капча Cloudflare Turnstile
  • ▶ Google OAuth и подтверждение почты вторым фактором
  • ▶ Валидация через Form Request и параметризованные SQL-запросы

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

  • ▶ Плейбуки Ansible для настройки серверов
  • ▶ Обратный прокси Caddy с автоматическими сертификатами
  • ▶ Юниты systemd для сервисов на Go и воркеров Horizon
  • ▶ Makefile с командами обновления, бэкапа и деплоя

// стек

Бэкенд
Каталог-API на Go 1.24
Консоль на Laravel 12
PHP 8.4, stdlib net/http
pgx/v5 (сырой SQL)
Фронтенд
Next.js 15.3
React 19
TypeScript 5.8
Tailwind CSS v4
next-intl, Vitest
Поиск и база
Elasticsearch 8.18
PostgreSQL 16
Redis 7 + Horizon
LRU-кеш, GORM (парсер)
Интеграции
Google Places API
next-intl (4 языка)
Прокси Caddy (авто-TLS)
Капча Turnstile
$ project-stats --summary
290+ компонентов Next.js
24 обработчика API на Go
47/34 контроллеров/сервисов
108 миграций базы
13/14 событий/слушателей