Appearance
Глоссарий DRevent
Последняя сверка с кодом: 2026-06-06
Термины продукта и связь с кодом. При расхождении — код и PLAN.md главнее wiki.
Продукт и бренд
| Термин | Определение | В коде / UI |
|---|---|---|
| DRevent | Публичное имя продукта, домен drevent.app | DReventLogo, meta title |
| EventPass | Имя репозитория / npm workspaces | package.json, @eventpass/api |
| Событие (Event) | Один альбом = одно мероприятие. Имеет title, date, owner, settings | Event, /:id/* |
| Альбом | UI просмотра медиа события | pages/[id]/index.vue, MediaGrid |
| Wall | Полноэкранное слайдшоу для экрана/проектора | pages/[id]/wall.vue, SlideshowPlayer |
| Share | Страница QR и ссылок для гостей | pages/[id]/share.vue, QrShare |
Пользователи и роли
| Термин | Определение | В коде |
|---|---|---|
| Гость (GUEST) | Не залогинен. Доступ по URL события | optionalAuth, нет записи в EventRole |
| OWNER | Создатель/владелец события. Полные права на событие | EventRoleType.OWNER, Event.ownerId |
| MODERATOR | Назначен OWNER. Админка + модерация | EventRoleType.MODERATOR |
| MEMBER | Участник по инвайт-ссылке. Upload + удаление своих файлов | EventRoleType.MEMBER, /:id/join |
| SUPER_ADMIN | Администратор платформы | GlobalRole.SUPER_ADMIN, /admin/* |
| Аккаунт | Личная зона организатора после входа | /account, layout: account |
Доступ и настройки
| Термин | Определение | В коде |
|---|---|---|
| EventSettings | Настройки события 1:1: доступ, лимиты, брендинг, модерация | EventSettings, /:id/settings |
| qrAccess | Кто может открыть событие по QR/ссылке | AccessScope на поле qrAccess |
| albumVisibility | Кто видит медиа в альбоме | albumVisibility |
| zipAccess | Кто может скачать ZIP архив | zipAccess |
| AccessScope | ALL · MEMBERS_ONLY · OWNER_ONLY · INVITE_ONLY | constants/accessScope.ts |
| memberInviteToken | Секрет для ссылки приглашения MEMBER | /:id/join?token= |
| Moderation | PRE-moderation: новые файлы PENDING до approve | ModerationStatus, /:id/moderate |
Медиа и загрузка
| Термин | Определение | В коде |
|---|---|---|
| Media | Одно фото или видео в альбоме | Media, kind: photo | video |
| TUS | Протокол докачиваемой загрузки (чанки, resume) | /api/tus, useUploader, @tus/server |
| Превью / poster | Уменьшенное изображение для сетки; для видео — кадр | sharp / ffmpeg pipeline |
| BlurHash | Компактный placeholder пока грузится превью | blurhashUtil |
| Like | Лайк на медиа (авторизованный пользователь) | MediaLike, likeService |
| Guest name | Имя гостя без аккаунта (localStorage) | useGuestName, GuestNameModal |
Auth и аккаунт
| Термин | Определение | В коде |
|---|---|---|
| Better Auth | Библиотека auth: email/password, сессии в httpOnly cookie | /api/auth/*, config/auth.ts |
| AuthModal | Единая модалка: login, register, forgot, reset | AuthModal.vue, ?auth=login |
| Session | Серверная сессия браузера | Session, useAuth |
| revokeOtherSessions | Выйти на других устройствах, текущая сессия остаётся | useAuth.revokeOtherSessions |
Подробнее: 21-auth-frontend.md.
Тарифы и лимиты
| Термин | Определение | В коде |
|---|---|---|
| UserPlan | Тариф пользователя: FREE, BASE, PRO | User.plan, /api/plans |
| Plan limits | Лимиты на число событий, медиа и т.д. | planLimitsService, middleware |
| Billing | Оплата тарифов | Не реализовано (PLAN 23.5 отложено) |
Live и инфраструктура
| Термин | Определение | В коде |
|---|---|---|
| SSE | Server-Sent Events — push новых медиа в альбом/wall | useEventStream, utils/sse.ts |
| Storage | Хранилище файлов: LocalDisk (dev) / R2 (prod) | services/storage/ |
| OpenAPI / Swagger | Контракт REST API | /api/docs, @eventpass/api codegen |
UI и layouts
| Термин | Определение | Где |
|---|---|---|
| AppSiteHeader | Сквозной header: public и cabinet | components/layout/AppSiteHeader.vue |
| landing layout | Маркетинговые страницы | layouts/landing.vue |
| cabinet layout | Sidebar + header для аккаунта и админки события | layouts/account.vue |
| fullscreen layout | Без chrome — wall | layouts/fullscreen.vue |
| UiPageError | Inline ошибка (404, 403, offline) вместо отдельной страницы | UiPageError.vue |
ID и URL
| Термин | Определение | Пример |
|---|---|---|
| Event ID | Human-readable slug + суффикс | demo-event, svadba-anna-x7k2 |
| Media ID | Внутренний nanoid, не в marketing URL | в API и TUS metadata |
Сокращения в доках
| Аббрев. | Значение |
|---|---|
| QA | Quality Assurance, тестирование |
| MVP | Минимально жизнеспособный продукт |
| SSE | Server-Sent Events |
| TUS | Resumable upload protocol |