Архітектура News Kingdom

News Kingdom є шаром просування поверх модуля новин Ring. Учасники з роллю member або вищою пишуть статті, які розміщуються в їхньому особистому просторі за адресою /{username}/{slug}. Після цього автор може попросити місце в головній стрічці /news. Ring оцінює статтю, пропонує автору сплатити ціну, яка залежить від оцінки, і надсилає статтю адміністраторам платформи в Telegram для остаточного рішення «так» чи «ні».

Кожен запит на просування проходить через одне поле статті, mainPageStatus:

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

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

Архітектура News Kingdom

News Kingdom є шаром просування поверх модуля новин Ring. Учасники з роллю member або вищою пишуть статті, які розміщуються в їхньому особистому просторі за адресою /{username}/{slug}. Після цього автор може попросити місце в головній стрічці /news. Ring оцінює статтю, пропонує автору сплатити ціну, яка залежить від оцінки, і надсилає статтю адміністраторам платформи в Telegram для остаточного рішення «так» чи «ні».

Кожен запит на просування проходить через одне поле статті, mainPageStatus:

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

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

Архітектура News Kingdom

News Kingdom є шаром просування поверх модуля новин Ring. Учасники з роллю member або вищою пишуть статті, які розміщуються в їхньому особистому просторі за адресою /{username}/{slug}. Після цього автор може попросити місце в головній стрічці /news. Ring оцінює статтю, пропонує автору сплатити ціну, яка залежить від оцінки, і надсилає статтю адміністраторам платформи в Telegram для остаточного рішення «так» чи «ні».

Кожен запит на просування проходить через одне поле статті, mainPageStatus:

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

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

Типові сценарії

1. Громадська газета. Міський клон дозволяє місцевим учасникам публікуватися у своїх блогах і бере невелику плату за матеріали на першій сторінці. Адміністратори схвалюють найкращі з них у Telegram.
2. Експертна мережа. Професійний клон тримає високу планку цінності: сильні статті отримують низьку ціну, а слабкі стають надто дорогими.
3. Модерований центр кампаній. Клон громадського руху покладається на правила жорсткого блокування, тож спам ніколи не потрапляє в чергу адміністратора.

Налаштування для оператора

Ви встановлюєте ціни в гривнях через змінні середовища сервера. Якщо їх не задано, діють такі значення за замовчуванням:

Маршрути

Правила оцінювання

scoreNewsForMainPage() викликає OpenRouter, коли задано OPENROUTER_API_KEY. Без ключа зберігаються евристичні значення за замовчуванням (ethics 0.7, spam 0.2, merit 0.5) і записується model: 'heuristic'.

• Ризик дубліката: 0.95, якщо інша стаття має такий самий slug або siteWideSlug. 0.9, якщо опублікована стаття (серед перших 200) має такий самий заголовок.
• Жорстке блокування: ethics < NEWS_ETHICS_MIN або spamRisk > NEWS_SPAM_MAX або duplicateRisk > NEWS_DUPLICATE_MAX. Результат: published_blog_only і жодного checkout.
• Ціна: clamp(base, max, base + (1 - merit) * scale). Цінність нижче NEWS_MERIT_SOFT_REJECT піднімає ціну щонайменше до 4999. Низька цінність не змінює статус.

Змінні середовища

Жодного з ключів NEWS_* немає в env.local.template. Код читає їх із такими значеннями за замовчуванням.

Дані

Усі чотири таблиці використовують документну модель JSONB (id, data jsonb, мітки часу) у data/schema.sql (сплощена v4.1.0): news, news_categories, news_likes, news_submission_audit. Кожен перехід дописує запис у data.mainPageStatusHistory і створює один рядок news_submission_audit. Файли data/migrations/002_news_content_schema.sql і 003_news_kingdom_upgrade.sql мають історичний характер. Нові інсталяції застосовують лише schema.sql.

Побічні ефекти схвалення

