Клеймы на кабинеты: бронирование кинозала муз-клубом и киноклубом
  • Go 77.5%
  • Go Template 9%
  • TypeScript 7.2%
  • Makefile 3.9%
  • CSS 1.5%
  • Other 0.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
pxc1984 865e787b40
All checks were successful
Test, publish and deploy / frontend (push) Successful in 30s
Test, publish and deploy / backend (push) Successful in 44s
Test, publish and deploy / deploy (push) Successful in 1m29s
schedule: fetch a person's calendar by email via Yandex web API
Port the musicclub mechanism (YandexWebScheduleProvider + YandexMayaClient
+ YandexWebSession): Maya get-events-by-login with opaqueOnly=false, cookies
from env/file, ckey scraped from the calendar page, one retry after auth
errors. Wire it as services/schedule.Default in cmd/web, expose an htmx
fragment GET /schedule?email=&week= (busy events of the week, MSK times)
under the week grid on the calendar page.
2026-11-19 23:09:05 +00:00
.forgejo/workflows ci: return homelab-docker label (cu3rd-xgrm runner is off) 2026-11-19 22:51:28 +00:00
.github/workflows schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
cmd schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
models schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
modules schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
public schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
routers schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
services schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
templates schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
tests schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
web_src schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.air.toml schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.dockerignore schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.editorconfig schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.env.example schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
.gitignore schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.golangci.yml schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
.npmrc schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
AGENTS.md schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
bindata.go schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
docker-compose.yml schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
Dockerfile schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
eslint.config.ts schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
go.mod schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
go.sum schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
main.go schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
Makefile schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
package-lock.json schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
package.json schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
README.md schedule: fetch a person's calendar by email via Yandex web API 2026-11-19 23:09:05 +00:00
stylelint.config.ts schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
tailwind.config.ts schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
tsconfig.json schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
vitest.config.ts schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00
webpack.config.ts schedule: клеймы на кабинеты (Go + htmx, Postgres) 2026-11-19 22:34:35 +00:00

schedule

Клеймы на кабинеты: муз-клуб и киноклуб бронируют кинозал (кабинеты) на 10-м этаже. Один и тот же кабинет в одном кампусе не может быть занят дважды в пересекающийся интервал — конфликт записи проверяется в транзакции под per-room advisory lock.

Стек: Go + chi + htmx + Tailwind (палитра «black steel» из paste/db-access), хранение в Postgres, миграции в models/migrations/. Архитектура — template-go-htmx.

Запуск

cp .env.example .env          # PORT, DATABASE_URL
docker compose up             # или локально с postgres
./schedule web                # применяет миграции и слушает PORT

Локальная разработка: make watch (webpack + air), для быстрой проверки без postgres — DATABASE_URL=sqlite:data/schedule.db ./schedule web.

API

HTML/htmx:

  • GET /?week=YYYY-MM-DD&room=&campus= — календарь недели (неделя задаётся датой её понедельника), фильтры по кабинету и кампусу;
  • POST /claims — создать клейм (форма: room, campus, starts_at, ends_at в YYYY-MM-DDTHH:MM UTC);
  • GET /claims/{id} — просмотр клейма;
  • POST /claims/{id}/delete — отменить клейм.

JSON REST:

  • GET /api/v1/claims?room=&campus=&from=RFC3339&to=RFC3339
  • POST /api/v1/claims — {"room","campus","starts_at","ends_at"} (RFC3339);
  • GET /api/v1/claims/{id};
  • DELETE /api/v1/claims/{id}.

Ошибки: 422 — валидация, 409 — пересечение с существующим клеймом, 404 — нет клейма.

Конфигурация

Переменная По умолчанию Назначение
PORT :8080 адрес HTTP-сервера
DATABASE_URL postgres DSN строка подключения; префикс sqlite: — локальный файл (тесты)
SCHEDULE_STATIC_ROOT . корень templates/ и public/ без bindata
SCHEDULE_YANDEX_COOKIE — Cookie-заголовок для веб-API Яндекс.Календаря (секрет)
SCHEDULE_YANDEX_COOKIE_FILE — файл с Cookie-заголовком (если переменная выше пуста)
SCHEDULE_YANDEX_BASE_URL https://calendar.yandex.ru происхождение веб-API Яндекс.Календаря (для тестов)

Healthcheck: GET /healthz (пингует БД, 503 если недоступна).

Сборка и проверки

make build            # фронт (webpack) + бэкенд
go build ./... && go vet ./...
go run mvdan.cc/gofumpt@v0.9.2 -l .   # должно быть пусто
make test             # unit + integration на sqlite
make test-pgsql TEST_PGSQL_DSN='postgres://...'

Образ собирается Dockerfile-ом (multi-stage, bindata) и работает под UID 10001 (non-root).

Расписание студента

Порт «фетч расписания студента по его почте» — services/schedule/: интерфейс Provider.StudentSchedule(ctx, email, from, to). Реализация — веб-API Яндекс.Календаря («Maya», POST /api/models?_models=get-events-by-login, opaqueOnly=false) от имени владельца cookies — тот же механизм, что в musicclub (YandexWebScheduleProvider + YandexMayaClient + YandexWebSession).

Cookies (формат заголовка a=1; b=2, обязательно с yandexuid) берутся из SCHEDULE_YANDEX_COOKIE или файла SCHEDULE_YANDEX_COOKIE_FILE; ckey выцепляется со страницы календаря. Яндекс сам ротирует сессию, а Playwright-перелогина здесь нет (не тащим зависимости в Go-сервис) — когда cookies протухают, обновляйте секрет/файл внешним путём, провайдер перечитывает его и повторяет запрос один раз.

В UI: на странице календаря блок «Личное расписание» (GET /schedule?email=&week=, htmx-фрагмент #schedule) — занятость человека за выбранную неделю (только busy-события, отказы и «свободное время» не показываются; времена в МСК). Без настроенных cookies блок честно пишет, что интеграция не настроена.

Время

Все времена хранятся и отображаются в UTC (unix seconds).