- Go 77.5%
- Go Template 9%
- TypeScript 7.2%
- Makefile 3.9%
- CSS 1.5%
- Other 0.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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. |
||
| .forgejo/workflows | ||
| .github/workflows | ||
| cmd | ||
| models | ||
| modules | ||
| public | ||
| routers | ||
| services | ||
| templates | ||
| tests | ||
| web_src | ||
| .air.toml | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| .golangci.yml | ||
| .npmrc | ||
| AGENTS.md | ||
| bindata.go | ||
| docker-compose.yml | ||
| Dockerfile | ||
| eslint.config.ts | ||
| go.mod | ||
| go.sum | ||
| main.go | ||
| Makefile | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| stylelint.config.ts | ||
| tailwind.config.ts | ||
| tsconfig.json | ||
| vitest.config.ts | ||
| webpack.config.ts | ||
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:MMUTC);GET /claims/{id}— просмотр клейма;POST /claims/{id}/delete— отменить клейм.
JSON REST:
GET /api/v1/claims?room=&campus=&from=RFC3339&to=RFC3339POST /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).