approveMainPagePublication() встановлює status: 'published' і visibility: 'site-wide'. Для матеріалів, написаних користувачами, далі в чергу ставиться enqueueRewardCreditAddEvent({ trigger: 'newsStoryApproved' }) і запускається generateArticleTranslations(). Отримувачі в Telegram: користувачі з роллю адміністратора платформи та заповненим communication.telegramId.

Локальний тестовий прогін

1. 1

   Застосуйте схему і створіть статтю учасника

   Застосуйте data/schema.sql і увійдіть як користувач із роллю member або вищою. Створіть статтю на /news/create. Вона отримує blogUsername і після публікації з'являється за адресою /{username}/{slug}.

2. 2

   Подайте статтю на просування

   Відповідь містить status, aiScore і або переадресацію, або платіжні поля для checkout.

3. 3

   Імітуйте оплату в dev

4. 4

   Схваліть

   Натисніть Approve на картці в Telegram або викличте POST /api/mcp/v1/news/<id>/approve із сервісним токеном. Перевірте, що mainPageStatus має значення published_main і що існує рядок news_submission_audit.

Типові сценарії

1. Громадська газета. Міський клон дозволяє місцевим учасникам публікуватися у своїх блогах і бере невелику плату за матеріали на першій сторінці. Адміністратори схвалюють найкращі з них у Telegram.
2. Експертна мережа. Професійний клон тримає високу планку цінності: сильні статті отримують низьку ціну, а слабкі стають надто дорогими.
3. Модерований центр кампаній. Клон громадського руху покладається на правила жорсткого блокування, тож спам ніколи не потрапляє в чергу адміністратора.

Налаштування для оператора

Ви встановлюєте ціни в гривнях через змінні середовища сервера. Якщо їх не задано, діють такі значення за замовчуванням:

Маршрути

Правила оцінювання

scoreNewsForMainPage() викликає OpenRouter, коли задано OPENROUTER_API_KEY. Без ключа зберігаються евристичні значення за замовчуванням (ethics 0.7, spam 0.2, merit 0.5) і записується model: 'heuristic'.

• Ризик дубліката: 0.95, якщо інша стаття має такий самий slug або siteWideSlug. 0.9, якщо опублікована стаття (серед перших 200) має такий самий заголовок.
• Жорстке блокування: ethics < NEWS_ETHICS_MIN або spamRisk > NEWS_SPAM_MAX або duplicateRisk > NEWS_DUPLICATE_MAX. Результат: published_blog_only і жодного checkout.
• Ціна: clamp(base, max, base + (1 - merit) * scale). Цінність нижче NEWS_MERIT_SOFT_REJECT піднімає ціну щонайменше до 4999. Низька цінність не змінює статус.

Змінні середовища

Жодного з ключів NEWS_* немає в env.local.template. Код читає їх із такими значеннями за замовчуванням.

Дані

Усі чотири таблиці використовують документну модель JSONB (id, data jsonb, мітки часу) у data/schema.sql (сплощена v4.1.0): news, news_categories, news_likes, news_submission_audit. Кожен перехід дописує запис у data.mainPageStatusHistory і створює один рядок news_submission_audit. Файли data/migrations/002_news_content_schema.sql і 003_news_kingdom_upgrade.sql мають історичний характер. Нові інсталяції застосовують лише schema.sql.

Побічні ефекти схвалення

approveMainPagePublication() встановлює status: 'published' і visibility: 'site-wide'. Для матеріалів, написаних користувачами, далі в чергу ставиться enqueueRewardCreditAddEvent({ trigger: 'newsStoryApproved' }) і запускається generateArticleTranslations(). Отримувачі в Telegram: користувачі з роллю адміністратора платформи та заповненим communication.telegramId.

Локальний тестовий прогін

1. 1

   Застосуйте схему і створіть статтю учасника

   Застосуйте data/schema.sql і увійдіть як користувач із роллю member або вищою. Створіть статтю на /news/create. Вона отримує blogUsername і після публікації з'являється за адресою /{username}/{slug}.

