Requer alguma montagem. Mas não muita.
Seu próprio app de coleção. Nos seus termos.
O KolleK é um app de coleção completo que você pode rodar na infraestrutura que escolher. Comece com o Docker Compose, mantenha as partes compreensíveis e preserve um caminho claro para atualizações e backups.
Passo 1 · Clonar
Cloning into 'kollek'... done.
Passo 2 · Configurar
Set APP_KEY, DB_PASSWORD in .env
Passo 3 · Definir a chave do app
Application key set.
Passo 4 · Subir
Started app, queue, scheduler, mysql · migrations ran on boot
Quatro comandos, de um diretório vazio a uma instância rodando. O último é “docker compose up”, não um ato de fé.
Um caminho curto do nada ao funcionando
O caminho com suporte é o Docker.
Suba o app web, o worker de fila, o agendador, o banco de dados e o armazenamento com uma configuração documentada, em vez de montar uma stack a partir de fóruns e otimismo.
Clonar o repositório
git clone …/kollek
Baixe o código-fonte e a stack Compose que vem com ele.
Configure seu .env
cp .env.docker.example .env
Copie o env de exemplo e depois defina sua chave de app e a senha do banco.
Subir o Compose
docker compose up -d
Quatro contêineres sobem juntos: app, queue, scheduler e MySQL.
Está rodando
http://localhost:8000
As migrações rodam na inicialização. Abra o app no navegador.
Pequeno o suficiente para entender
Cinco partes. Esse é todo o elenco.
O KolleK usa um papel web, um papel de fila, um papel de agendador, MySQL e armazenamento durável. Cada parte tem uma função e cada uma está descrita na documentação.
Aplicação
Serve o app via nginx e PHP-FPM e roda as migrações do banco na inicialização.
Processa tarefas em segundo plano nas filas high, default e low.
Executa o agendador do artisan: tarefas recorrentes de limpeza e manutenção.
Estado e armazenamento
Atualize sem prender a respiração
Seus volumes de dados sobrevivem à troca.
As atualizações preservam os volumes de dados que guardam o banco e os arquivos enviados. Siga o caminho de atualização documentado, rode as migrações e siga em frente.
Baixar a nova imagem
docker compose pull
Faça backup primeiro
docker compose exec mysql mysqldump kollek > db.sql
Recriar os contêineres
docker compose up -d
Migrações na inicialização
php artisan migrate --force
Backups fazem parte do combinado
Três coisas, salvas juntas.
Um backup confiável inclui o banco de dados, os arquivos enviados e a chave da aplicação. Não é glamouroso. Vale muito a pena.
Cada item, coleção, avaliação e entrada de histórico. Um mysqldump ou um snapshot de volume funcionam igual.
Fotos, documentos e anexos. Restaurar um banco sem eles deixa referências quebradas.
O KolleK criptografa os dados em repouso, então sem esta chave os valores criptografados não podem ser lidos de volta. Fácil de esquecer, doloroso de perder.
Pronto para rodar você mesmo?
Um único caminho documentado cobre instalação, atualização e backup. Comece com o Docker Compose e mantenha cada parte à vista.
O KolleK pode (ainda) não ser para você se…
Você quer um serviço hospedado sem manutenção e nunca ver o Docker.
Você precisa de uma plataforma de deploy que tome cada decisão operacional por você.
Escolha o KolleK quando…
Você quer um caminho documentado e com suporte para rodar o app completo na infraestrutura que escolher.
Um servidor pequeno, Docker Compose e um modelo operacional claro soam como boas notícias.
Atualizaremos esta página quando o produto mudar. A página de status dos recursos tem os detalhes chatos, mas importantes.