karkas/ · меню · роли · 21 экранов · 21 ноября 2026
Каркас админки — один на все продукты
Админка управления сервисом, меню, роли, бот и Mini App, собранные из того, что уже работает в Swarm Brain, DECIMUS, Modius, Cozy Talk, LANX и семи наших ботах. Новый проект берёт каркас целиком и вычёркивает лишнее, а не придумывает заново.
Где мы остановились
Разговор о каркасе шёл 18 ноября и оборвался на лимите подписки. Решения из него записаны в decisions.md.
Первый проход по рынку: книги для владельца, Refine, React Admin, shadcn-admin, Makerkit, better-auth. Предложены пять слоёв: каркас, лекала экранов, поверхности, вид, процесс.
Развивать forma. Стек выбираю я. Ничего не покупаем. Эталоны: вид веба — Cozy Talk, вид приложения — LANX, система — Swarm, полнота админки — DECIMUS, но «грузная и неочевидная».
Разобраны пять продуктов и семь ботов, второй проход по рынку. Канон меню, ролей, лекал и бота записан в 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, MCP | MIT · 30,8k ★ · пуш сегодня | Основа людей, ролей, приглашений и токенов на сервере. Уже стоит в Modius. |
| satnaing/shadcn-admin | MIT · 16,9k ★ · сен 2026 | Образец оболочки на нашем стеке (Vite + TanStack Router): сайдбар с группами, палитра команд, страницы настроек. |
| kriasoft/react-starter-kit | MIT · 23,7k ★ · ноя 2026 | Ближе всех по стеку: Hono + Better Auth + Drizzle + TanStack + shadcn, организации, оплата. Читать структуру apps/api, код не копировать вслепую (там tRPC). |
| boxyhq/saas-starter-kit | Apache-2.0 · 5k ★ · июл 2026 | Карта «взрослых» разделов: команды, роли, журнал, вебхуки, API-ключи. Только как перечень экранов. |
| Linear · Vercel · GitHub · Supabase · Notion · Claude.ai | эталоны | Два уровня — «моё» и «общее». Подписка видна только админу. Журнал внизу. Ключи как у Vercel: проверить → заменить, старый живёт до успеха. MCP как у Claude.ai: админ подключает, участник включает себе. |
| grammY + menu, conversations, i18n | MIT · окт–ноя 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.
Что дальше
Прототипы — это согласование устройства. Код каркаса пишется после твоего «да» на меню и роли.
- Пройти прототипы и отметить, что лишнее, что не так названо, чего не хватает.
- Шаблон репозитория на стеке каркаса: вход, роли, оболочка с этим меню, «Люди и доступ», «Нейросети», «MCP и API», «Журнал», i18n, демо — с первого дня.
- Вид LANX в forma — отдельной системой рядом с Cozy, чтобы Mini App надевали его так же, как веб надевает Cozy.
- DECIMUS и Swarm — не переписывать, а подвинуть к каркасу смыслом: сгруппировать вкладки DECIMUS, собрать ключи в одно место, дать Swarm журнал и матрицу прав.