advx/INSTALL_PDF.md

Passos para ativar a funcionalidade de PDF

1. Instalar Dependências

Execute o seguinte comando para instalar todas as dependências necessárias:

npm install pdf-lib pdf-parse pdf2pic tesseract.js
npm install --save-dev @types/pdf-parse

2. Executar Migration do Banco de Dados

Execute a migration para criar a tabela de operações de PDF:

npx prisma migrate dev --name add_operacoes_pdf

Ou simplesmente:

npm run prisma:migrate

3. Gerar Cliente Prisma

Gere o cliente Prisma atualizado:

npm run prisma:generate

4. Criar Diretórios

Os diretórios serão criados automaticamente, mas você pode criá-los manualmente:

No Windows (PowerShell):

New-Item -Path "storage\temp\pdf-ops" -ItemType Directory -Force
New-Item -Path "storage\pdf-output" -ItemType Directory -Force
New-Item -Path "storage\temp\uploads" -ItemType Directory -Force

No Linux/Mac:

mkdir -p storage/temp/pdf-ops
mkdir -p storage/pdf-output
mkdir -p storage/temp/uploads

5. Reiniciar o Servidor

Após instalar as dependências e executar as migrations, reinicie o servidor:

npm run dev:full

Ou apenas o backend:

npm run server

Verificação

Após seguir todos os passos:

1. Acesse a aplicação no navegador
2. Faça login
3. Clique no item "PDFs" no menu lateral
4. Teste a funcionalidade de compressão enviando um PDF

Troubleshooting

Se continuar dando erro 404:

1. Verifique se o servidor foi reiniciado após as mudanças
2. Verifique se as dependências foram instaladas corretamente
3. Verifique os logs do servidor para erros de importação

Se der erro de módulo não encontrado:

Execute:

npm install
npm run prisma:generate

Se der erro no banco de dados:

Execute:

npx prisma migrate reset
npx prisma migrate dev
npm run prisma:generate

ATENÇÃO: O comando migrate reset apaga todos os dados do banco!