# vibemd

> Бэкенд как сервис и хостинг статики для сайтов, которые пишет AI-агент.
> Агент создаёт проект, объявляет сущности, получает CRUD REST API и заливает
> собранный фронтенд — сайт живёт на `https://{slug}.vibemd.ru` с подключённым
> бэкендом и HTTPS. Отдельной утилиты нет: всё делается через `curl`.

Доступ выдаёт Telegram-бот: https://t.me/vibemd_bot — команда `/start`, затем
email. В ответ приходит личный токен аккаунта (`vmd_u_...`), которым создаются
проекты. Токен показывается один раз, `/token` выпускает новый взамен.
Сам ты токен не выпустишь — попроси его у пользователя.

## Начни отсюда

- [Инструкция для агента](https://agent.vibemd.ru/agent.md): порядок действий от
  создания проекта до задеплоенного сайта, примеры запросов, частые ошибки и
  чек-лист перед сдачей. Отдаётся как `text/markdown`.
- [Описание API](https://api.vibemd.ru/v1/): машиночитаемый список всех методов,
  типов полей, операторов фильтрации и формата ошибок. Если сомневаешься в
  сигнатуре — читай его, а не угадывай.

## Что умеет сервис

- Динамические схемы сущностей: поля типов `string`, `number`, `boolean`,
  `date`, `json`; записи валидируются по схеме перед записью.
- CRUD над записями с фильтрами (`eq`, `ne`, `gt`, `gte`, `lt`, `lte`,
  `contains`, `in`), сортировкой и пагинацией.
- Ключи двух уровней: `admin` — у агента, `public` — в браузере. Для каждой
  сущности отдельно задаётся `public_access`: `none`, `read`, `append`, `write`.
  Формы заявок — это `append`.
- Вход посетителей сайта (`X-User-Token` рядом с public-ключом) и флаг владельца,
  которому доступно всё в своём проекте.
- Деплой архивом (`tar.gz` или `zip`) с версиями и мгновенным откатом; адрес API
  и public-ключ подставляются в HTML при отдаче — не хардкодь их в билде.
- Ошибки в формате `{"error": {code, message, details[], hint}}`: в них написано,
  что именно чинить.

## Ограничения

- Сайт живёт на поддомене `{slug}.vibemd.ru`; свои домены не поддерживаются.
- Панели управления нет вовсе — только API.
- По умолчанию: 5 проектов на аккаунт, 25 сущностей, 50 000 записей, 256 МБ
  хранилища, 100 МБ билд, 600 запросов в минуту на проект.