МожливостіСутності
Документація
    Ring Platform

    Децентралізоване самобудівне майбутнє

    Увійти
    Сутності
    Можливості
    Магазин
    Документація
    Концепції
    RING ЕкономікаSonoratek LLCГлобальний впливAI зустрічає Web3
    Розпочати
    Швидкий стартКалькуляторДорожня карта
    Конфіденційність|Контакти
    v1.104.26|Sonoratek LLC

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)

    Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Ring Oracle
    Інтеграція платежів
    Публічні пули та DAO-банки
    Інтеграція WayForPay
    Web3 Гаманець
    WalletConductor
    Кредитні винагороди
    Партнерська та реферальна підтримка
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Система Стейкінга Токенів
    Лабораторія проєкту власника (Owner Project Lab)
    Сутності
    Можливості
    AI Matcher
    Повідомлення
    Завдання Ring
    WebRTC-дзвінки та STUNner TURN
    Ігри з друзями
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Сторінки публічного профілю
    Віджети профілю облікового запису
    Ring File Cabinet
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Ring Mailer і RingdomX Mail
    Протокол Tunnel
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Безпека та відповідність
    Консоль адміністратора
    Адмінська Wiki
    Керування через Telegram
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Базове налаштування
    Білий лейбл
    Користувацьке брендування
    Інтеграція Web3
    Реальні приклади
    Розширені функції
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вертикальні пресети (SSOT)
    Ringization playbook
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Конфігурація
    Публічні змінні середовища
    Секрети Order Lab
    Project ID WalletConnect (Reown Cloud)
    Підтримувані сервіси
    Вікі NODUS (знання проєкту)
    Плейбук конфігурації
    Web3
    Token launch jurisdictions
    Гаманець
    Поради з безпеки гаманця
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    RingFileBase (API об’єктного сховища)
    Ring CDN (edge RingFileBase)
    Розгортання
    Розгортання на власному сервері
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та Аналітика
    Оптимізація продуктивності
    Резервне копіювання і відновлення
    Архітектура
    Data Model
    Security
    Real Time
    Синхронізація discovery після мутацій
    Архітектура PaymentConductor
    Архітектура WalletConductor
    Архітектура News Kingdom
    Бекенд Сервіси
    Інтеграція Firebase
    Розробка
    Ring MCP Server
    OSS і enterprise

    Швидкий вхід (CTO · аудитори · агенти)

    Вітаємо — місія та аудиторії
    Швидкий довідник
    Початок роботи
    Архітектура та Auth.js
    Режими бекенду та БД (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безпека та відповідність
    ringdom.org — база LegioX
    Код — ліцензія MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Інструменти спільноти

    Статус: install.sh, ring CLI і допоміжні скрипти в ring/scripts/ постачаються публічно. Старіша документація посилалася на scripts/setup-dev.sh, npm run setup:env і scripts/run-migration.sh. Їх немає в публічному дереві. Для налаштування використовуйте ./install.sh, а для бази даних web/data/schema.sql. Використовуйте вкладки Засновник / Розробник на бічній панелі, щоб відфільтрувати цю сторінку.

    Після переїзду застосунку в web/ публічний репозиторій має три шари інструментів: кореневий лаунчер, власні npm-скрипти застосунку Next.js і спільні допоміжні скрипти на shell і Node у ring/scripts/. Таблиця зіставляє те, що радили запускати старіші посібники, з тим, що існує зараз.

    Раніше в документаціїВикористовуйте зараз
    ./scripts/setup-dev.sh./install.sh (режим dev типовий)
    npm run setup:env (scripts/setup-env.js)./install.sh записує .env.local, або npm run setup:portal копіює шаблон
    ./scripts/run-migration.shpsql -f web/data/schema.sql на новій базі даних
    Ring CLI доступний лише в enterprisenpm run cli:install, потім ring --help. Див. Ring CLI
    ring deploy prodring prod (лише Kubernetes)

    Що ваш розробник отримує безкоштовно

    Налаштування однією командою

    ./install.sh перевіряє машину, встановлює пакети і записує вашу конфігурацію та файл секретів.

    Безпечні оновлення

    ring upgrade показує зміни Ring з upstream до того, як щось торкнеться вашого клону.

    Конфігурація, безпечна для бренду

    ring-config.json зберігає ваш бренд. Інструменти ніколи не перезаписують його без запиту.

    Чому це важливо

    • Швидший перший запуск. Новий розробник може пройти шлях від git clone до робочого клону з одним майстром і одним файлом схеми.
    • Менше несподіванок. На цій сторінці перелічено старі команди, яких уже немає, тож ніхто не втратить день на пошуки неіснуючого скрипта.

    Рекомендований шлях

    Запустіть майстер, потім самостійно застосуйте схему.

    Ручний шлях

    1. 1

      Конфігурація та env

      Задайте DB_BACKEND_MODE, ключі DB_* і AUTH_SECRET у .env.local.

    2. 2

      База даних

      Створіть порожню базу даних і застосуйте data/schema.sql (сплощена v4.1.0). Не запускайте data/migrations/*.sql на порожній базі даних.

    3. 3

      Перевірка та запуск

    Режими install.sh

    КомандаЩо робить
    ./install.sh або ./install.sh devІнтерактивне налаштування з десяти кроків: перевірка системи, глобальні інструменти, конфігурація клону, ring-config.json, npm install, Firebase, OAuth, .env.local, необов'язкова БД, IDE
    ./install.sh --quickТе саме зі значеннями за замовчуванням

    Відомі прогалини

    Пов'язана документація

    Related documentation

    Self-hosted deployment

    Наступний крок: перенесіть налаштований тут клон на продакшн-сервер.

    Local Setup

    Той самий процес: щоденна локальна розробка після встановлення інструментів.

    OSS vs enterprise

    Див. також: чому деякі скрипти в репозиторії працюють лише всередині Ringdom.

    1. Документація
    2. /Розробка
    3. /Інструменти спільноти
    Оновлено 1 жовт. 2026 р.3 хв прослуховування

    Інструменти спільноти

    Статус: install.sh, ring CLI і допоміжні скрипти в ring/scripts/ постачаються публічно. Старіша документація посилалася на scripts/setup-dev.sh, npm run setup:env і scripts/run-migration.sh. Їх немає в публічному дереві. Для налаштування використовуйте ./install.sh, а для бази даних web/data/schema.sql. Використовуйте вкладки Засновник / Розробник на бічній панелі, щоб відфільтрувати цю сторінку.

    Після переїзду застосунку в web/ публічний репозиторій має три шари інструментів: кореневий лаунчер, власні npm-скрипти застосунку Next.js і спільні допоміжні скрипти на shell і Node у ring/scripts/. Таблиця зіставляє те, що радили запускати старіші посібники, з тим, що існує зараз.

    Раніше в документаціїВикористовуйте зараз
    ./scripts/setup-dev.sh./install.sh (режим dev типовий)
    npm run setup:env (scripts/setup-env.js)./install.sh записує .env.local, або npm run setup:portal копіює шаблон
    ./scripts/run-migration.shpsql -f web/data/schema.sql на новій базі даних
    Ring CLI доступний лише в enterprisenpm run cli:install, потім ring --help. Див. Ring CLI
    ring deploy prodring prod (лише Kubernetes)

    Що ваш розробник отримує безкоштовно

    Налаштування однією командою

    ./install.sh перевіряє машину, встановлює пакети і записує вашу конфігурацію та файл секретів.

    Безпечні оновлення

    ring upgrade показує зміни Ring з upstream до того, як щось торкнеться вашого клону.

    Конфігурація, безпечна для бренду

    ring-config.json зберігає ваш бренд. Інструменти ніколи не перезаписують його без запиту.

    Чому це важливо

    • Швидший перший запуск. Новий розробник може пройти шлях від git clone до робочого клону з одним майстром і одним файлом схеми.
    • Менше несподіванок. На цій сторінці перелічено старі команди, яких уже немає, тож ніхто не втратить день на пошуки неіснуючого скрипта.

    Рекомендований шлях

    Запустіть майстер, потім самостійно застосуйте схему.

    Ручний шлях

    1. 1

      Конфігурація та env

      Задайте DB_BACKEND_MODE, ключі DB_* і AUTH_SECRET у .env.local.

    2. 2

      База даних

      Створіть порожню базу даних і застосуйте data/schema.sql (сплощена v4.1.0). Не запускайте data/migrations/*.sql на порожній базі даних.

    3. 3

      Перевірка та запуск

    Режими install.sh

    КомандаЩо робить
    ./install.sh або ./install.sh devІнтерактивне налаштування з десяти кроків: перевірка системи, глобальні інструменти, конфігурація клону, ring-config.json, npm install, Firebase, OAuth, .env.local, необов'язкова БД, IDE
    ./install.sh --quickТе саме зі значеннями за замовчуванням

    Відомі прогалини

    Пов'язана документація

    Related documentation

    Self-hosted deployment

    Наступний крок: перенесіть налаштований тут клон на продакшн-сервер.

    Local Setup

    Той самий процес: щоденна локальна розробка після встановлення інструментів.

    OSS vs enterprise

    Див. також: чому деякі скрипти в репозиторії працюють лише всередині Ringdom.

    1. Документація
    2. /Розробка
    3. /Інструменти спільноти
    Оновлено 1 жовт. 2026 р.3 хв прослуховування

    Інструменти спільноти

    Статус: install.sh, ring CLI і допоміжні скрипти в ring/scripts/ постачаються публічно. Старіша документація посилалася на scripts/setup-dev.sh, npm run setup:env і scripts/run-migration.sh. Їх немає в публічному дереві. Для налаштування використовуйте ./install.sh, а для бази даних web/data/schema.sql. Використовуйте вкладки Засновник / Розробник на бічній панелі, щоб відфільтрувати цю сторінку.

    Після переїзду застосунку в web/ публічний репозиторій має три шари інструментів: кореневий лаунчер, власні npm-скрипти застосунку Next.js і спільні допоміжні скрипти на shell і Node у ring/scripts/. Таблиця зіставляє те, що радили запускати старіші посібники, з тим, що існує зараз.

    Раніше в документаціїВикористовуйте зараз
    ./scripts/setup-dev.sh./install.sh (режим dev типовий)
    npm run setup:env (scripts/setup-env.js)./install.sh записує .env.local, або npm run setup:portal копіює шаблон
    ./scripts/run-migration.shpsql -f web/data/schema.sql на новій базі даних
    Ring CLI доступний лише в enterprisenpm run cli:install, потім ring --help. Див. Ring CLI
    ring deploy prodring prod (лише Kubernetes)

    Що ваш розробник отримує безкоштовно

    Налаштування однією командою

    ./install.sh перевіряє машину, встановлює пакети і записує вашу конфігурацію та файл секретів.

    Безпечні оновлення

    ring upgrade показує зміни Ring з upstream до того, як щось торкнеться вашого клону.

    Конфігурація, безпечна для бренду

    ring-config.json зберігає ваш бренд. Інструменти ніколи не перезаписують його без запиту.

    Чому це важливо

    • Швидший перший запуск. Новий розробник може пройти шлях від git clone до робочого клону з одним майстром і одним файлом схеми.
    • Менше несподіванок. На цій сторінці перелічено старі команди, яких уже немає, тож ніхто не втратить день на пошуки неіснуючого скрипта.

    Рекомендований шлях

    Запустіть майстер, потім самостійно застосуйте схему.

    Ручний шлях

    1. 1

      Конфігурація та env

      Задайте DB_BACKEND_MODE, ключі DB_* і AUTH_SECRET у .env.local.

    2. 2

      База даних

      Створіть порожню базу даних і застосуйте data/schema.sql (сплощена v4.1.0). Не запускайте data/migrations/*.sql на порожній базі даних.

    3. 3

      Перевірка та запуск

    Режими install.sh

    КомандаЩо робить
    ./install.sh або ./install.sh devІнтерактивне налаштування з десяти кроків: перевірка системи, глобальні інструменти, конфігурація клону, ring-config.json, npm install, Firebase, OAuth, .env.local, необов'язкова БД, IDE
    ./install.sh --quickТе саме зі значеннями за замовчуванням

    Відомі прогалини

    Пов'язана документація

    Related documentation

    Self-hosted deployment

    Наступний крок: перенесіть налаштований тут клон на продакшн-сервер.

    Local Setup

    Той самий процес: щоденна локальна розробка після встановлення інструментів.

    OSS vs enterprise

    Див. також: чому деякі скрипти в репозиторії працюють лише всередині Ringdom.

    1. Документація
    2. /Розробка
    3. /Інструменти спільноти
    Оновлено 1 жовт. 2026 р.3 хв прослуховування
  1. Ваші зміни переживають оновлення. Злиття з upstream спершу показуються для перегляду і ніколи не комітяться за вас.
    2. ./install.sh prod
    Вибір між Vercel, Ubuntu через SSH або Kubernetes (використовує ваші власні k8s/*.yaml)
    ./install.sh sync-urls --domain HOSTВиправляє розбіжність NEXT_PUBLIC_API_URL і AUTH_URL. --port для локальної роботи
    ./install.sh setup-dbМає створювати БД і застосовувати schema.sql. Наразі не працює на публічних checkout (див. беклог)

    Кореневий ring/install.sh лише переходить у web/ і запускає web/install.sh.

    npm-скрипти, які працюють (ring/web/package.json)

    СкриптЩо запускає
    dev, build, startВласний сервер server.ts. build спершу виконує ensure:config і type-check
    type-check, lint, test, test:coveragetsc, next lint, jest
    ensure:config, setup:portalscripts/ensure-ring-config.sh, копіювання шаблону
    validate:fcm-env, validate:fcm-schemaПеревірки env для FCM і JSONB fcm_tokens
    db:flatten-schemaПеребудовує data/schema.sql з міграцій (потрібен локальний Postgres)
    smoke:pipelinesscripts/run-all-smokes.sh
    cli:install, cli:devRing CLI
    check:org-leak, compose:shadowПеревірки гігієни Layer 1 для контриб'юторів

    З кореня репозиторію npm run dev, build і start делегують виконання в web/ через scripts/run-web.sh.

    npm-скрипти, яких слід уникати

    Вони досі перелічені в web/package.json, але їхніх цільових файлів у репозиторії немає, тому вони завершуються помилкою: setup, setup:env, setup:new, config:firebase, seed:opportunities, seed:portal, optimize:firebase, migrate:services, fix:service-migration, fix:compilation-errors, test:firebase-optimization, portal:health, portal:analytics. db:apply-schema і db:setup знаходять свої цілі, але падають через невідповідність шляхів.

    ci:layer1, push:layer1, push:forgejo, push:github-oss, setup:org-dx і merge:org-dev потребують приватного оверлею та forge Ringdom. Вони не призначені для клонів спільноти.

  2. Ваші зміни переживають оновлення. Злиття з upstream спершу показуються для перегляду і ніколи не комітяться за вас.
    3. ./install.sh prod
    Вибір між Vercel, Ubuntu через SSH або Kubernetes (використовує ваші власні k8s/*.yaml)
    ./install.sh sync-urls --domain HOSTВиправляє розбіжність NEXT_PUBLIC_API_URL і AUTH_URL. --port для локальної роботи
    ./install.sh setup-dbМає створювати БД і застосовувати schema.sql. Наразі не працює на публічних checkout (див. беклог)

    Кореневий ring/install.sh лише переходить у web/ і запускає web/install.sh.

    npm-скрипти, які працюють (ring/web/package.json)

    СкриптЩо запускає
    dev, build, startВласний сервер server.ts. build спершу виконує ensure:config і type-check
    type-check, lint, test, test:coveragetsc, next lint, jest
    ensure:config, setup:portalscripts/ensure-ring-config.sh, копіювання шаблону
    validate:fcm-env, validate:fcm-schemaПеревірки env для FCM і JSONB fcm_tokens
    db:flatten-schemaПеребудовує data/schema.sql з міграцій (потрібен локальний Postgres)
    smoke:pipelinesscripts/run-all-smokes.sh
    cli:install, cli:devRing CLI
    check:org-leak, compose:shadowПеревірки гігієни Layer 1 для контриб'юторів

    З кореня репозиторію npm run dev, build і start делегують виконання в web/ через scripts/run-web.sh.

    npm-скрипти, яких слід уникати

    Вони досі перелічені в web/package.json, але їхніх цільових файлів у репозиторії немає, тому вони завершуються помилкою: setup, setup:env, setup:new, config:firebase, seed:opportunities, seed:portal, optimize:firebase, migrate:services, fix:service-migration, fix:compilation-errors, test:firebase-optimization, portal:health, portal:analytics. db:apply-schema і db:setup знаходять свої цілі, але падають через невідповідність шляхів.

    ci:layer1, push:layer1, push:forgejo, push:github-oss, setup:org-dx і merge:org-dev потребують приватного оверлею та forge Ringdom. Вони не призначені для клонів спільноти.

  3. Ваші зміни переживають оновлення. Злиття з upstream спершу показуються для перегляду і ніколи не комітяться за вас.
    4. ./install.sh prod
    Вибір між Vercel, Ubuntu через SSH або Kubernetes (використовує ваші власні k8s/*.yaml)
    ./install.sh sync-urls --domain HOSTВиправляє розбіжність NEXT_PUBLIC_API_URL і AUTH_URL. --port для локальної роботи
    ./install.sh setup-dbМає створювати БД і застосовувати schema.sql. Наразі не працює на публічних checkout (див. беклог)

    Кореневий ring/install.sh лише переходить у web/ і запускає web/install.sh.

    npm-скрипти, які працюють (ring/web/package.json)

    СкриптЩо запускає
    dev, build, startВласний сервер server.ts. build спершу виконує ensure:config і type-check
    type-check, lint, test, test:coveragetsc, next lint, jest
    ensure:config, setup:portalscripts/ensure-ring-config.sh, копіювання шаблону
    validate:fcm-env, validate:fcm-schemaПеревірки env для FCM і JSONB fcm_tokens
    db:flatten-schemaПеребудовує data/schema.sql з міграцій (потрібен локальний Postgres)
    smoke:pipelinesscripts/run-all-smokes.sh
    cli:install, cli:devRing CLI
    check:org-leak, compose:shadowПеревірки гігієни Layer 1 для контриб'юторів

    З кореня репозиторію npm run dev, build і start делегують виконання в web/ через scripts/run-web.sh.

    npm-скрипти, яких слід уникати

    Вони досі перелічені в web/package.json, але їхніх цільових файлів у репозиторії немає, тому вони завершуються помилкою: setup, setup:env, setup:new, config:firebase, seed:opportunities, seed:portal, optimize:firebase, migrate:services, fix:service-migration, fix:compilation-errors, test:firebase-optimization, portal:health, portal:analytics. db:apply-schema і db:setup знаходять свої цілі, але падають через невідповідність шляхів.

    ci:layer1, push:layer1, push:forgejo, push:github-oss, setup:org-dx і merge:org-dev потребують приватного оверлею та forge Ringdom. Вони не призначені для клонів спільноти.