O que é o Araru?

O Araru organiza e disponibiliza um acervo digital na infraestrutura controlada pelo proprietário. Um Server central mantém storage, credenciais, metadados e estado de leitura em uma fonte confiável.

Por que self-hosted?

Arquivos e dados de comportamento permanecem sob suas políticas. Ainda é responsabilidade do operador manter HTTPS, credenciais fortes, backups, atualizações e acesso de rede restrito.

O Araru é um software, não um serviço de hospedagem de conteúdo. O projeto Araru não recebe, armazena, fornece nem distribui os arquivos do acervo de um usuário. O operador da instalação fornece arquivos adquiridos legitimamente e os disponibiliza somente por meio da infraestrutura e das redes que controla. Consulte Propriedade e responsabilidade do conteúdo.

Conceitos centrais

• Usuário: identidade autenticada com função e credenciais.
• Perfil: contexto de leitura que isola preferências, favoritos e progresso.
• Library: catálogo lógico e limite de autorização.
• Source: localização de storage configurada pertencente a uma Library.
• Work: item canônico; File: representação em um formato específico.
• Storage provider: serviço que armazena ou transmite uma Source, como filesystem local, Google Drive ou Cloudflare R2.
• Metadata provider: primeiro o nome do arquivo e os dados incorporados; depois ISBN e fontes externas opcionais.
• Reader engine: engine do cliente específica por formato, com navegação e progresso compartilhados.
• Background job: trabalho durável de indexação, reconciliação, metadados ou capas.

Clientes nunca acessam PostgreSQL, Redis, filesystem, Drive ou segredos diretamente.