📋 СКН — Документация проекта

Дизайн-коды интерфейсов

Единые правила оформления, компонентов и состояний опубликованы в отдельном справочнике разработчика.

Админка · Публичный сайт · Пак иконок

📌 Добро пожаловать

Это техническая документация проекта СКН — новостного агрегатора с подкаст-режимом.

Документация содержит информацию об архитектуре, структуре БД, текущих задачах и принятых решениях.

📊 Быстрый обзор

Ключевые компоненты

• Источники данных: Telegram, ручной ввод
• AI-обогащение: прямые запросы PHP → OpenRouter
• Хранилище: MySQL (InnoDB, utf8mb4)
• Фронтенд: PHP/HTML/CSS/JS, тёмная/светлая тема
• Админка: Ролевая модель (admin/editor/moderator)
• Подкаст: Очередь выпусков, управление в админке
• Канбан-доска задач: управление задачами, Markdown-описания, drag&drop, редактирование

Статус проекта

• ✅ Базовая структура БД оптимизирована (удалены устаревшие поля, добавлены description и ai_log)
• ✅ Импорт из Telegram работает (медиа, превью, определение типа)
• ✅ API для обогащения адаптирован под id и новые поля
• ✅ Обогащение и AI-группировка работают напрямую через OpenRouter
• ✅ Подкаст-функционал в админке: очередь (сортировка, заметки, статус), выпуски (CRUD), привязка новостей к выпуску
• ✅ Секреты вынесены в .env
• ✅ AI-группировка новостей по темам
• ✅ Полное удаление news_index из кода (comments.php, sitemap.php, 404.tpl, импорт-скрипты)
• ✅ Замена image_url на выборку из news_media (news.php, podcast.php)
• ✅ Удаление текстового поля rubrics из запросов админки
• ✅ Канбан-доска с поддержкой Markdown-описаний, редактированием и закрытием по Escape
• ✅ Все выявленные проблемы перенесены в канбан-задачник
• ⬜ Публичная страница подкаста с плеером и списком выпусков
• ⬜ RSS-лента подкаста для интеграции с подкаст-плеерами
• ⬜ AI-рекомендация порядка новостей в выпуске
• ⬜ Шорткаты для ведущего (AI-генерация ключевых фраз)

📅 Последние изменения

🔗 Полезные ссылки

• Админ-панель
• Главная страница
• Режим подкаста (публичный)
• Очередь подкаста (админка)
• Выпуски подкаста (админка)
• Канбан-доска задач

📌 Ближайшие планы

• Публичная страница подкаста — вывод выпусков с плеером, списком новостей
• RSS-лента — для Apple Podcasts, Spotify, Yandex Music
• AI-рекомендация порядка — оптимальная последовательность новостей в выпуске
• Шорткаты для ведущего — AI-генерация ключевых фраз (2-3 предложения)
• CSRF-токены в админке — защита всех форм
• Периодическое обогащение важных новостей — cron-задача раз в 3 дня

📂 Структура документации

• 🏛️ Архитектура проекта — схемы, роли, потоки данных
• 🗄️ Структура базы данных — описание таблиц, индексов, связей
• ✅ Канбан-доска задач — управление задачими, drag&drop, редактирование
• 📝 Лог изменений — хронология всех доработок
• ⚡ Принятые решения — зафиксированные архитектурные выборы