Canivete da Mata 🪓

Ferramenta web offline, leve e rápida para processamento de imagens e PDFs.
Construída em Go. O contêiner inclui librsvg para SVG e poppler-utils para rasterização de PDF.

---

🌍 Documentação por Idioma

Idioma	Link
🇧🇷 Português	README_pt.md
🇺🇸 English	README_en.md
🇪🇸 Español	README_es.md
🇫🇷 Français	README_fr.md
🇩🇪 Deutsch	README_de.md
🇷🇺 Русский	README_ru.md
🇨🇳 中文	README_zh.md

---

✨ Funcionalidades

Categoria	Ferramentas
🖼️ Imagem	Remover fundo, recorte interativo, redimensionar, converter (PNG/JPG/BMP), comprimir
🎨 Cores	Extrair paleta de cores (HEX)
📄 PDF	Imagens → PDF, juntar PDFs, dividir PDF, otimizar, proteger com senha
🔁 Conversão	PDF → Imagens, SVG → PNG
📱 QR Code	Gerar e decodificar QR Codes e códigos de barras

---

⚙️ Configuração (Variáveis de Ambiente)

O sistema pode ser customizado através das seguintes variáveis de ambiente:

Variável	Padrão	Descrição
PORT	7001	Porta em que o servidor web irá rodar.
MAX_CONCURRENT_JOBS	100	Limite de processamentos simultâneos (Rate Limiter) para evitar sobrecarga do servidor.

---

🚀 Deploy Rápido

Docker (linha de comando)

docker run -d \
  --name canivete-da-mata \
  -p 7001:7001 \
  --restart unless-stopped \
  ghcr.io/facrf/canivete:latest

Acesse em: http://localhost:7001

Docker Compose / Portainer Stack

Consulte o arquivo docker-compose.yml — compatível com Portainer.

No Portainer:

1. Stacks → Add Stack → Web editor
2. Cole o conteúdo de docker-compose.yml
3. Clique em Deploy the stack

Build local (a partir do código-fonte)

git clone http://192.168.0.10:3010/facrf/canivete.git
cd canivete
docker build -t canivete-da-mata:latest .
docker run -d -p 7001:7001 --name canivete-da-mata canivete-da-mata:latest

---

Raspberry Pi 400: exec ./canivete: exec format error

Esse erro indica que o executável não é compatível com a arquitetura do sistema. O build usa a plataforma de destino do Docker BuildKit, sem fixar amd64.

Confira o sistema instalado (um Pi 400 também pode usar um sistema de 32 bits):

uname -m
getconf LONG_BIT
docker info --format '{{.Architecture}}'

Com sistema de 64 bits (aarch64, 64 e Docker aarch64/arm64), compile uma imagem local com uma tag própria:

docker buildx build --platform linux/arm64 --load -t canivete-da-mata:arm64 .
docker run -d --name canivete-pi400 -p 7001:7001 canivete-da-mata:arm64

Em sistemas ARM de 32 bits, use --platform linux/arm/v7 e uma tag canivete-da-mata:armv7 em ambos os comandos. Se o comando buildx não existir, instale o plugin Docker Buildx. Não sobrescreva TARGETARCH com --build-arg: deixe o Docker selecionar a arquitetura.

Para Portainer, publique a correção no GHCR antes de atualizar a stack. Depois, habilite a opção de baixar a imagem novamente ao recriar o serviço. Para usar o build local, altere image: para canivete-da-mata:arm64 na stack. Uma imagem antiga em cache ainda pode conter o executável incompatível.

Sem Docker, confira o executável com file ./canivete. Para gerar um binário ARM64 a partir do código, use:

CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o canivete-linux-arm64 .

---

🏗️ Arquiteturas suportadas (Docker)

A imagem no GHCR é publicada para múltiplas arquiteturas automaticamente via GitHub Actions:

Plataforma	Hardware
linux/amd64	Servidores x86_64, PCs, VMs
linux/arm64	Raspberry Pi 4/400/5 (64-bit), Apple Silicon (M1/M2/M3)
linux/arm/v7	Raspberry Pi 2/3/4/400 (32-bit), Orange Pi
linux/riscv64	VisionFive 2, StarFive, Milk-V Mars

---

🔒 Segurança

• Sem banco de dados — imune a SQL Injection
• Templates Go com escaping automático de HTML/XSS
• Upload limitado com http.MaxBytesReader
• Validação de dimensões (máximo de 8000px e 20 megapixels)
• Validação de argumentos antes de passar a processos externos
• Senhas de PDF exigem mínimo de 8 caracteres

Consulte SECURITY.md para reportar vulnerabilidades.

---

🧪 Testes e Qualidade de Código

O Canivete da Mata conta com uma cobertura completa de testes garantindo estabilidade e integridade:

• Detector de Corrida (Race Detector) ativo para evitar falhas de concorrência e uso paralelo na memória.
• Suíte cobrindo todos os utilitários, tratamento de imagens, limpeza de temporários e validação HTTP.
• Integração e verificação de formatação via Github Actions para assegurar a melhor performance com o Go 1.26+.

Para executar a suíte localmente (incluindo o race detector):

go test -race -count=1 ./...

---

🤝 Contribuindo

Veja CONTRIBUTING.md para instruções de como contribuir com o projeto.

---

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.