Loading documentation...
Preparing Ring content
Концепції, цінність і типові сценарії
Концепції, цінність і типові сценарії
Preparing Ring content
Preparing Ring content
Preparing Ring content
Використовуйте вкладки Засновник / Розробник на бічній панелі документації, щоб відфільтрувати цю сторінку. Коротко: увесь застосунок має відкритий код. Приватними залишаються хостинг Ringdom, конвеєр CI і невеликий набір модулів лише для операторів.
Ring побудовано шарами. Layer 1 є кодовою базою спільноти, опублікованою на GitHub як connectplatform/ring за ліцензією Apache 2.0. Пакети Layer 2 (ring-presets/<pack>) додають вертикальні пресети. Оверлеї Layer 3 (ringdom-clones/<slug>) містять бренд, документацію та приватні модулі одного клону. Збірка спершу копіює Layer 1, а потім накладає зверху оверлеї. Якщо той самий файл є в кількох шарах, перемагає пізніший шар.
| Можливість | Публічний OSS (GitHub) | Поселенець Ringdom |
|---|---|---|
Повний застосунок Next.js (web/): магазин, гаманець, новини, повідомлення, адмінка та решта | Так | Так |
install.sh, допоміжні скрипти ring/scripts/, data/schema.sql | Так | Так |
ring CLI (cli/) | Так. upgrade, config і test працюють будь-де | Так, а також приватний шлях збирання |
| Файли Docker і шаблони env | Так | Так |
| Базова документація | Мінімальна (web/docs/en/index.mdx плюс дві сторінки функцій) | Повний корпус порталу в оверлеї |
Маніфести Kubernetes (k8s/) | Ні | Так |
CI-процеси Forgejo (.forgejo/) і конвеєр збирання forge | Ні. Вилучаються з дзеркала на GitHub | Так |
Order Lab, калькулятори, my-orders, my-jobs, замовлення в адмінському CRM | Ні. Лише заглушки спільноти | Так |
Вибір пресета в ring-config.json і каталоги Layer 1 (features/entities/presets/) | Так | Так |
Пакети пресетів Layer 2 (ring-presets/<pack>) | Ні. Розміщені на forge | Так |
Клонуйте публічний репозиторій, запустіть майстер, розмістіть де завгодно. Код, дані та учасники належать вам.
Пресети дають клону готову форму для певної галузі. У Layer 1 є селектор. Багатші пакети постачаються через Ringdom.
Посібник із рингізації описує шлях поселенця: тонкий оверлей над Layer 1, який збирає і хостить Ringdom.
Рядків, позначених Ні в таблиці. Order Lab, замовлення проєктів і калькулятори компілюються із заглушками спільноти, тож збірка все одно працює. Окремі клони поселенців також можуть мати власні приватні модулі у своєму оверлеї.
Так, для upgrade, config і test. prod потребує ваших власних маніфестів Kubernetes і реєстру. Див. Ring CLI.
Повний корпус документації ring-platform.org зберігається в приватному оверлеї Layer 3 і публічно доступний за адресою /docs. Layer 1 зберігає невелику базову документацію спільноти в web/docs/.
Наступний крок: публічні інструменти налаштування й обслуговування в деталях.
Той самий процес: запуск збірки OSS на власному сервері.
Див. також: шлях поселенця від тонкого оверлею до клону на хостингу.
Поглиблення: які команди CLI працюють поза Ringdom.
Використовуйте вкладки Засновник / Розробник на бічній панелі документації, щоб відфільтрувати цю сторінку. Коротко: увесь застосунок має відкритий код. Приватними залишаються хостинг Ringdom, конвеєр CI і невеликий набір модулів лише для операторів.
Ring побудовано шарами. Layer 1 є кодовою базою спільноти, опублікованою на GitHub як connectplatform/ring за ліцензією Apache 2.0. Пакети Layer 2 (ring-presets/<pack>) додають вертикальні пресети. Оверлеї Layer 3 (ringdom-clones/<slug>) містять бренд, документацію та приватні модулі одного клону. Збірка спершу копіює Layer 1, а потім накладає зверху оверлеї. Якщо той самий файл є в кількох шарах, перемагає пізніший шар.
| Можливість | Публічний OSS (GitHub) | Поселенець Ringdom |
|---|---|---|
Повний застосунок Next.js (web/): магазин, гаманець, новини, повідомлення, адмінка та решта | Так | Так |
install.sh, допоміжні скрипти ring/scripts/, data/schema.sql | Так | Так |
ring CLI (cli/) | Так. upgrade, config і test працюють будь-де | Так, а також приватний шлях збирання |
| Файли Docker і шаблони env | Так | Так |
| Базова документація | Мінімальна (web/docs/en/index.mdx плюс дві сторінки функцій) | Повний корпус порталу в оверлеї |
Маніфести Kubernetes (k8s/) | Ні | Так |
CI-процеси Forgejo (.forgejo/) і конвеєр збирання forge | Ні. Вилучаються з дзеркала на GitHub | Так |
Order Lab, калькулятори, my-orders, my-jobs, замовлення в адмінському CRM | Ні. Лише заглушки спільноти | Так |
Вибір пресета в ring-config.json і каталоги Layer 1 (features/entities/presets/) | Так | Так |
Пакети пресетів Layer 2 (ring-presets/<pack>) | Ні. Розміщені на forge | Так |
Клонуйте публічний репозиторій, запустіть майстер, розмістіть де завгодно. Код, дані та учасники належать вам.
Пресети дають клону готову форму для певної галузі. У Layer 1 є селектор. Багатші пакети постачаються через Ringdom.
Посібник із рингізації описує шлях поселенця: тонкий оверлей над Layer 1, який збирає і хостить Ringdom.
Рядків, позначених Ні в таблиці. Order Lab, замовлення проєктів і калькулятори компілюються із заглушками спільноти, тож збірка все одно працює. Окремі клони поселенців також можуть мати власні приватні модулі у своєму оверлеї.
Так, для upgrade, config і test. prod потребує ваших власних маніфестів Kubernetes і реєстру. Див. Ring CLI.
Повний корпус документації ring-platform.org зберігається в приватному оверлеї Layer 3 і публічно доступний за адресою /docs. Layer 1 зберігає невелику базову документацію спільноти в web/docs/.
Наступний крок: публічні інструменти налаштування й обслуговування в деталях.
Той самий процес: запуск збірки OSS на власному сервері.
Див. також: шлях поселенця від тонкого оверлею до клону на хостингу.
Поглиблення: які команди CLI працюють поза Ringdom.
Використовуйте вкладки Засновник / Розробник на бічній панелі документації, щоб відфільтрувати цю сторінку. Коротко: увесь застосунок має відкритий код. Приватними залишаються хостинг Ringdom, конвеєр CI і невеликий набір модулів лише для операторів.
Ring побудовано шарами. Layer 1 є кодовою базою спільноти, опублікованою на GitHub як connectplatform/ring за ліцензією Apache 2.0. Пакети Layer 2 (ring-presets/<pack>) додають вертикальні пресети. Оверлеї Layer 3 (ringdom-clones/<slug>) містять бренд, документацію та приватні модулі одного клону. Збірка спершу копіює Layer 1, а потім накладає зверху оверлеї. Якщо той самий файл є в кількох шарах, перемагає пізніший шар.
| Можливість | Публічний OSS (GitHub) | Поселенець Ringdom |
|---|---|---|
Повний застосунок Next.js (web/): магазин, гаманець, новини, повідомлення, адмінка та решта | Так | Так |
install.sh, допоміжні скрипти ring/scripts/, data/schema.sql | Так | Так |
ring CLI (cli/) | Так. upgrade, config і test працюють будь-де | Так, а також приватний шлях збирання |
| Файли Docker і шаблони env | Так | Так |
| Базова документація | Мінімальна (web/docs/en/index.mdx плюс дві сторінки функцій) | Повний корпус порталу в оверлеї |
Маніфести Kubernetes (k8s/) | Ні | Так |
CI-процеси Forgejo (.forgejo/) і конвеєр збирання forge | Ні. Вилучаються з дзеркала на GitHub | Так |
Order Lab, калькулятори, my-orders, my-jobs, замовлення в адмінському CRM | Ні. Лише заглушки спільноти | Так |
Вибір пресета в ring-config.json і каталоги Layer 1 (features/entities/presets/) | Так | Так |
Пакети пресетів Layer 2 (ring-presets/<pack>) | Ні. Розміщені на forge | Так |
Клонуйте публічний репозиторій, запустіть майстер, розмістіть де завгодно. Код, дані та учасники належать вам.
Пресети дають клону готову форму для певної галузі. У Layer 1 є селектор. Багатші пакети постачаються через Ringdom.
Посібник із рингізації описує шлях поселенця: тонкий оверлей над Layer 1, який збирає і хостить Ringdom.
Рядків, позначених Ні в таблиці. Order Lab, замовлення проєктів і калькулятори компілюються із заглушками спільноти, тож збірка все одно працює. Окремі клони поселенців також можуть мати власні приватні модулі у своєму оверлеї.
Так, для upgrade, config і test. prod потребує ваших власних маніфестів Kubernetes і реєстру. Див. Ring CLI.
Повний корпус документації ring-platform.org зберігається в приватному оверлеї Layer 3 і публічно доступний за адресою /docs. Layer 1 зберігає невелику базову документацію спільноти в web/docs/.
Наступний крок: публічні інструменти налаштування й обслуговування в деталях.
Той самий процес: запуск збірки OSS на власному сервері.
Див. також: шлях поселенця від тонкого оверлею до клону на хостингу.
Поглиблення: які команди CLI працюють поза Ringdom.
web/LICENSE.| Дзеркало на GitHub | scripts/push-github-oss.sh | Збирає один коміт із верхівки forge без .forgejo/ і пушить його в github/main |
| Контроль витоків | scripts/check-no-org-leak.sh (npm run check:org-leak) | Завершується помилкою, якщо k8s, cli (всередині web/), .forgejo, .env.local, Order Lab, калькулятор або маршрути my-orders / my-jobs є справжніми шляхами в ring/web, а не відсутні чи є симлінками. Також вимагає, щоб ring-config.json був закоміченим звичайним файлом |
| Заглушки спільноти | scripts/ensure-community-stubs.sh | Відновлює версії спільноти, як-от lib/payments/conductor/handlers/project-order.community.ts, коли посилань на оверлей немає |
| Правила ігнорування | web/.gitignore | Не пускає web/k8s/, web/cli/, web/scripts/, web/propagation/ і .forgejo/ у коміти Layer 1 |
| Звіт про затінення | npm run compose:shadow | Перелічує шляхи Layer 1, які замінює оверлей, щоб перевизначення було видно під час рев'ю |
Кореневі cli/ і scripts/ у репозиторії публічні. Ігноруються лише шляхи web/cli, web/k8s і web/scripts, бо на машинах Ringdom це локальні симлінки на приватний оверлей.
Працюйте лише з Layer 1
Вносьте зміни для спільноти в ring/web або ring/cli. Ніколи не комітьте файли чи симлінки оверлею.
Запустіть перевірки
Не допускайте витоку секретів
Шаблони env містять лише заповнювачі. Ніколи не кладіть справжні ключі в коментарі до коду, приклади MDX або ring-config.json.
web/LICENSE.| Дзеркало на GitHub | scripts/push-github-oss.sh | Збирає один коміт із верхівки forge без .forgejo/ і пушить його в github/main |
| Контроль витоків | scripts/check-no-org-leak.sh (npm run check:org-leak) | Завершується помилкою, якщо k8s, cli (всередині web/), .forgejo, .env.local, Order Lab, калькулятор або маршрути my-orders / my-jobs є справжніми шляхами в ring/web, а не відсутні чи є симлінками. Також вимагає, щоб ring-config.json був закоміченим звичайним файлом |
| Заглушки спільноти | scripts/ensure-community-stubs.sh | Відновлює версії спільноти, як-от lib/payments/conductor/handlers/project-order.community.ts, коли посилань на оверлей немає |
| Правила ігнорування | web/.gitignore | Не пускає web/k8s/, web/cli/, web/scripts/, web/propagation/ і .forgejo/ у коміти Layer 1 |
| Звіт про затінення | npm run compose:shadow | Перелічує шляхи Layer 1, які замінює оверлей, щоб перевизначення було видно під час рев'ю |
Кореневі cli/ і scripts/ у репозиторії публічні. Ігноруються лише шляхи web/cli, web/k8s і web/scripts, бо на машинах Ringdom це локальні симлінки на приватний оверлей.
Працюйте лише з Layer 1
Вносьте зміни для спільноти в ring/web або ring/cli. Ніколи не комітьте файли чи симлінки оверлею.
Запустіть перевірки
Не допускайте витоку секретів
Шаблони env містять лише заповнювачі. Ніколи не кладіть справжні ключі в коментарі до коду, приклади MDX або ring-config.json.
web/LICENSE.| Дзеркало на GitHub | scripts/push-github-oss.sh | Збирає один коміт із верхівки forge без .forgejo/ і пушить його в github/main |
| Контроль витоків | scripts/check-no-org-leak.sh (npm run check:org-leak) | Завершується помилкою, якщо k8s, cli (всередині web/), .forgejo, .env.local, Order Lab, калькулятор або маршрути my-orders / my-jobs є справжніми шляхами в ring/web, а не відсутні чи є симлінками. Також вимагає, щоб ring-config.json був закоміченим звичайним файлом |
| Заглушки спільноти | scripts/ensure-community-stubs.sh | Відновлює версії спільноти, як-от lib/payments/conductor/handlers/project-order.community.ts, коли посилань на оверлей немає |
| Правила ігнорування | web/.gitignore | Не пускає web/k8s/, web/cli/, web/scripts/, web/propagation/ і .forgejo/ у коміти Layer 1 |
| Звіт про затінення | npm run compose:shadow | Перелічує шляхи Layer 1, які замінює оверлей, щоб перевизначення було видно під час рев'ю |
Кореневі cli/ і scripts/ у репозиторії публічні. Ігноруються лише шляхи web/cli, web/k8s і web/scripts, бо на машинах Ringdom це локальні симлінки на приватний оверлей.
Працюйте лише з Layer 1
Вносьте зміни для спільноти в ring/web або ring/cli. Ніколи не комітьте файли чи симлінки оверлею.
Запустіть перевірки
Не допускайте витоку секретів
Шаблони env містять лише заповнювачі. Ніколи не кладіть справжні ключі в коментарі до коду, приклади MDX або ring-config.json.