Sistema web para gestão, validação e digitalização de documentos PDF com uso de metadados.
Atuei na continuidade deste projeto durante meu estágio no CAMPS Santos:
- Documentação da API REST (
docs/API.md): mapeei todos os endpoints dos três blueprints (auth, documents, analytics), documentando métodos HTTP, parâmetros, formatos de request/response e códigos de erro. - Correção de segurança no
.env.example: identifiquei e removi credenciais reais expostas publicamente no repositório, substituindo por placeholders documentados.
Esta versão no meu GitHub representa minha documentação pessoal e estudo prático da aplicação.
O CAMPS PDF Manager é uma solução robusta para digitalização e gestão de documentos, projetada para garantir a validade jurídica e a integridade de arquivos digitais. A versão 2.0 introduz uma arquitetura modular moderna e conformidade total com os requisitos técnicos da legislação brasileira para digitalização de documentos.
- Gestão de Documentos: Upload, listagem, visualização e download de PDFs.
- Conformidade Legal (FASE 1): Coleta e validação de metadados obrigatórios (Digitalizador, CPF/CNPJ, Resolução DPI, etc.).
- Assinatura Digital: Integração para assinatura eletrônica de documentos.
- Processamento em Lote: Atualização de metadados e exclusão de múltiplos arquivos simultaneamente.
- Analytics: Dashboard interativo com estatísticas de uso e status de assinaturas.
- Controle de Acesso: Sistema de autenticação JWT com níveis de permissão (Admin, User, Viewer).
O projeto adota uma arquitetura moderna e desacoplada:
- API RESTful: Endpoints seguros e documentados.
- SQLAlchemy: ORM para gestão eficiente do banco de dados.
- JWT Auth: Autenticação segura e stateless.
- Services: Camada de serviços para lógica de negócios complexa (PDF manipulation, Batch processing).
O frontend foi completamente reestruturado para modularidade e manutenibilidade:
frontend/js/
├── core/ # Núcleo (API Client, Auth Manager)
├── modules/ # Módulos funcionais independentes
│ ├── dashboard.js
│ ├── documents.js
│ ├── upload.js # Com integração FASE 1
│ ├── batch.js
│ └── users.js
├── components/ # Componentes reutilizáveis (Charts, Modals)
├── fase1/ # Lógica de conformidade legal (Validators, Metadata)
└── utils/ # Utilitários (Formatters, Toast)
- Python 3.8+
- Pip (Gerenciador de pacotes Python)
- Navegador moderno (Chrome, Firefox, Edge)
-
Clone o repositório
git clone https://github.com/seu-org/camps-pdf-manager-v2.git cd camps-pdf-manager-v2 -
Configure o Backend
cd backend python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt
-
Variáveis de Ambiente Crie um arquivo
.envna pastabackendcom base no.env.example:FLASK_APP=run.py FLASK_ENV=development SECRET_KEY=sua_chave_secreta_segura DATABASE_URL=sqlite:///camps_manager.db
-
Inicialize o Banco de Dados
flask db upgrade
-
Execute a Aplicação
python run.py
O servidor iniciará em
http://localhost:5000.
Ao fazer upload de um arquivo, o sistema solicitará automaticamente os metadados exigidos pelo Decreto 10.278/2020:
- Autor/Digitalizador: Nome do responsável.
- CPF/CNPJ: Identificação do responsável (validado automaticamente).
- Resolução: DPI da digitalização (mínimo 150 DPI).
Selecione múltiplos documentos na lista para realizar ações em massa:
- Atualizar Metadados: Defina autor, assunto ou tipo para vários arquivos de uma vez.
- Excluir: Remova múltiplos arquivos com segurança.
Acompanhe métricas em tempo real:
- Timeline de uploads.
- Distribuição por tipo de documento.
- Status de assinaturas (Assinado vs. Pendente).
- Faça um Fork do projeto.
- Crie uma Branch para sua Feature (
git checkout -b feature/NovaFeature). - Commit suas mudanças (
git commit -m 'Add: Nova Feature'). - Push para a Branch (
git push origin feature/NovaFeature). - Abra um Pull Request.
Este projeto está sob a licença MIT.
Desenvolvido por Equipe CAMPS Santos