Напускате Airtable? Пренесете базите си в Artavolo, проверени запис по запис. Вижте как

Архитектура, наематели и ограничения

За архитекти и ИТ екипи, които оценяват Artavolo за организация: как е изграден, как се разделят наемателите, как го администрира организацията, какви са ограниченията и как расте. Всичко тук описва продукта такъв, какъвто се доставя; онова, което още не е изградено, е изброено в края. Придружаващи документи: преглед на сигурността, еднократен вход, резервни копия, data API, API, съвместимо с Airtable, AI агенти.

Накратко

  • Три начина да го пуснете, един код. Хостваната услуга (artavolo.com, OVHcloud, Германия), управлявана частна инстанция (една виртуална машина на клиент, ЕС) или на собствени сървъри (Docker или обикновен LAMP сървър).
  • Тенант = работно пространство в хостваната услуга, инстанция навсякъде другаде. Хостваните работни пространства споделят сървъри и са разделени от приложението. Организация, която се нуждае от физическо разделяне, взема управлявана инсталация или поддържа своя.
  • Технологиите са нарочно прости: PHP 8 и MySQL/MariaDB (PostgreSQL за базата с данните), с по избор Redis. Не са нужни облачни услуги на доставчика и нищо не изпраща данни навън.
  • Без ограничение на записите на всеки план. В хостваната услуга квотата за файлово пространство е тази, която отказва действие. API заявките са ограничени на токен и на работно пространство.

