Skip to content

feat: агентское представление конспектов и доступ к лекциям по ссылке - #9

Merged
fUS1ONd merged 10 commits into
devfrom
feat/agent-public-lecture-sharing
Nov 18, 2026
Merged

fUS1ONd merged 10 commits into
devfrom
feat/agent-public-lecture-sharing

Conversation

@fUS1ONd

@fUS1ONd fUS1ONd commented Nov 18, 2026

Copy link
Copy Markdown
Member

Summary

GET /read/{id}  (Vary: Accept, User-Agent)
├── WantsMarkdown(r) == true  ──► LoadMarkdown ──► text/markdown; charset=utf-8
└── WantsMarkdown(r) == false ──► Load         ──► text/html (Читальный зал + <link rel="alternate" type="text/markdown">)

GET /read/{id}.md             ──► LoadMarkdown ──► text/markdown; charset=utf-8
GET /read/{id}/slides/{n}     ──► LoadSlide    ──► image/png | image/jpeg | image/webp (прямой стриминг из S3)
GET /read/{id}/export         ──► AccessTaskID ──► 302 presigned ZIP (private=owner, unlisted/public=anyone)

GET /hub        (Vary: Accept, User-Agent) ──► HTML Витрина или Markdown-каталог (только public)
GET /hub.md                                ──► Markdown-каталог Публичных лекций
GET /llms.txt                              ──► Индекс платформы и каталог Публичных лекций для агентов
GET /robots.txt                            ──► Allow: / ; Disallow: /lectures, /upload, /settings, /auth
 lecture_visibility:
   - private   # Личная лекция (доступна только владельцу)
+  - unlisted  # Лекция по ссылке (доступна по /read/{id}, скрыта с Витрины, noindex + no-store)
   - public    # Публичная лекция (на Витрине, в /hub.md и /llms.txt, обновляет published_at)

Evidence

  • Before: у Лекции было только два состояния видимости (private / public), Слайды отдавались только временными presigned-ссылками S3 внутри HTML Читального зала, а маршруты /read/{id}.md, /read/{id}/slides/{n}, /hub.md, /llms.txt и /robots.txt отсутствовали.
  • After:
    • make gate (templ generate, tailwindcss, go generate ./..., go build ./..., go vet ./..., go test ./...) — PASS
    • go test -tags=integration ./internal/db/... (миграция 005_lecture_visibility_unlisted.sql, переходы private ↔ unlisted ↔ public, неизменность published_at для unlisted, фильтрация ListPublic) — PASS

Merge Danger

Door: two-way

Миграция 005_lecture_visibility_unlisted.sql идемпотентно добавляет значение 'unlisted' в enum lecture_visibility (ALTER TYPE lecture_visibility ADD VALUE IF NOT EXISTS 'unlisted'), не меняя существующие строки и дефолт 'private'.

Blast Radius: medium

Затрагивает маршрутизацию и заголовки кеширования/индексации в модулях reader, hub, lecture и web, а также 3-позиционный переключатель видимости на странице «Мои лекции» и шапку Читального зала.

Миграция 005 добавляет значение unlisted в lecture_visibility. SetVisibility в слое БД обрабатывает private/unlisted/public явным switch: unlisted и public требуют статуса ready, unlisted и private не трогают published_at, неизвестное значение — ошибка.

Домен лекций получил VisibilityUnlisted и ErrInvalidVisibility: HTTP-слой отдаёт 400 на неизвестную видимость, 409 для неготовой лекции и 404 для чужой. Читальный зал отдаёт unlisted-лекции и их экспорт по прямой ссылке, помечает не-публичные ответы X-Robots-Tag, Cache-Control и meta robots; владелец видит бейдж видимости. В библиотеке — трёхпозиционный переключатель Личная | По ссылке | Витрина с подтверждением публикации и кнопкой копирования ссылки для unlisted и public.
- internal/web: OriginFromCallbackURL, ResolveOrigin, WantsMarkdown и /robots.txt
- internal/hub: GET /llms.txt, GET /hub.md и контент-негоциация /hub с Vary
- cmd/server: базовый origin витрины из PLATFORM_CALLBACK_URL
@fUS1ONd
fUS1ONd merged commit 7657cf0 into dev Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant