Архитектура, наематели и ограничения
За архитекти и ИТ екипи, които оценяват 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 и
/v0API, 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, с обхват за всяка връзка, всеки запис се одитира.
- Уебхукове: изходящи уебхукове и автоматизации, които създават или обновяват записи или извикват уебхукове.
- Вграждане: публикуваните формуляри и изгледи могат да се вграждат във всеки уебсайт; подписаните вграждания са ограничени до разрешени източници.
Ограничения за наемател
Хоствани планове (за работно пространство)
| Free | Standard | Pro | Лиценз Enterprise (на собствен сървър) | |
|---|---|---|---|---|
| Записи в база | Без ограничение | Без ограничение | Без ограничение | Без ограничение |
| Бази | Без ограничение | Без ограничение | Без ограничение | Без ограничение |
| Членове (потребители) | Без ограничение | Както са купени | Както са купени | Без ограничение |
| Съхранение на файлове | 2 GB | 20 GB | 100 GB | 1000 GB по подразбиране; задава се от сървъра |
| Пазени резервни копия на базата | 10 | 25 | 50 | Без ограничение |
Хранилището е единствената квота в хостваната услуга, която отказва действие, когато бъде достигната: качване над оставащото място се отказва с ясно съобщение. Работното пространство запазва по-голямо ограничение, ако е получило такова по по-ранен план. Изданието Community на собствен сървър няма ограничения в приложението.
Ограничения, които защитават всички (всички планове)
| Какво | Ограничение | Защо |
|---|---|---|
| API заявки, на токен | 600 в минута при хостваната услуга (Airtable: 5 в секунда на база) | Един скрипт не може да забави другите клиенти |
| API заявки, на работно пространство | 3000 в минута при хостваната услуга | Същото, за много токени наведнъж |
| Над лимита | 429 с Retry-After, във формата на грешките на Airtable при /v0 | Клиентите, които обработват 429 на Airtable, вече изчакват правилно |
| Промени от AI чата | 1000 на ден на човек (честно използване; включено в потребителя) | |
| Един качен файл | 25 MB (импорти до 100 MB) | |
| Записи на страница от API | 100 при /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 се вижда в дневника на промените.