El servidor de Caliu és petit a propòsit. Els teus dispositius fan la major part de la feina, així que el servidor té poques tasques: guardar una còpia de les teves notes, passar els canvis d'un dispositiu a un altre i respondre a les eines que hi connectes.
Construït sobre Cloudflare Workers
El servidor està escrit en TypeScript i funciona a Cloudflare Workers. En lloc de viure en una sola màquina en un sol país, el codi s'executa als centres de dades de Cloudflare repartits per tot el món, i cada petició l'atén un que és a prop teu. No hi ha servidors per actualitzar ni res aturat esperant trànsit.
Es recolza en unes quantes peces de Cloudflare, cadascuna amb una sola feina:
| Peça | Què fa per a Caliu |
|---|---|
| D1 | La base de dades (SQLite) que guarda les teves notes, les etiquetes i el registre de canvis que llegeix la sincronització |
| R2 | L'emmagatzematge de les imatges i els fitxers que adjuntes |
| Durable Objects | Petits ajudants de llarga durada, per exemple un per a cada sessió d'una eina d'IA |
| KV | Un magatzem clau-valor ràpid per a dades de vida curta, com les comprovacions d'inici de sessió |
Una sola API per a tot
Les apps, l'API pública i el servidor MCP per a eines d'IA passen tots per la mateixa API, amb les mateixes regles i les mateixes comprovacions de permisos. No hi ha cap porta del darrere privada per a les apps. Si pots fer alguna cosa a Caliu, l'API la fa de la mateixa manera, i per això la documentació de l'API a caliuapp.com/docs descriu exactament el que fan servir les apps.
Les eines d'IA que es connecten per MCP no veuen mai la teva contrasenya. Les aproves en una pantalla de consentiment, cadascuna rep la seva pròpia clau i la pots revocar quan vulguis a Aplicacions connectades.
Manteniment
Unes quantes tasques programades ho mantenen tot endreçat:
- Cada hora es retiren les etiquetes que ja no tenen cap nota.
- Cada nit s'esborren definitivament les notes que fa 30 dies que són a la paperera, i es tanca la sessió dels dispositius que no s'han fet servir en 90 dies.
Cadascun d'aquests canvis s'anota al registre de canvis, així que els teus dispositius se n'assabenten a la pròxima sincronització.
Fins i tot aquest centre d'ajuda
Els articles que estàs llegint s'escriuen com a fitxers Markdown, s'integren al servidor i s'envien a les apps, que en guarden una còpia perquè l'ajuda també funcioni sense connexió.