Tudo o que vale perguntar antes de nos confiar uma coleção.

O KolleK é uma aplicação de código aberto para catalogar coleções. Você registra o que possui, objeto a objeto e cópia física a cópia física, com fotos, documentos, valores e histórico, e executa tudo no seu próprio servidor ou usa uma instância que outra pessoa mantém. É publicado sob a licença MIT.

Primeiro, para colecionadores particulares que já não cabem numa planilha. Casas, clubes e organizações pequenas também funcionam, porque uma conta pode reunir várias pessoas com papéis diferentes. Não é um software institucional de gestão de coleções e não pretende ser.

Qualquer um. Uma conta nova começa com doze tipos de coleção prontos (quadrinhos, cards, discos de vinil, CDs, DVDs, moedas, selos, livros, action figures, videogames, relógios e vinhos), e você pode editar qualquer um deles ou criar os seus do zero.

Sim, e nada no código limita a quantidade. Cada coleção tem nome, emoji, descrição e moeda próprios, além das suas próprias categorias e sets.

Um objeto é a coisa em abstrato: um título, um modelo, uma edição. Uma cópia é um exemplar físico específico que você possui, com condição, local, preço pago e histórico próprios. Três exemplares do mesmo quadrinho são um objeto com três cópias. É a ideia mais importante do KolleK.

Sim. Um objeto pode ser só um nome e uma foto, ou um registro com campos personalizados, várias cópias, avaliações, seguros, empréstimos, manutenção, procedência e documentos anexados. Os campos que você não define nunca aparecem.

Sim, em sete: inglês, francês, espanhol, alemão, português do Brasil, chinês simplificado e japonês. Cada pessoa escolhe o seu, e a documentação e este site público também são traduzidos.

Não. Não há aplicativo nativo para iOS ou Android, e nada disso está no código hoje. O KolleK é uma aplicação web que você abre no navegador.

Sim. Todas as telas são feitas até a largura de um celular, e adicionar fotos usa o seletor de arquivos normal do aparelho, que no celular inclui a câmera.

Sim, sob a licença MIT, com todo o código-fonte público no GitHub. Essa licença não pode ser revogada para o código já publicado.

Sim, e é a forma principal de rodá-lo. Uma pilha do Docker Compose sobe o servidor web, um worker de filas, um agendador e o banco de dados, e nada fica de fora da versão auto-hospedada.

O software é o mesmo, e o conjunto de recursos também: nada fica trancado atrás de um plano, e nenhum recurso é retirado da versão hospedada por você. O que muda é quem cuida do servidor, aplica as atualizações e guarda os backups, e o fato de uma conta hospedada comportar dez itens de graça antes de precisar ser desbloqueada. Uma instância própria não tem esse limite.

A auto-hospedagem, se você se sente à vontade com uma pilha Docker pequena e assume a responsabilidade pelos backups. É grátis, e seus dados nunca saem da sua máquina. Se preferir não administrar nada, use uma instância hospedada.

Sim. Você mantém a propriedade de tudo o que adiciona, e os termos de uso dizem isso. No serviço hospedado, armazenamos e processamos os dados para operar o serviço, nada além disso, e não treinamos nada com eles.

Em parte, e essa é a lacuna honesta do produto hoje. Você consegue exportar a definição de um tipo de coleção em JSON e a lista de empréstimos abertos em CSV. Ainda não há exportação de objetos nem de uma coleção inteira. Se você se auto-hospeda, a resposta completa é um backup do banco de dados e do volume de armazenamento, que contém tudo.

Ainda não pela aplicação, porque a exportação de objetos não existe. Até lá, migrar significa pedir a quem opera sua instância hospedada um dump do banco e dos arquivos e restaurá-lo na sua própria instalação.

A mesma resposta no sentido inverso: ainda não há caminho de importação para objetos. Duas instâncias só podem ser unidas no nível do banco de dados, por quem as opera.

Uma instância auto-hospedada continua funcionando exatamente como está. Ela não chama ninguém, não verifica licença nenhuma, e a licença MIT garante que ninguém pode tirar o código de você. Numa instância hospedada, você pode apagar sua conta e tudo o que há nela quando quiser.

Na Laravel Cloud, com o banco de dados na Turso e a Cloudflare à frente para DNS, cache e proteção. Dependendo desses provedores, suas informações podem ser processadas em um país diferente do seu, e por enquanto não oferecemos escolha de região.

Laravel Cloud para a aplicação, Turso para o banco de dados e Cloudflare para DNS, roteamento, TLS e proteção contra abuso. Eles processam dados em nosso nome como provedores de infraestrutura, e a política de privacidade cita cada um pelo nome.