2. 2

   Подайте статтю на просування

   Відповідь містить status, aiScore і або переадресацію, або платіжні поля для checkout.

3. 3

   Імітуйте оплату в dev

4. 4

   Схваліть

   Натисніть Approve на картці в Telegram або викличте POST /api/mcp/v1/news/<id>/approve із сервісним токеном. Перевірте, що mainPageStatus має значення published_main і що існує рядок news_submission_audit.

Типові сценарії

1. Громадська газета. Міський клон дозволяє місцевим учасникам публікуватися у своїх блогах і бере невелику плату за матеріали на першій сторінці. Адміністратори схвалюють найкращі з них у Telegram.
2. Експертна мережа. Професійний клон тримає високу планку цінності: сильні статті отримують низьку ціну, а слабкі стають надто дорогими.
3. Модерований центр кампаній. Клон громадського руху покладається на правила жорсткого блокування, тож спам ніколи не потрапляє в чергу адміністратора.

Налаштування для оператора

Ви встановлюєте ціни в гривнях через змінні середовища сервера. Якщо їх не задано, діють такі значення за замовчуванням:

Маршрути

Правила оцінювання

scoreNewsForMainPage() викликає OpenRouter, коли задано OPENROUTER_API_KEY. Без ключа зберігаються евристичні значення за замовчуванням (ethics 0.7, spam 0.2, merit 0.5) і записується model: 'heuristic'.

• Ризик дубліката: 0.95, якщо інша стаття має такий самий slug або siteWideSlug. 0.9, якщо опублікована стаття (серед перших 200) має такий самий заголовок.
• Жорстке блокування: ethics < NEWS_ETHICS_MIN або spamRisk > NEWS_SPAM_MAX або duplicateRisk > NEWS_DUPLICATE_MAX. Результат: published_blog_only і жодного checkout.
• Ціна: clamp(base, max, base + (1 - merit) * scale). Цінність нижче NEWS_MERIT_SOFT_REJECT піднімає ціну щонайменше до 4999. Низька цінність не змінює статус.

Змінні середовища

Жодного з ключів NEWS_* немає в env.local.template. Код читає їх із такими значеннями за замовчуванням.

Дані

Усі чотири таблиці використовують документну модель JSONB (id, data jsonb, мітки часу) у data/schema.sql (сплощена v4.1.0): news, news_categories, news_likes, news_submission_audit. Кожен перехід дописує запис у data.mainPageStatusHistory і створює один рядок news_submission_audit. Файли data/migrations/002_news_content_schema.sql і 003_news_kingdom_upgrade.sql мають історичний характер. Нові інсталяції застосовують лише schema.sql.

Побічні ефекти схвалення

approveMainPagePublication() встановлює status: 'published' і visibility: 'site-wide'. Для матеріалів, написаних користувачами, далі в чергу ставиться enqueueRewardCreditAddEvent({ trigger: 'newsStoryApproved' }) і запускається generateArticleTranslations(). Отримувачі в Telegram: користувачі з роллю адміністратора платформи та заповненим communication.telegramId.

Локальний тестовий прогін

1. 1

   Застосуйте схему і створіть статтю учасника

   Застосуйте data/schema.sql і увійдіть як користувач із роллю member або вищою. Створіть статтю на /news/create. Вона отримує blogUsername і після публікації з'являється за адресою /{username}/{slug}.

2. 2

   Подайте статтю на просування

   Відповідь містить status, aiScore і або переадресацію, або платіжні поля для checkout.

3. 3

   Імітуйте оплату в dev

4. 4

   Схваліть

   Натисніть Approve на картці в Telegram або викличте POST /api/mcp/v1/news/<id>/approve із сервісним токеном. Перевірте, що mainPageStatus має значення published_main і що існує рядок news_submission_audit.