O servidor do Caliu é pequeno de propósito. Os teus dispositivos fazem a maior parte do trabalho, por isso o servidor tem uma lista curta de tarefas: guardar uma cópia das tuas notas, passar as alterações entre os teus dispositivos e responder às ferramentas que ligas.
Construído sobre Cloudflare Workers
O servidor está escrito em TypeScript e corre em Cloudflare Workers. Em vez de viver numa só máquina num só país, o código corre nos centros de dados da Cloudflare espalhados pelo mundo, e cada pedido é respondido por um perto de ti. Não há servidores para atualizar nem nada parado à espera de tráfego.
Apoia-se em algumas peças da Cloudflare, cada uma com a sua tarefa:
| Peça | O que faz pelo Caliu |
|---|---|
| D1 | A base de dados (SQLite) com as tuas notas, as etiquetas e o registo de alterações que a sincronização lê |
| R2 | O armazenamento das imagens e dos ficheiros que anexas |
| Durable Objects | Pequenos ajudantes de longa duração, como um para cada sessão de ferramenta de IA |
| KV | Um armazenamento chave-valor rápido para dados de curta duração, como as verificações de início de sessão |
Uma só API para tudo
As aplicações, a API pública e o servidor MCP para ferramentas de IA passam todos pela mesma API, com as mesmas regras e as mesmas verificações de permissões. Não há nenhuma porta das traseiras privada para as aplicações. Se consegues fazer algo no Caliu, a API fá-lo da mesma maneira, e é também por isso que a documentação da API em caliuapp.com/docs descreve exatamente o que as aplicações usam.
As ferramentas de IA que se ligam por MCP nunca veem a tua palavra-passe. Aprova-las num ecrã de consentimento, cada uma recebe a sua própria chave, e podes revogá-la a qualquer momento em Aplicações ligadas.
Manutenção
Algumas tarefas agendadas mantêm tudo arrumado:
- A cada hora, as etiquetas que já não têm notas são removidas.
- Todas as noites, as notas que estão no lixo há 30 dias são eliminadas em definitivo, e os dispositivos que não são usados há 90 dias terminam a sessão.
Cada uma destas alterações é escrita no registo de alterações, por isso os teus dispositivos ficam a saber delas na próxima sincronização.
Até esta central de ajuda
Os artigos que estás a ler são escritos como ficheiros Markdown, integrados no servidor e enviados para as aplicações, que guardam uma cópia para que a ajuda também funcione offline.