A hospedagem própria é gratuita, e custa o que custar o seu próprio servidor. No serviço hospedado, uma conta comporta dez itens de graça, e desbloqueá-la de vez é um pagamento único de US$ 49. O checkout ainda não está aberto, então nada pode ser comprado hoje, mas as telas que explicam o limite já estão no aplicativo.

Não, e não existe mecanismo para isso. Nada no KolleK pode cobrar um cartão de forma recorrente. O compromisso é um pagamento que desbloqueia a conta permanentemente, nunca um aluguel.

Ele remove o limite de itens de uma conta hospedada e paga o lado operacional: os servidores, as atualizações, os backups e o suporte. Não desbloqueia recursos, porque todos já estão no aplicativo, não importa como você o execute.

Sim. Não há teste, nem nível reduzido, nem chave de licença para comprar. A licença MIT sobre o código publicado não pode ser retirada depois.

Uma instância própria não tem cota nenhuma. No serviço hospedado, a única cota é de itens: uma conta comporta dez de graça, aceita mais cinco como cortesia e depois para de aceitar novos até ser desbloqueada. Nada do que já foi adicionado é excluído, escondido ou transformado em somente leitura. Coleções, membros, fotos e documentos não são contados em nenhum dos casos. Os limites que restam são por arquivo (10 MB para uma foto, 12 MB para um documento) e o disco que você der à instância.

Não, e dizemos isso antes de você pagar, em vez de nas letras miúdas. Um estorno custa a um projeto deste tamanho a taxa do pagamento, a multa do chargeback e uma tarde de papelada. Se algo der errado, escreva para nós e resolvemos. Se preferir não pagar nada, a hospedagem própria é gratuita e sempre será.

Podem mudar, para compras futuras. Os termos de uso dizem que uma compra única já concluída não é reprecificada retroativamente e não vira assinatura.

Não. Auto-hospedar não envolve conta conosco, cadastro nem etapa de pagamento. Você clona o repositório, ou baixa a imagem, e executa.

Quando planos hospedados forem vendidos, o IVA e os impostos sobre vendas dependerão de onde você estiver e serão mostrados antes do pagamento, como descrevem os termos de uso.

Não há cobrança por pessoa nem nível separado, então uma casa e uma organização de trinta pessoas pagariam o mesmo. Se você precisar de nota fiscal ou documentação de compra, fale conosco.

Nada do que você registra é visível fora da sua conta: não há link público nem qualquer forma de descoberta. Dentro de uma conta, saiba que hoje todo membro consegue percorrer todas as coleções. A configuração de visibilidade por coleção é salva, mas ainda não é aplicada.

Não. A política de privacidade diz isso com todas as letras, e aqui não há modelo de publicidade que precisasse disso.

Não. Não há rastreadores de publicidade, análise de terceiros nem pixels na aplicação. Registros operacionais (requisições, erros, eventos de segurança) são mantidos para operar e depurar o serviço.

Sim. Nomes, descrições, identificadores e notas são criptografados pela aplicação com a chave da sua instância antes de chegarem ao banco de dados, e o tráfego usa TLS. Não é criptografia de ponta a ponta: quem opera a instância guarda a chave e consegue ler os dados.

Se você se auto-hospeda, você. A chave é a APP_KEY do seu próprio arquivo de ambiente, e ninguém mais a vê. No serviço hospedado, nós guardamos a chave da aplicação, e os provedores de infraestrutura não a recebem.

Elas operam os sistemas que armazenam e transportam os dados, como provedores de infraestrutura agindo em nosso nome. A chave de criptografia da aplicação não é entregue a elas, e nenhuma delas ganha o direito de usar sua coleção para fins próprios.

Para DNS, terminação TLS, cache e proteção contra negação de serviço e outros abusos. Isso mantém um projeto pequeno rápido e acessível sem uma equipe de infraestrutura por trás.

Autenticação em dois fatores com códigos de recuperação, login sem senha por link mágico, senhas verificadas contra vazamentos conhecidos, e-mails de alerta para eventos sensíveis (novo dispositivo, novo endereço IP, tentativas de login malsucedidas, chave de API criada ou revogada), permissões por papel aplicadas a cada gravação, chaves de API revogáveis e uma trilha de auditoria de quem mudou o quê. Não há login único, suporte a chaves físicas nem uma tela para gerenciar sessões ativas.

