Инструкция по установке

Как начать пользоваться Nooka и как развернуть серверную часть программы.

Программа для ЭВМ «Nooka», версия 1.0 · редакция от 13 октября 2026 · {{short}}

Документация · Функциональные характеристики · Установка · Руководство пользователя · Руководство администратора · Архитектура · Жизненный цикл и поддержка

1. Для пользователя: установка не нужна

Nooka работает в браузере. Чтобы начать:

1. Откройте nookagame.ru на телефоне, планшете или компьютере.
2. Нажмите «Играть бесплатно» — первые уровни открываются сразу, без регистрации.
3. Чтобы сохранять прогресс на всех устройствах и открыть платную часть, нажмите «Личный кабинет» и войдите по почте (см. руководство пользователя).

Требования: актуальный браузер (Яндекс Браузер, Chrome, Safari, Firefox, Edge) и доступ в интернет. Дополнительные программы и плагины не нужны.

2. Проверочный доступ

Бесплатная часть доступна любому посетителю. Для проверки платной части правообладатель выдаёт доступ на адрес электронной почты проверяющего — напишите в поддержку. После этого достаточно войти на сайт с этой почтой.

3. Развёртывание серверной части

Этот раздел — для правообладателя и его разработчиков. Сервер разворачивается автоматически Ansible-плейбуками из репозитория серверной части.

3.1. Что нужно

• Виртуальный сервер x86-64 в Российской Федерации с Ubuntu 24.04 и доступом по SSH.
• Доменное имя, направленное на сервер.
• Компьютер администратора с Ansible и Node.js 22, доступ к репозиториям программы.
• Учётные записи внешних сервисов: платёжного сервиса PayKeeper, почтового сервиса для писем с кодом входа, Yandex AI Studio для чата.

3.2. Порядок

1. Склонировать репозитории сайта и серверной части в одну папку.
2. Указать адрес сервера в файле инвентаря плейбука, а секреты — адрес базы данных, ключ подписи сессий, доступ к почтовому сервису, секретное слово PayKeeper, ключ языковой модели — в зашифрованном хранилище Ansible Vault. Секреты в репозиторий в открытом виде не попадают.
3. Подготовить сервер: ansible-playbook site.yml. Плейбук ставит PostgreSQL 16, Node.js 22 и веб-сервер Caddy, создаёт системного пользователя, базу данных и службу, получает сертификат HTTPS.
4. Развернуть рабочую версию: ansible-playbook site.yml --tags prod. Плейбук забирает основную ветку обоих репозиториев, применяет миграции базы данных и перезапускает службу.
5. Проверить: адрес /health отвечает, что сервер работает; главная страница открывается.
6. В кабинете PayKeeper указать адрес уведомлений об оплате https://<домен>/pay/notify и способ «POST-оповещения».

3.3. Локальный запуск для разработки

В папке серверной части: npm install, затем npm run dev. Без адреса базы данных сервер поднимает встроенную базу PostgreSQL в локальной папке; без почтового сервиса письмо с кодом выводится в консоль. Сайт запускается любым статическим веб-сервером, например python3 -m http.server 8000, и открывается по адресу http://localhost:8000.

Правообладатель — {{seller}}, ИНН {{inn}}, ОГРНИП {{ogrnip}}.
Публичная оферта · Политика обработки персональных данных · На главную