karkas/ · меню · роли · 21 экранов · 21 ноября 2026

Каркас админки — один на все продукты

Админка управления сервисом, меню, роли, бот и Mini App, собранные из того, что уже работает в Swarm Brain, DECIMUS, Modius, Cozy Talk, LANX и семи наших ботах. Новый проект берёт каркас целиком и вычёркивает лишнее, а не придумывает заново.

Где мы остановились

Разговор о каркасе шёл 18 ноября и оборвался на лимите подписки. Решения из него записаны в decisions.md.

18.11 · сделано

Первый проход по рынку: книги для владельца, Refine, React Admin, shadcn-admin, Makerkit, better-auth. Предложены пять слоёв: каркас, лекала экранов, поверхности, вид, процесс.

18.11 · решено владельцем

Развивать forma. Стек выбираю я. Ничего не покупаем. Эталоны: вид веба — Cozy Talk, вид приложения — LANX, система — Swarm, полнота админки — DECIMUS, но «грузная и неочевидная».

21.11 · этот заход

Разобраны пять продуктов и семь ботов, второй проход по рынку. Канон меню, ролей, лекал и бота записан в karkas/. 21 прототип.

Что у нас уже есть

Каждый продукт решил управление по-своему. Что берём в каркас и что больше не повторяем.

ПродуктЧто есть в управленииБерёмБолит
DECIMUSСамая полная админка: люди, пространства партнёров, страны, ключи и API, Dodo IS, подключения, журнал, расход модели, письма. Матрица прав в коде, «смотреть как» с журналом, единый скелет вкладки.Полноту, матрицу «сторона × роль», запрет по умолчанию, чужое — 404, «смотреть как» только на чтение, шапку с одним «?».13 вкладок плоским столбцом без групп. Ключи — на трёх вкладках. Три вида панели. Личное (бот, MCP) и сервисное — в разных местах. Приглашения нет: пароль показывается один раз.
Swarm BrainРейка с тремя группами, сворачивание до иконок, счётчики. Админ: пространства → карточка с вкладками Обзор · Люди · Ключ · Расход. Настройки — плитки с панелью справа.Рейку и плотность, плитки настроек с панелью, баннер сбоя ключа, ведущий прямо на ключ, состояния подключений.Роли — один флаг is_admin. Нет журнала, хотя данные собираются. Ключ только OpenAI. Две раскладки с дублем логики. Нет выбора языка.
ModiusМеню одним массивом с ролями, better-auth organization, свои роли через createAccessControl, «смотреть как» понижением, приглашения по ссылке, ИИ-ключ и MCP-токены.Стек и меню одним массивом. Пустая группа скрывается. Приглашение со сроком и отзывом.Ключи ИИ, MCP и доступ к задачам свалены на одну страницу «Компания». Нет журнала и подписки.
Cozy Talk · LANXДва лучших вида: тёплая бумага, шалфей и терракота (веб); нуар-бумага, чернила и один сигнальный красный, нижняя панель с центральной «Добавить» (приложение).Cozy — вид веб-админки. LANX — вид Mini App, подача «стенд + телефоны».У Cozy нет тёмной темы; LANX живёт только в своём репозитории.
Боты (7 шт.)construction, dodo_kb, cithara, linguine, multa, promus, black-mantra. Веб-админки — у linguine, promus, black-mantra.Повторяется везде: /start по состоянию, язык, справка, первый админ из конфига, белый список, вход в Mini App по initData.Нет ни у кого: рассылок с черновиком, правки текстов бота без деплоя, единого экрана «Администраторы», онбординга.

Рынок и готовые фреймворки

Готового открытого стартера на нашем стеке с ключами нейросетей, MCP и журналом нет. Собираем сами, куски берём образцами.

ЧтоЖивостьКак используем
better-auth — organization, admin, api-key, MCPMIT · 30,8k ★ · пуш сегодняОснова людей, ролей, приглашений и токенов на сервере. Уже стоит в Modius.
satnaing/shadcn-adminMIT · 16,9k ★ · сен 2026Образец оболочки на нашем стеке (Vite + TanStack Router): сайдбар с группами, палитра команд, страницы настроек.
kriasoft/react-starter-kitMIT · 23,7k ★ · ноя 2026Ближе всех по стеку: Hono + Better Auth + Drizzle + TanStack + shadcn, организации, оплата. Читать структуру apps/api, код не копировать вслепую (там tRPC).
boxyhq/saas-starter-kitApache-2.0 · 5k ★ · июл 2026Карта «взрослых» разделов: команды, роли, журнал, вебхуки, API-ключи. Только как перечень экранов.
Linear · Vercel · GitHub · Supabase · Notion · Claude.aiэталоныДва уровня — «моё» и «общее». Подписка видна только админу. Журнал внизу. Ключи как у Vercel: проверить → заменить, старый живёт до успеха. MCP как у Claude.ai: админ подключает, участник включает себе.
grammY + menu, conversations, i18nMIT · окт–ноя 2026Бот и админка в боте. Для Python-ботов — aiogram + aiogram_dialog.
TelegramUIпоследний коммит окт 2025Не берём. Mini App — на своих токенах (LANX) и tma.js.
Makerkit, SupastarterплатныеОтпали по решению «ничего не покупаем».

Роли

Четыре уровня повторяются во всех проектах. Одна матрица прав — для меню, кнопок, API, бота и MCP. Подробно — roli.md, правка галочками — экран «Роли и права» ниже.

Владелец платформы

Я. Все клиенты, тарифы, системные ключи, состояние. «Смотреть как» любого клиента.

Админ

Заказчик. Всё своё: люди, пространства, ключи, подписка, журнал.

Менеджер

Полуправа. Рабочие разделы целиком плюс участники своего пространства.

Участник

Рядовой пользователь. Рабочие разделы по своей части и своё «Я». По нужде — Гость, только чтение.

Экраны · 21

Админка — в виде Cozy, оболочка без единого хекса. Бот и Mini App — в виде LANX. Лекала — ekrany.md и bot.md.

Что дальше

Прототипы — это согласование устройства. Код каркаса пишется после твоего «да» на меню и роли.

  1. Пройти прототипы и отметить, что лишнее, что не так названо, чего не хватает.
  2. Шаблон репозитория на стеке каркаса: вход, роли, оболочка с этим меню, «Люди и доступ», «Нейросети», «MCP и API», «Журнал», i18n, демо — с первого дня.
  3. Вид LANX в forma — отдельной системой рядом с Cozy, чтобы Mini App надевали его так же, как веб надевает Cozy.
  4. DECIMUS и Swarm — не переписывать, а подвинуть к каркасу смыслом: сгруппировать вкладки DECIMUS, собрать ключи в одно место, дать Swarm журнал и матрицу прав.