Sim, com qualquer aplicativo autenticador padrão e um conjunto de códigos de recuperação de uso único entregues quando você a ativa.

Os campos sensíveis são criptografados pela aplicação antes de serem gravados, então continuam criptografados dentro de qualquer dump do banco, inclusive o seu. Além disso, os backups hospedados servem apenas à recuperação operacional, e os backups auto-hospedados ficam protegidos pelo que você usar para protegê-los.

Relate em particular, por e-mail ao mantenedor, em vez de abrir uma issue pública, e ele será olhado antes de qualquer outra coisa. Não há programa de recompensas nem um cronograma formal de divulgação a prometer.

Sim. Você pode apagar seu usuário pelo perfil, e um proprietário pode apagar a conta inteira com tudo o que há nela. Também existe a opção de ter seu usuário apagado automaticamente após um longo período de inatividade. A exclusão vai saindo dos backups conforme a rotação normal deles.

Coleções, objetos e as cópias que você possui, fotos, documentos, categorias, etiquetas, locais, condições, sets e séries e, em cada cópia, transações, avaliações, seguros, empréstimos, manutenções, eventos de procedência e histórico de locais.

Sim, várias por objeto, na ordem que quiser, com uma marcada como principal. Cada envio é redimensionado em variantes menores para navegação, e uma foto pode ter até 10 MB. A conta também tem uma fototeca que mostra todas as imagens em um só lugar.

Sim. Um documento se anexa a uma cópia ou a um dos seus registros (uma transação, uma avaliação, um seguro, um empréstimo, uma manutenção, um evento de procedência). PDFs, imagens, arquivos do Word e do Excel, CSV e texto simples são aceitos até 12 MB, e você também pode registrar um documento que fica em uma URL externa.

Sim. As avaliações formam um histórico em vez de um número só, cada uma com tipo e nível de confiança, então dá para ver como uma cópia evoluiu. Compras e vendas são transações, o seguro tem registro próprio com os dados da apólice, e a papelada se anexa a qualquer um deles.

Ainda não. A exportação se limita às definições de tipos de coleção em JSON e aos empréstimos abertos em CSV. A exportação de objetos e de coleções inteiras é uma lacuna conhecida, acompanhada na página de status de recursos da documentação.

Apenas a definição de um tipo de coleção, a partir do JSON que a exportação gera. Não há importação de planilha ou CSV para objetos, então hoje uma coleção é preenchida à mão ou pela API.

O serviço hospedado mantém backups para recuperação operacional. Eles existem para o serviço poder ser restaurado, não como um desfazer de autoatendimento, e não substituem os seus próprios registros.

Sim, sem nada a mais para comprar. São backups operacionais da instância inteira, e não instantâneos por conta que você possa percorrer.

Sua, inteiramente. Tudo mora em dois lugares: o volume do banco de dados e o volume de armazenamento com fotos e documentos. Faça backup dos dois com as ferramentas em que você já confia e guarde uma cópia da sua APP_KEY, porque os dados criptografados são ilegíveis sem ela.

Coleções, objetos, cópias, categorias e sets vão para a lixeira e podem ser restaurados por 30 dias por padrão; depois disso, uma tarefa diária os remove de vez. Fotos, documentos e registros de histórico são apagados na hora e não podem ser recuperados de dentro da aplicação.

Sim. Esvaziar a lixeira remove o conteúdo dela na hora, e apagar a conta remove tudo o que pertence a ela.

Sim. Um tipo descreve o que um gênero de coleção guarda, e toda coleção que o usa herda esses campos. Edite os que vêm com uma conta nova, ou crie os seus, e exporte a definição em JSON para reaproveitá-la em outro lugar.

Sim, de seis tipos: texto, número, data, sim/não, uma lista de opções sua e uma nota de um a cinco. Os campos ficam em grupos nomeados para que um formulário longo continue legível, e tanto campos quanto grupos podem ser reordenados.

Os cinco, e são independentes. Categorias se aninham dentro de uma coleção, locais se aninham quanto você quiser (uma prateleira dentro de uma caixa dentro de um cômodo), etiquetas são compartilhadas por toda a conta, um set acompanha o avanço até uma meta e uma série agrupa objetos que andam juntos.

Sim, e é justamente por isso que objetos e cópias são separados. Cada cópia carrega identificador, condição, local, data de aquisição, preço pago e histórico próprios.

Sim, nos dois sentidos: o que você emprestou e o que pegou emprestado. Um empréstimo registra a outra parte, as datas, o prazo e a condição em que a cópia saiu e voltou, e os empréstimos abertos de cada sentido podem ser baixados em CSV.

