Architektura
Datový model
Klíčové tabulky a enumy platformy care.
Data drží Postgres, schéma je v packages/db (Drizzle). Enumy pocházejí z konstant v packages/shared, takže se jejich hodnoty nikdy nepřejmenovávají, jen přidávají.
Klíčové tabulky
| Tabulka | K čemu |
|---|---|
clients | Klienti (firmy a lidé), jejich weby. |
sites | Spravované weby. Nese monitorId (napojení na monitoring), tarif, stav, skupinu. |
jobs | Fronta úkolů pro agenty. Nese type, status, supervised, paused, awaitingInput a výsledek. Ukládá i spotřebu tokenů (vstup, výstup, cache read/write) a použitý model pro výpočet ceny. |
checks | Naměřené body dostupnosti (z monitoringu). Portál z nich počítá uptime. |
incidents | Otevřené a uzavřené incidenty. kind říká, o jaký problém jde. |
functional_checks | Konfigurace funkčních kontrol per web (kind, config, cron). |
inbound_emails | Příchozí testovací e-maily pro roundtrip. Páruje se přes token. |
audits | Běhy veřejného auditu webu (skóre, známka, platforma). |
work_log | Provedené práce. Klientsky viditelné záznamy vidí klient v portálu. |
ai_visibility_results | Historie viditelnosti v AI: per (web, otázka, engine) zmínka, citované URL, pozice citace, konkurence, cena volání. Append-only, aktuální stav je nejnovější řádek. |
ai_readiness | Týdenní snímky připravenosti na AI: počet splněných kontrol a jejich detail v JSON. Append-only, běží všem aktivním webům. |
agent_memory (sloupec na sites, clients, site_groups) | Paměť agenta (markdown) na úrovni webu, klienta a skupiny. |
Enumy
Typy úkolů (JOB_TYPES):
audit, update, backup, fix, custom, func_check, form_testreadyfunc_check: spustí funkční kontrolu.form_testready: připraví formulář na testování.backup: záloha. Jediný typ, který neběží přes agenta, ale deterministickým executorem.
V databázi je v enumu job_type navíc backup_verify. Je to mrtvá hodnota po
starším playbooku - nic ji nezakládá. Postgres neumí hodnotu z enumu odebrat.
Druhy incidentů (INCIDENT_KINDS):
down, degraded, ssl, domain, flowflow: selhala funkční kontrola (formulář neodeslal, e-mail nedorazil).
Druhy funkčních kontrol (FUNCTIONAL_CHECK_KINDS):
form, email_roundtrip