Платформа онлайн-школы

Sozdai

Платформа онлайн-обучения и корпоративного L&D: курсы, живые занятия, wiki, OKR, онбординг, геймификация и AI Course Studio.

Версия 0.1.0 · Next.js 16 · MongoDB 7 · pnpm

Возможности · Админка · Стек · Установка · Env · Структура · Скрипты · Деплой · Git · Безопасность · Документация

Возможности

Каталог поверхностей из кода (lib/navigation/dashboard.ts + app/dashboard/**).

Роли: admin, teacher, student, hr, manager, employee.

Админка

Полный список разделов (sidebar admin + detail routes).

Дополнительно admin видит AI Studio, шаблоны, Q&A inbox, отзывы, sync-блоки, задачи, wiki, таблицы (см. sidebar).

Tech stack

Инфраструктура для локальной разработки: MongoDB 7 (Docker). Redis в текущем коде не обязателен.

Prerequisites

• Node.js 20+
• pnpm 9+
• Docker (рекомендуется для MongoDB) или локальный mongod
• Git + SSH-доступ к приватному remote (выдаёт администратор)

Clone / доступ

git clone <SSH_URL_выдаёт_администратор>
cd sozdai.com

Публичный web-URL git-хостинга в документации не публикуется. SSH clone URL и права доступа выдаются out-of-band.

Локальная разработка

1. Установка зависимостей

pnpm install

2. Env

cp .env.example .env.local

Заполните как минимум:

• MONGODB_URI, MONGODB_DB
• AUTH_SECRET (≥ 32 символов)
• SEED_ADMIN_EMAIL, SEED_ADMIN_PASSWORD
• SEED_TEACHER_PASSWORD, SEED_STUDENT_PASSWORD, SEED_DEMO_PASSWORD

Source of truth по переменным: .env.example. Production-шаблон: .env.production.example.

3. MongoDB (локальный Docker)

docker run -d --name sozdai-mongo -p 27017:27017 mongo:7

Облачный Atlas / managed MongoDB как основной путь локальной разработки не рекомендуется. Используйте только если администратор явно выдал URI.

4. Seed

pnpm seed
pnpm seed:demo   # опционально: расширенные демо-данные

Админ создаётся только из SEED_* env. Пароли в коде не хранятся.

5. Dev-сервер

pnpm dev

По умолчанию Next.js слушает http://localhost:3000.

В non-production на /login доступен Dev Quick Login (пароли читаются на сервере из SEED_*, в клиентский бандл не попадают).

Переменные окружения

Полный список и комментарии — в .env.example. Секреты и токены интеграций выдаёт администратор out-of-band.

Структура проекта

app/                 # Next.js App Router (pages + API)
  api/               # REST handlers
  dashboard/         # Кабинет по ролям
  webinar/           # Публичные вебинары
  welcome/           # Welcome-портал кандидата
components/          # UI и dashboard-компоненты
lib/
  auth/              # session, password
  db/                # mongodb client, models
  navigation/        # sidebar / mobile nav
  schemas/           # zod
  services/          # бизнес-логика (wiki, pulse, push, …)
scripts/             # seed, seed-demo
docs/                # документация (см. docs/README.md)
public/              # статика, PWA, uploads (uploads в gitignore)

Скрипты

Production deploy

Текущий целевой контур в репозитории: Vercel (vercel.json — cron для meeting-reminders и webinar-funnel).

Критичные правила:

1. Все секреты — только в host env / secret store, не в git.
2. AUTH_SECRET и CRON_SECRET — уникальные production-значения.
3. Cron вызывает /api/cron/* с заголовком Authorization: Bearer <CRON_SECRET>.
4. Для media в проде настройте S3-compatible storage (см. .env.production.example).
5. Не используйте SEED_* пароли в публичных окружениях после первичного bootstrap.

Self-host альтернатива: pnpm build && pnpm start за reverse-proxy, MongoDB в Docker/отдельном хосте.

Дополнительные runbook-заметки: docs/ops/.

Git workflow

Ветки:

Поток:

feature/<short-name>  →  develop  →  master

Правила:

• Не коммитить напрямую в master / develop
• Conventional commits: feat|fix|docs|refactor|chore|test|style(scope): …
• Не коммитить .env, .env.local, бэкапы и реальные секреты
• Merge предпочтительно --no-ff

Пример:

git checkout develop
git pull
git checkout -b feature/my-change
# …работа…
git add <релевантные файлы>
git commit -m "feat(scope): краткое описание"
git push -u origin HEAD
# merge feature → develop → master (по процессу команды)

Подробнее: docs/git/.

Troubleshooting

Безопасность для внешних разработчиков

1. Секреты и SSH-доступ выдаются out-of-band, не через git и не через чаты с историей.
2. Не коммитьте .env*, дампы БД, ключи S3/SMTP/OAuth/AI.
3. Не логируйте пароли, JWT, токены.
4. Demo Quick Login и seed-пароли — только для локальной среды.
5. Если секреты когда-либо попадали в историю git — их нужно ротировать до выдачи доступа (см. security report владельца).
6. Production credentials не копируйте в личные машины без необходимости.

Документация

Индекс: docs/README.md

License / contacts

Приватный репозиторий. Доступ и лицензионные условия — у владельца проекта.

Вопросы по onboarding: администратор репозитория (контакт выдаётся вместе с SSH-доступом).