Sim. Os eventos de procedência formam uma cadeia datada em uma cópia, cada um com tipo, parte envolvida, descrição e os documentos que você anexar.

Sim. Os registros de manutenção guardam o tipo de serviço, a data, o custo, quem fez e a papelada que veio junto.

Sim. As avaliações registram quanto uma cópia vale ao longo do tempo e de onde veio esse número. As transações registram o que foi pago ou recebido, quando e com quem. Os valores são guardados na moeda da coleção.

Sim. As fotos são gerenciadas no objeto e em uma fototeca da conta inteira que mostra cada imagem enviada. Os documentos são gerenciados na cópia ou no registro a que pertencem, e todos eles aparecem na busca.

Sim. Uma única busca cobre objetos, cópias, coleções, fotos, empréstimos, locais, sets, séries, categorias, etiquetas e documentos, e os resultados vêm agrupados por tipo. Funciona mesmo com o texto criptografado por baixo, porque as palavras são indexadas como hashes em vez de guardadas em texto claro.

Sim, por coleção: totais, valor ao longo do tempo, aquisições por mês, divisões por categoria, condição e local, os objetos mais valiosos e o quanto falta para completar seus sets. Ainda não há uma tela consolidada da conta inteira, e o painel mostra a atividade recente no lugar disso.

Sim. Um proprietário convida por e-mail e escolhe o papel naquele momento. O convite é aceito por um link, e não há cobrança por membro.

Três: proprietário, editor e visualizador. Proprietários cuidam de membros, configurações e exclusão; editores criam e alteram registros; visualizadores apenas leem. Uma conta sempre mantém pelo menos um proprietário, então o último não pode ser removido nem rebaixado.

Sim. Todo mundo em uma conta trabalha nas mesmas coleções, e cada ação é registrada com o autor, então o feed de atividade e o histórico de um objeto mostram de onde veio a mudança.

Ainda não. Uma coleção tem uma configuração de visibilidade, e ela é salva, mas nada a aplica e não existe link público, então uma coleção marcada como pública não é acessível de fora da conta de jeito nenhum.

Não em relação aos outros membros da sua própria conta, pelo mesmo motivo: a visibilidade é registrada, mas hoje não é aplicada. Quem você convidar enxerga todas as coleções da conta, então mantenha em contas separadas o que precisa mesmo ficar separado.

Sim, na hora, por um proprietário. O acesso termina naquele momento, e o que a pessoa registrou continua na conta.

Sim, é exatamente para isso que servem as contas e os papéis. Um ponto a considerar: cada pessoa pertence a exatamente uma conta, e um endereço de e-mail só pode ter um usuário, então não dá para entrar na conta de um clube e manter uma pessoal.

A aplicação tem uma seção de suporte onde você abre um tópico e recebe as respostas ali mesmo. Ela fica desligada até que o operador da instância a ative, então numa instância auto-hospedada normalmente ela não aparece.

Docker Engine 24 ou mais novo com o plugin Compose e disco suficiente para suas fotos e documentos. Um VPS pequeno ou uma máquina em casa dá e sobra. A pilha sobe o servidor web, um worker de filas, um agendador e o MySQL.

Sim, e é o caminho recomendado. Copie o arquivo de ambiente de exemplo, gere uma chave de aplicação e suba a pilha. O guia completo está no repositório e na seção de auto-hospedagem da documentação.

Sim. É uma aplicação Laravel convencional, então PHP 8.4 com as extensões de sempre, um banco de dados, um servidor web, um worker de filas e um agendador resolvem. Você só terá menos ajuda nossa do que no caminho documentado com Docker.

MySQL 8, que a pilha do Docker sobe para você. O SQLite serve para desenvolvimento local, e outros bancos suportados pelo Laravel podem funcionar, mas o MySQL é o que o projeto testa e documenta.

Baixe a imagem nova e reinicie a pilha. As migrações rodam na inicialização e são escritas para serem seguras em um banco existente, então uma atualização nunca zera seus dados nem seus arquivos.

Ficam por sua conta. Faça backup do volume do banco de dados e do volume de armazenamento, guarde sua APP_KEY em lugar seguro e teste uma restauração de vez em quando. Nada de backup acontece automaticamente na sua própria instância.

Sim. Fotos e documentos vão para o volume local por padrão, e apontar FILESYSTEM_DISK para qualquer bucket compatível com S3 os move para lá. Os arquivos continuam sendo servidos por rotas que verificam a conta, nunca como URLs públicas.