Компоненти

 browser (SvGrid Base UI, Svelte)          programs: REST, /v0 (Airtable-compatible), MCP (AI chat and agents)
            |                                          |
            +------------------ HTTPS -----------------+
                                |
                 reverse proxy / TLS (Caddy, Apache, cPanel)
                                |
        PHP application (stateless per request; sessions in PHP's session store)
          |            |              |                 |                |
   application DB   data DB       uploads          websocket server     cron
   (MySQL/MariaDB)  (MySQL/       (per-workspace    (live updates;      (automations,
   accounts,        MariaDB or    folders on a      Pusher as the       scheduled backups,
   workspaces,      PostgreSQL)   volume)           hosted fallback)    imports, Airtable sync)
   permissions,     one table
   audit log,       per user
   settings         table
          |
   Redis (optional cache)
  • База данни на приложението. Акаунти, работни пространства, бази, дефиниции на таблици, права, API токени, агенти, дневникът на промените, настройки и броячи на ограниченията.
  • Базата с данни. Всяка таблица, която създава човек, е отделна SQL таблица (database_<id>) с реални типове колони и индекси, така че филтрирането, сортирането, групирането и страницирането да се извършват в SQL. Може да е на отделен сървър, през TLS, като MySQL/MariaDB или PostgreSQL (DB_DRIVER_DATA).
  • Файлове. Прикачените файлове се съхраняват в uploads/workspaces/<workspace id>/ и достъпни само през маршрут с проверка на правата (или подписана връзка с ограничен срок за имейли и уебхукове).
  • Изчислени стойности на сървъра. Връзките се съхраняват по идентификатор на запис. Справките, обобщенията, броячите и формулите се изчисляват на сървъра, както и в страницата, така че API, AI чатът и агентите четат същите стойности, които виждат хората.
  • Работа след отговора. Уебхуковете, имейлите от автоматизации и стъпките с уебхук се изпращат, след като заявката е отговорена, с ограничения във времето, така че бавен получател никога да не забавя човек.
  • Работа във фонов режим. Cron (app_crons.php) изпълнява автоматизациите, планираните резервни копия, импортите от Airtable (възобновяеми задачи) и двустранната синхронизация с Airtable.

Модел на мултитенантност

Йерархията

НивоКакво представляваКой го контролира
ИнсталацияЕдна инсталация: хостваната услуга или вашият управляван или собствен сървърАдминистратори на инсталацията
Работно пространствоПространство на организация или екип: членове, план, място, API токени, агентиСобственици на работното пространство
БазаНабор от свързани таблици със собствени членове и правилаСобственици на бази
ТаблицаПолета, изгледи, формуляри, автоматизации, видимост и правила за редовеСобственици на бази
ЗаписЕдин ред; кой го вижда може да се стесни с правила за редовеСътрудници (според правилата)

Един човек може да е член на няколко работни пространства с различни роли във всяко.

Модели на внедряване

Хоствано (artavolo.com)Управлявана частна инсталацияНа собствен сървър
ТенантРаботно пространствоЦялата инсталацияЦялата инсталация
Сървъри и бази данниСподелено с други клиентиЕдна виртуална машина, един сървър за бази данни, едно хранилище и един ключ за резервни копия на клиентВаше
КъдеOVHcloud, ГерманияHetzner, Германия (Фалкенщайн или Нюрнберг), или друго място в ЕС по договарянеНавсякъде, където го стартирате
ИзолацияНа ниво приложение (по-долу)Физическо: нищо не се споделя с други клиентиФизически
НадгражданияНепрекъснатоМесечен прозорец, обявен предварително; първо моментна снимка и резервно копие преди обновяванетоВие избирате; миграциите се изпълняват автоматично
АдминистрацияСобственици на работното пространство; Artavolo управлява инсталациятаВашите администратори чрез SSO; Artavolo управлява сървъраВашите администратори
ЛицензНа човек на месецПо оферта (Enterprise)Community (безплатно) или същите планове на човек като при хостинга с лицензен ключ; Enterprise по оферта

Как са разделени хостваните работни пространства

В хоствана услуга клиентите споделят едни и същи сървъри за бази данни. Разделянето се налага от приложението на всеки път, по който се връщат данни:

  • Всяка заявка се удостоверява и проверява срещу работното пространство, базата, таблицата и записа, преди да бъдат прочетени каквито и да е данни. Това важи за браузъра, REST и /v0 API, AI чат (MCP), изтегляне на файлове, актуализации на живо, експорти, гости и публикувани формуляри.
  • API токените са вързани към едно работно пространство, и по желание до посочени бази. Токенът не може да достигне друго работно пространство, дори и същият човек да е член и в него.
  • Идентичностите на агентите са с ограничен обхват до посочени бази с достъп за четене или запис, а промените им могат да бъдат задържани за преглед.
  • Правила за редове ограничават кои записи вижда човек. Сървърът ги прилага вътре в заявката към базата данни.
  • Файловете се пазят в папка за всяко работно пространство, обслужвани през проверката на правата и отчитани в заетото място на това работно пространство.
  • Обновяванията на живо стигат само до хора, които имат право да виждат промяната. Таблица с правило за редове изпраща актуализации на живо само на хората, които виждат всички записи.
  • Всяка промяна е в дневника на промените, който само се допълва, заедно с работното пространство, базата и таблицата, към които принадлежи.
  • Незадължително криптиране на клетки (AES) за инсталации, които искат стойностите да са нечетими в самата база данни. Изключва филтрирането на сървъра върху шифрованите стойности.

Тези граници са покрити от автоматизираните тестови набори в tests/, за членове, токени, работни пространства и гости.

Използване и администриране като организация

Роли

РоляМоже
Администратор на инсталациятаВсичко на инсталацията: членове, настройки, единичен вход, поща, резервни копия, лиценз, целият дневник на промените
Собственик на работното пространствоЧленове и покани, роли, бази, API токени, агенти, дневникът на промените на работното пространство и експорт
Собственик на базатаПолета, изгледи, формуляри, автоматизации, видимост на таблиците, кой може да създава, редактира и изтрива записи, правила за редове
СътрудникРаботете със записите, доколкото правилата на базата позволяват
Само за четенеЧетат таблиците, които имат право да виждат; запазват лични изгледи
Гост / попълнил формулярПубликуван изглед само за четене или формуляр, по желание защитен с парола, без акаунт
АгентИменувана нечовешка идентичност с токен с ограничен обхват; промените ѝ се отчитат на нейно име, одитират се и могат да бъдат върнати или задържани за одобрение

Идентичност и достъп

  • Единичен вход с OpenID Connect (Microsoft Entra ID, Okta, Keycloak и всеки стандартен доставчик на OpenID Connect). Опции:
    • автоматично създаване на акаунти при първи вход в избрано работно пространство и роля;
    • свързване на съществуващи акаунти по потвърден имейл;
    • съпоставяне на имейл домейни с доставчици;
    • при задължителен SSO, така че паролите работят само за администраторите.
  • SAML 2.0 и LDAP/Active Directory са налични при поискване.
  • Двуфакторна автентикация (TOTP с еднократни кодове за възстановяване) за всички.
  • Сесии: по избор време за неактивност, което отменя и „запомни ме“.
  • Блокиране при груба сила обхващат пароли, кодове и API идентификационни данни.
  • Напускане: всяка заявка се проверява спрямо текущото членство, така че премахването на човек от работно пространство прекратява и достъпа му през API токени и AI чат. Администратор може да блокира акаунт изцяло. Изтриването по чл. 17 от GDPR премахва акаунта, неговите токени, сесии и лични данни и записва изтриването в дневника на промените.

Контрол

  • Дневник на промените: само за добавяне. Всеки запис съдържа извършителя, метода (браузър, API токен, AI чат през кое приложение, агент), IP адреса и стойностите преди/след. Собствениците на работни пространства четат и експортират записите за своето пространство като CSV или JSON; администраторите виждат всичко. Срокът на съхранение е конфигурируем.
  • История: история на записа и коментари при всеки запис.
  • Възстановяване:
    • изтритите записи, полета, изгледи и таблици остават 30 дни в кошчето;
    • изтриванията от агенти винаги отиват в кошчето;
    • „revert“ връща назад пакета промени на един агент по стойностите от дневника на промените.
  • Резервни копия: шифровани с AES-256 и HMAC етикет, обхващащи и двете бази данни и качените файлове, и проверявани преди всяко възстановяване. Enterprise добавя дневен график, срок на съхранение, външни копия в S3-съвместимо хранилище и известия при неуспех.
  • Здраве: GET /status показва версия, достъпност на базата данни и състояние на лиценза, без тайни данни.

Интеграции, които ИТ екипът ползва

  • REST API за данни (/api/v2): имена и идентификатори, филтриране, сортиране, групиране и странициране в SQL.
  • API, съвместимо с Airtable (/v0): съществуващите скриптове и SDK код за Airtable продължават да работят след смяна на адреса и токена.
  • AI конектор (MCP): Вход с OAuth, с обхват за всяка връзка, всеки запис се одитира.
  • Уебхукове: изходящи уебхукове и автоматизации, които създават или обновяват записи или извикват уебхукове.
  • Вграждане: публикуваните формуляри и изгледи могат да се вграждат във всеки уебсайт; подписаните вграждания са ограничени до разрешени източници.

Ограничения за наемател

Хоствани планове (за работно пространство)

FreeStandardProЛиценз Enterprise (на собствен сървър)
Записи в базаБез ограничениеБез ограничениеБез ограничениеБез ограничение
БазиБез ограничениеБез ограничениеБез ограничениеБез ограничение
Членове (потребители)Без ограничениеКакто са купениКакто са купениБез ограничение
Съхранение на файлове2 GB20 GB100 GB1000 GB по подразбиране; задава се от сървъра
Пазени резервни копия на базата102550Без ограничение

Хранилището е единствената квота в хостваната услуга, която отказва действие, когато бъде достигната: качване над оставащото място се отказва с ясно съобщение. Работното пространство запазва по-голямо ограничение, ако е получило такова по по-ранен план. Изданието Community на собствен сървър няма ограничения в приложението.

Ограничения, които защитават всички (всички планове)

КаквоОграничениеЗащо
API заявки, на токен600 в минута при хостваната услуга (Airtable: 5 в секунда на база)Един скрипт не може да забави другите клиенти
API заявки, на работно пространство3000 в минута при хостваната услугаСъщото, за много токени наведнъж
Над лимита429 с Retry-After, във формата на грешките на Airtable при /v0Клиентите, които обработват 429 на Airtable, вече изчакват правилно
Промени от AI чата1000 на ден на човек (честно използване; включено в потребителя)
Един качен файл25 MB (импорти до 100 MB)
Записи на страница от API100 при /v0 (както в Airtable); до 10 000 при /api/v2
Записи на една заявка за запис10 при /v0 (както в Airtable); 50 на едно повикване на AI чата
Неуспешни влизания5 на акаунт или 20 на IP адрес за 15 минути, после 15-минутно заключване
Покани20 на час на човек, 50 на IP адрес

В управлявана инсталация или такава на собствен сървър ограниченията на API са изключени по подразбиране. Администратор може да ги зададе в includes/config.php (API_RATE_PER_TOKEN, API_RATE_PER_WORKSPACE, заявки в минута; 0 изключва ограничението). На отделно работно пространство може да се зададе собствена стойност със системната опция api_rate_workspace_<workspace id>. При хостваната услуга работно пространство, което се нуждае от повече (нощна синхронизация, голяма интеграция), получава повече по същия начин, при заявка.

Как се мащабира

Големи таблици

  • Без ограничение на редовете. Всяка таблица е истинска SQL таблица с типизирани, индексирани колони. Филтрирането, сортирането, групирането, броенето и търсенето се изпълняват в базата данни, а не чрез зареждане на таблицата в PHP.
  • Малките таблици се зареждат изцяло. Браузърът държи таблица до 10 000 записа в страницата, което прави филтрирането и превъртането мигновени.
  • По-големите таблици се показват на страници. Над 10 000 записа таблицата чете страници от сървъра, докато превъртате (сървърният модел на редове на SvGrid), така че таблица със стотици хиляди записа се отваря също толкова бързо, колкото малка.
  • Импортите са фонови задачи. Продължават след грешка, изчакват при ограничението на Airtable за заявки и са тествани върху база с 25 000 записа и три таблици.

Растеж на инсталация

ЕтапКакво да направите
Екип до няколкостотин душиЕдин сървър: приложение, двете бази данни и файловете заедно (референтният Docker стек). Управляваните инсталации ползват 2 vCPU / 4 GB до 100 потребители и 4 до 8 vCPU / 8 до 16 GB до 500
По-интензивна употребаПреместете базата данни с данните на собствен сървър или в управлявана услуга MySQL/MariaDB или PostgreSQL (поддържа се TLS). Включете Redis за кеширане
Още приложни сървъриЗаявките нямат състояние, освен PHP сесията. Пуснете няколко приложни сървъра зад балансьор на натоварването, с лепливи сесии (или споделено хранилище за сесии) и директорията за качените файлове на споделено хранилище (NFS или подобно). Пуснете cron и websocket сървъра на един възел
Висока достъпностРепликация на базата данни с прехвърляне при отказ (MariaDB/Galera или стрийминг репликация на PostgreSQL), два или повече сървъра за приложението и криптирани резервни копия, изпращани извън сървъра всеки ден

Какво поддържа всяка заявка евтина

  • Странициране. Голяма таблица се чете по една страница, с филтрите и сортирането, приложени в SQL.
  • Без чакане при изходящи заявки. Уебхуковете и имейлите се изпращат след отговора, с 5 секунди за свързване и 10 секунди общо.
  • Атомарни броячи. Ограниченията на честотата и заключванията са единични SQL заявки, затова не изискват Redis на обикновен хостинг.
  • Промените на живо се предават като пакети с разлики. Съобщението по websocket носи само променените клетки.

Още не е налично

За да не ги открие първо някой преглед:

  • Автоматично създаване на потребители със SCIM. Хората се създават при първия вход през SSO (в движение). Премахването се прави в Artavolo, а не се предава от доставчика на идентичност.
  • SAML 2.0 and LDAP са налични при поискване, а не като настройка, която правите сами.
  • Отделни бази данни за всяко хоствано работно пространство. Организация, която изисква физическо разделяне, ползва управлявана частна инсталация.
  • Публикувана референтна инсталация с няколко възела. Частите са налице (по-горе), но тестван compose файл с балансиране на натоварването и публичен бенчмарк при милион записа тепърва предстоят.
  • Изглед на използването по работно пространство (API заявки, място във времето) за собствениците на работното пространство. Днес се показва заетото място, а използването на API се вижда в дневника на промените.
Въпрос, на който тези страници не отговарят? Пишете ни и ще ви отговорим по имейл, обикновено в рамките на един работен ден. Свържете се с нас