Описание архитектуры
Из чего состоит Nooka: клиентская часть, сервер, база данных и внешние сервисы.
1. Общая схема
Браузер пользователя — по HTTPS обращается к серверу nookagame.ru.
Caddy — веб-сервер с сертификатом HTTPS. Отдаёт:
- статические файлы сайта — HTML, CSS, JavaScript;
- запросы к данным — серверу Nooka на Node.js 22.
Сервер Nooka работает с:
- PostgreSQL 16 — аккаунты, прогресс, доступ, заказы;
- PayKeeper — платёжная форма и уведомления об оплате;
- почтовым сервисом — письма с кодом входа;
- YandexGPT (Yandex AI Studio) — ответы в чате «Спроси Нейро».
Сервер, база данных и все внешние сервисы находятся в Российской Федерации. Веб-аналитика — Яндекс Метрика.
2. Клиентская часть (сайт)
- HTML, CSS и JavaScript без сборки и без фреймворков; игры с интерактивными сценами на SVG и Canvas, часть игр — на библиотеке React.
- Общие модули: учёт прогресса, интерфейс уровней, реестр уровней и курсов, доступ, аккаунт.
- Без входа прогресс хранится в браузере; после входа — отправляется на сервер и объединяется с прогрессом с других устройств.
- Сайт не принимает решений об оплате: открыт ли доступ, он спрашивает у сервера.
3. Сервер
- Node.js 22, без фреймворка; две зависимости — драйвер PostgreSQL и библиотека отправки почты.
- Функции: вход по почте и сессии; синхронизация прогресса и коллекции; доступ, заказы и приём уведомлений PayKeeper; чат с ИИ-наставником и его лимиты; служебные функции администратора.
- Миграции базы данных применяются автоматически при запуске.
- Автоматические тесты — встроенным средством Node.js.
4. База данных
| Таблица | Что хранит |
|---|---|
| users | Аккаунты: адрес почты, дата создания |
| login_codes | Коды входа — только в виде хешей, со сроком действия и счётчиком попыток |
| sessions | Сессии — только хеши токенов, срок действия |
| progress | Прогресс ребёнка по ключам: опыт, пройденные уровни, звания |
| gallery_items | Работы из коллекции |
| orders | Заказы: тариф, сумма, статус, номер платежа PayKeeper |
| access_grants | Выдачи доступа: вид, срок, основание, кто выдал |
| issued_codes | Список ранее выданных кодов доступа |
| chat_turns | Учёт сообщений чата: кто, когда, сколько токенов, вид ответа — без текстов |
5. Безопасность
- Передача данных только по HTTPS. Cookie сессии недоступна скриптам страницы.
- Коды и токены хранятся только хешами. Ограничены частота запросов кода и число попыток ввода.
- Изменяющие запросы принимаются только в формате JSON и только с разрешённых адресов.
- Уведомление об оплате проверяется по подписи; сумма сверяется с заказом.
- Языковой модели передаются только реплики и возраст, без почты и номера аккаунта.
- Секреты хранятся только в окружении сервера и в зашифрованном хранилище, не в репозитории.
6. Внешние сервисы
| Сервис | Для чего |
|---|---|
| PayKeeper | Приём оплаты и кассовые чеки |
| Unisender Go или SMTP Яндекс Почты | Отправка писем с кодом входа |
| YandexGPT (Yandex AI Studio) | Ответы ИИ-наставника в чате |
| Яндекс Метрика | Обезличенная статистика посещений |
7. Сторонние компоненты
| Компонент | Лицензия |
|---|---|
| Node.js | MIT |
| PostgreSQL | PostgreSQL License |
| Caddy | Apache 2.0 |
| pg (драйвер PostgreSQL) | MIT |
| Nodemailer | MIT-0 |
| React | MIT |
| Шрифты Unbounded, Nunito, Fredoka One, Orbitron, Space Grotesk | SIL Open Font License 1.1 |
| Ansible (средство развёртывания, в состав программы не входит) | GPL 3.0 |
8. Исходный код и развёртывание
Исходный код хранится в системе контроля версий Git с полной историей изменений: отдельно клиентская часть и серверная часть вместе со средствами развёртывания. Сервер настраивается и обновляется Ansible-плейбуками; для проверки изменений поднимаются тестовые стенды с отдельной базой данных.
Правообладатель — {{seller}}, ИНН {{inn}}, ОГРНИП {{ogrnip}}.
Публичная оферта ·
Политика обработки персональных данных ·
На главную