Sim, pelas configurações de e-mail do seu arquivo de ambiente: qualquer servidor SMTP, ou o Resend. Por padrão o e-mail vai para o arquivo de log, então configure isso antes de convidar alguém.

A licença MIT permite qualquer alteração que você quiser. A ressalva prática é que uma instância muito modificada fica mais difícil de atualizar, então contribuir a mudança para o projeto costuma ser o melhor negócio.

Suporte da comunidade, pelas issues e discussions do GitHub. Não há contrato de suporte pago para comprar, e essa é a diferença honesta entre rodar você mesmo e deixar alguém rodar por você.

Sim, uma API JSON que espelha a aplicação web: as mesmas ações e as mesmas regras, cerca de cento e cinquenta endpoints, com a referência publicada em /docs/api de cada instância.

Com um token de acesso pessoal enviado como token Bearer no cabeçalho Authorization, por HTTPS. Você também pode trocar e-mail e senha por um token no endpoint de login.

Sim, nas configurações do seu perfil, e você pode revogar qualquer uma delas individualmente. Uma chave carrega exatamente as permissões do seu papel e hoje não tem escopos nem data de validade. Você recebe um e-mail sempre que uma chave é criada ou destruída.

Coleções e seus tipos, campos personalizados e grupos, objetos, cópias, fotos, etiquetas, categorias, sets, séries, locais, condições, documentos, transações, avaliações, seguros, manutenções, procedência, histórico de locais, empréstimos, a lixeira, a busca, as estatísticas, os membros e os convites. Leitura e escrita, conforme o seu papel.

Sim: 60 requisições por minuto depois de autenticado e 6 por minuto no login e no cadastro, para frear tentativas.

Pela metade, e vale saber qual metade. Você pode registrar endpoints e cada um recebe o próprio segredo de assinatura, mas nenhum evento da aplicação dispara um webhook ainda. A mecânica de entrega está pronta, esperando os eventos serem ligados.

Sim. Tudo o que a interface faz, a API faz, então importar um catálogo por script ou exportá-lo de forma agendada é perfeitamente possível hoje.

Ela é escrita ao lado do código, no repositório, e renderizada na referência que você lê em /docs/api, com uma versão em Markdown de cada seção. Um teste quebra o build quando um endpoint não tem documentação, e é isso que mantém os dois juntos.

Por favor. Relatos de bugs, ideias de recursos, traduções, documentação e pull requests são bem-vindos, e as issues marcadas como “good first issue” são um bom ponto de partida.

Nas issues do projeto no GitHub, ou nas discussions se for mais uma conversa do que um bug. Problemas de segurança são a exceção: esses, por e-mail privado.

Não. Ele registra o que você conta a ele. Não tem como confirmar que um objeto é genuíno e nunca finge o contrário.

Não. Ele guarda as avaliações que você ou um profissional informam, com uma indicação de quanta confiança aquele número merece. Ele não consulta preços de mercado nem gera um valor próprio.

Não. É uma ferramenta de registro, e os termos de uso dizem isso. Decisões sobre cobertura, impostos e venda são do profissional adequado.

Não. Um registro bem mantido com recibos, fotos e procedência é uma evidência de apoio útil, mas não é título de propriedade, e qualquer pessoa com acesso à conta pode escrever o que quiser nele.

Para um colecionador particular ou um grupo pequeno, muitas vezes sim. Para normas de acervo, fluxos de conservação ou relatórios obrigatórios, não, e você não deveria contar com isso.

Ela é guardada fielmente, erro e tudo. Cada objeto mantém um histórico do que mudou e de quem mudou, então dá para achar o erro e corrigi-lo.

A lista honesta: sem exportação e importação de objetos ou coleções, visibilidade por coleção que é salva mas não aplicada, webhooks que nunca disparam, sem aplicativo móvel nativo, sem login único nem gerenciamento de sessões, estatísticas por coleção em vez da conta inteira, e uma conta por pessoa. A página de status de recursos da documentação mantém essa lista em dia.

Não há roadmap com datas, e isso é proposital. As issues abertas no GitHub mostram o que está em andamento, e a página de status de recursos da documentação diz o que está pronto e o que não está.

Pela seção de suporte dentro da aplicação, quando a instância a mantém ligada. Fora isso, as issues e discussions do GitHub são o lugar, e uma pessoa lê tudo.

Escreva ao mantenedor em particular em vez de abrir uma issue pública, para que uma falha possa ser corrigida antes de ser descrita publicamente. Relatos de boa-fé são bem-vindos e tratados antes de tudo.