Initial commit: DocuAgro - Plataforma EUDR
This commit is contained in:
bigtux
769
docs/manual-docuagro.html
Normal file
769
docs/manual-docuagro.html
Normal file
@@ -0,0 +1,769 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="pt-BR">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<title>DocuAgro - Manual Completo</title>
|
||||
<style>
|
||||
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap');
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body { font-family: 'Inter', sans-serif; color: #1a1a2e; line-height: 1.7; background: #fff; }
|
||||
.page { page-break-after: always; min-height: 100vh; position: relative; }
|
||||
.page:last-child { page-break-after: avoid; }
|
||||
|
||||
/* CAPA */
|
||||
.capa { background: linear-gradient(135deg, #1B5E20 0%, #2E7D32 40%, #43A047 100%); color: white; display: flex; flex-direction: column; justify-content: center; align-items: center; text-align: center; padding: 60px 80px; }
|
||||
.capa h1 { font-size: 52px; font-weight: 800; margin-bottom: 8px; }
|
||||
.capa .tagline { font-size: 20px; font-weight: 300; opacity: 0.9; margin-bottom: 10px; }
|
||||
.capa .tipo-doc { font-size: 28px; font-weight: 600; background: rgba(255,255,255,0.15); padding: 14px 40px; border-radius: 12px; margin: 30px 0; }
|
||||
.capa .info { font-size: 14px; opacity: 0.7; margin-top: 30px; }
|
||||
|
||||
/* INTERNAS */
|
||||
.interna { padding: 50px 60px; }
|
||||
.header-bar { display: flex; justify-content: space-between; align-items: center; border-bottom: 3px solid #2E7D32; padding-bottom: 10px; margin-bottom: 30px; }
|
||||
.header-bar h2 { font-size: 26px; font-weight: 700; color: #1B5E20; }
|
||||
.header-bar .brand { font-size: 13px; color: #2E7D32; font-weight: 600; }
|
||||
.header-bar .pg { font-size: 12px; color: #999; }
|
||||
|
||||
h3 { font-size: 18px; font-weight: 700; color: #2E7D32; margin: 25px 0 12px; }
|
||||
h4 { font-size: 15px; font-weight: 600; color: #333; margin: 18px 0 8px; }
|
||||
p { font-size: 13.5px; color: #333; margin-bottom: 10px; }
|
||||
ul, ol { padding-left: 22px; margin: 8px 0 14px; }
|
||||
li { font-size: 13.5px; color: #333; margin-bottom: 5px; }
|
||||
|
||||
table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 12.5px; }
|
||||
thead th { background: #1B5E20; color: white; padding: 8px 12px; text-align: left; font-weight: 600; text-transform: uppercase; letter-spacing: 0.5px; font-size: 11px; }
|
||||
tbody td { padding: 8px 12px; border-bottom: 1px solid #e8e8e8; }
|
||||
tbody tr:nth-child(even) { background: #f9fdf9; }
|
||||
|
||||
.box { background: #f1f8e9; border: 1px solid #c8e6c9; border-radius: 10px; padding: 16px 22px; margin: 14px 0; }
|
||||
.box.warning { background: #fff8e1; border-color: #ffe082; }
|
||||
.box.info { background: #e3f2fd; border-color: #90caf9; }
|
||||
.box h4 { margin-top: 0; color: #1B5E20; }
|
||||
.box.warning h4 { color: #e65100; }
|
||||
.box.info h4 { color: #0d47a1; }
|
||||
|
||||
.cmd { background: #263238; color: #a5d6a7; padding: 2px 8px; border-radius: 4px; font-family: 'Courier New', monospace; font-size: 12.5px; font-weight: 600; }
|
||||
.code-block { background: #263238; color: #e0e0e0; padding: 16px 22px; border-radius: 10px; font-family: 'Courier New', monospace; font-size: 12px; line-height: 1.8; margin: 12px 0; overflow-x: auto; }
|
||||
.code-block .comment { color: #81c784; }
|
||||
|
||||
.chat { background: #f5f5f5; border-radius: 12px; padding: 16px 20px; margin: 12px 0; }
|
||||
.chat .msg { margin-bottom: 10px; font-size: 13px; }
|
||||
.chat .msg.user { padding-left: 20px; }
|
||||
.chat .msg.user::before { content: "👤 Produtor: "; font-weight: 700; color: #333; }
|
||||
.chat .msg.bot::before { content: "🤖 DocuAgro: "; font-weight: 700; color: #2E7D32; }
|
||||
.chat .msg.action { color: #666; font-style: italic; text-align: center; font-size: 12px; }
|
||||
|
||||
.step-grid { display: grid; grid-template-columns: 50px 1fr; gap: 8px 16px; margin: 14px 0; }
|
||||
.step-num { width: 36px; height: 36px; background: #2E7D32; color: white; border-radius: 50%; display: flex; align-items: center; justify-content: center; font-weight: 700; font-size: 16px; }
|
||||
.step-content { padding-top: 6px; }
|
||||
.step-content strong { color: #1B5E20; }
|
||||
|
||||
.footer { position: absolute; bottom: 25px; left: 60px; right: 60px; display: flex; justify-content: space-between; font-size: 9px; color: #bbb; border-top: 1px solid #eee; padding-top: 8px; }
|
||||
|
||||
.badge { display: inline-block; background: #e8f5e9; color: #1B5E20; padding: 3px 12px; border-radius: 15px; font-size: 11px; font-weight: 600; border: 1px solid #c8e6c9; margin: 2px; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<!-- CAPA -->
|
||||
<div class="page capa">
|
||||
<div style="font-size:72px; margin-bottom:10px;">🌱</div>
|
||||
<h1>DocuAgro</h1>
|
||||
<div class="tagline">Compliance do produtor, na palma da mão.</div>
|
||||
<div class="tipo-doc">📘 Manual Completo</div>
|
||||
<p style="max-width:500px; font-size:15px; opacity:0.85; line-height:1.6;">
|
||||
Guia completo de uso da plataforma DocuAgro para produtores rurais e cooperativas.
|
||||
Compliance EUDR via Bot Telegram + Inteligência Artificial + Painel Web.
|
||||
</p>
|
||||
<div class="info">AI Vertice • Versão 1.0 • Fevereiro 2026</div>
|
||||
</div>
|
||||
|
||||
<!-- SUMÁRIO -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>Sumário</h2>
|
||||
<span class="pg">02</span>
|
||||
</div>
|
||||
|
||||
<div style="margin-top:20px;">
|
||||
<table>
|
||||
<tbody>
|
||||
<tr><td style="width:40px; font-weight:700; color:#2E7D32;">01</td><td><strong>O que é o DocuAgro</strong></td><td style="text-align:right; color:#999;">Pág. 03</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">02</td><td><strong>Para quem é</strong></td><td style="text-align:right; color:#999;">Pág. 03</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">03</td><td><strong>Guia do Produtor — Bot Telegram</strong></td><td style="text-align:right; color:#999;">Pág. 04</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">04</td><td><strong>Exemplo Completo de Uso</strong></td><td style="text-align:right; color:#999;">Pág. 06</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">05</td><td><strong>Documentos Coletados (8)</strong></td><td style="text-align:right; color:#999;">Pág. 07</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">06</td><td><strong>Inteligência Artificial</strong></td><td style="text-align:right; color:#999;">Pág. 08</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">07</td><td><strong>Guia da Cooperativa — Painel Web</strong></td><td style="text-align:right; color:#999;">Pág. 09</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">08</td><td><strong>API REST</strong></td><td style="text-align:right; color:#999;">Pág. 10</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">09</td><td><strong>Dossiê PDF</strong></td><td style="text-align:right; color:#999;">Pág. 11</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">10</td><td><strong>Instalação e Configuração</strong></td><td style="text-align:right; color:#999;">Pág. 12</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">11</td><td><strong>Arquitetura Técnica</strong></td><td style="text-align:right; color:#999;">Pág. 13</td></tr>
|
||||
<tr><td style="font-weight:700; color:#2E7D32;">12</td><td><strong>FAQ e Troubleshooting</strong></td><td style="text-align:right; color:#999;">Pág. 14</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 2</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 3 — O QUE É + PARA QUEM -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>1. O que é o DocuAgro</h2>
|
||||
<span class="pg">03</span>
|
||||
</div>
|
||||
|
||||
<p>O <strong>DocuAgro</strong> é uma plataforma que automatiza a coleta, validação e organização de documentação de produtores rurais para compliance com o <strong>EUDR</strong> (Regulamento da União Europeia contra Desmatamento — EU 2023/1115).</p>
|
||||
|
||||
<p>A plataforma combina três componentes:</p>
|
||||
<ul>
|
||||
<li><strong>Bot Telegram</strong> — onde o produtor envia seus documentos via conversa</li>
|
||||
<li><strong>Inteligência Artificial</strong> — que guia, orienta e valida os documentos</li>
|
||||
<li><strong>Painel Web</strong> — onde a cooperativa acompanha o progresso de todos os produtores</li>
|
||||
</ul>
|
||||
|
||||
<div class="box">
|
||||
<h4>🇪🇺 O que é o EUDR?</h4>
|
||||
<p>O Regulamento (UE) 2023/1115 proíbe a importação na UE de commodities produzidas em áreas desmatadas após 31/12/2020. Afeta: <strong>Soja, Café, Cacau, Óleo de Palma, Madeira, Gado e Borracha</strong>. Produtores brasileiros que exportam precisam comprovar geolocalização, ausência de desmatamento e conformidade ambiental.</p>
|
||||
</div>
|
||||
|
||||
<h2 style="font-size:22px; color:#1B5E20; margin-top:30px; padding-top:20px; border-top:2px solid #e0e0e0;">2. Para quem é</h2>
|
||||
|
||||
<h3>👨🌾 Produtores Rurais</h3>
|
||||
<p>Qualquer produtor que cultive commodities afetadas pelo EUDR e exporte (direta ou indiretamente via cooperativa/trading) para a Europa. O produtor interage <strong>100% pelo Telegram</strong>, sem precisar instalar nenhum aplicativo novo.</p>
|
||||
|
||||
<h3>🏢 Cooperativas e Tradings</h3>
|
||||
<p>Organizações que precisam comprovar a conformidade de dezenas a milhares de produtores associados. Acompanham tudo pelo <strong>Painel Web</strong> com dashboard, busca, dossiês e exportação CSV.</p>
|
||||
|
||||
<h3>🎯 Mercado-Alvo</h3>
|
||||
<ul>
|
||||
<li><strong>Soja:</strong> Cooperativas do MT, PR, GO (ex: Coamo, C.Vale, Cocamar)</li>
|
||||
<li><strong>Café:</strong> Cooperativas de MG, SP, ES (ex: COOXUPÉ)</li>
|
||||
<li><strong>Gado:</strong> Frigoríficos e associações pecuárias</li>
|
||||
<li><strong>Cacau:</strong> Cooperativas da Bahia e Pará</li>
|
||||
<li><strong>Madeira:</strong> Setor florestal</li>
|
||||
</ul>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 3</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 4 — GUIA DO PRODUTOR -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>3. Guia do Produtor — Bot Telegram</h2>
|
||||
<span class="pg">04</span>
|
||||
</div>
|
||||
|
||||
<p>O produtor acessa o DocuAgro pelo Telegram, buscando por <strong>@docuagro_bot</strong>. Todo o processo é guiado por inteligência artificial em linguagem simples.</p>
|
||||
|
||||
<h3>📱 Comandos Disponíveis</h3>
|
||||
<table>
|
||||
<thead><tr><th>Comando</th><th>Função</th><th>Quando usar</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td><span class="cmd">/start</span></td><td>Iniciar cadastro</td><td>Primeira vez no bot</td></tr>
|
||||
<tr><td><span class="cmd">/status</span></td><td>Ver progresso</td><td>A qualquer momento</td></tr>
|
||||
<tr><td><span class="cmd">/dossie</span></td><td>Gerar dossiê PDF</td><td>Após enviar documentos</td></tr>
|
||||
<tr><td><span class="cmd">/pular</span></td><td>Pular documento</td><td>Se não tem o doc agora</td></tr>
|
||||
<tr><td><span class="cmd">/ajuda</span></td><td>Menu de ajuda</td><td>Se tiver dúvidas</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>🔄 Fluxo Completo — Passo a Passo</h3>
|
||||
|
||||
<h4>Etapa 1: Cadastro (Onboarding)</h4>
|
||||
<p>Ao enviar <span class="cmd">/start</span>, a IA faz perguntas simples para conhecer o produtor:</p>
|
||||
|
||||
<div class="step-grid">
|
||||
<div><div class="step-num">1</div></div>
|
||||
<div class="step-content"><strong>Nome completo</strong> — "Qual é o seu nome completo?"</div>
|
||||
<div><div class="step-num">2</div></div>
|
||||
<div class="step-content"><strong>CPF</strong> — Para identificação no sistema</div>
|
||||
<div><div class="step-num">3</div></div>
|
||||
<div class="step-content"><strong>Nome da propriedade</strong> — Ex: "Fazenda Boa Vista"</div>
|
||||
<div><div class="step-num">4</div></div>
|
||||
<div class="step-content"><strong>Município e estado</strong> — Ex: "Sorriso, MT"</div>
|
||||
<div><div class="step-num">5</div></div>
|
||||
<div class="step-content"><strong>Área em hectares</strong> — Aproximado é suficiente</div>
|
||||
<div><div class="step-num">6</div></div>
|
||||
<div class="step-content"><strong>Cultura principal</strong> — Soja, café, gado, etc.</div>
|
||||
</div>
|
||||
|
||||
<h4>Etapa 2: Coleta de Documentos</h4>
|
||||
<p>Após o cadastro, a IA pede <strong>um documento por vez</strong>, na seguinte ordem:</p>
|
||||
<ol>
|
||||
<li>CAR (Cadastro Ambiental Rural)</li>
|
||||
<li>CCIR (Certificado de Cadastro de Imóvel Rural)</li>
|
||||
<li>ITR (Imposto Territorial Rural)</li>
|
||||
<li>Georreferenciamento (coordenadas da propriedade)</li>
|
||||
<li>Licença Ambiental</li>
|
||||
<li>Contrato de Arrendamento (se aplicável)</li>
|
||||
<li>Nota Fiscal de Venda</li>
|
||||
<li>Declaração de Não Desmatamento (gerada automaticamente)</li>
|
||||
</ol>
|
||||
|
||||
<div class="box">
|
||||
<h4>📸 Dicas para enviar documentos</h4>
|
||||
<ul>
|
||||
<li>Tire foto em lugar com <strong>boa iluminação</strong></li>
|
||||
<li>Enquadre o <strong>documento inteiro</strong> na foto</li>
|
||||
<li><strong>PDF é melhor</strong> que foto (mais legível)</li>
|
||||
<li>Envie <strong>um documento por vez</strong></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<h4>Etapa 3: Dossiê</h4>
|
||||
<p>Quando todos os documentos forem enviados, o produtor pode gerar o dossiê com <span class="cmd">/dossie</span>. O bot gera um PDF profissional e envia direto no chat.</p>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 4</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 5 — STATUS E NAVEGAÇÃO -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>3. Guia do Produtor (continuação)</h2>
|
||||
<span class="pg">05</span>
|
||||
</div>
|
||||
|
||||
<h3>📊 Verificando o Status</h3>
|
||||
<p>A qualquer momento, o produtor pode enviar <span class="cmd">/status</span> para ver como está sua documentação:</p>
|
||||
|
||||
<div class="chat">
|
||||
<div class="msg bot">📊 <strong>Status da sua documentação</strong><br><br>
|
||||
👤 João da Silva<br>
|
||||
🏡 Fazenda Boa Vista<br><br>
|
||||
✅ CAR (Cadastro Ambiental Rural)<br>
|
||||
✅ CCIR (Certificado do INCRA)<br>
|
||||
🟡 ITR (Imposto Territorial Rural)<br>
|
||||
⬜ Georreferenciamento<br>
|
||||
⬜ Licença Ambiental<br>
|
||||
⬜ Contrato de Arrendamento<br>
|
||||
⬜ Nota Fiscal de Venda<br>
|
||||
⬜ Declaração de Não Desmatamento<br><br>
|
||||
📈 Progresso: 2/8
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p><strong>Legenda dos ícones:</strong></p>
|
||||
<table>
|
||||
<thead><tr><th>Ícone</th><th>Significado</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td>✅</td><td>Documento aprovado</td></tr>
|
||||
<tr><td>🟡</td><td>Enviado, em análise</td></tr>
|
||||
<tr><td>❌</td><td>Rejeitado (precisa reenviar)</td></tr>
|
||||
<tr><td>⚠️</td><td>Vencido</td></tr>
|
||||
<tr><td>⬜</td><td>Não enviado ainda</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>⏭️ Pulando um Documento</h3>
|
||||
<p>Se o produtor não tem um documento no momento, pode usar <span class="cmd">/pular</span> para ir ao próximo. Ele poderá enviar o documento pulado depois.</p>
|
||||
|
||||
<div class="chat">
|
||||
<div class="msg user">/pular</div>
|
||||
<div class="msg bot">⏭️ Pulei o Georreferenciamento da Propriedade. Pode enviar depois! Agora vamos pra Licença Ambiental...</div>
|
||||
</div>
|
||||
|
||||
<h3>❓ Pedindo Ajuda</h3>
|
||||
<p>O comando <span class="cmd">/ajuda</span> mostra todos os comandos disponíveis e dicas de envio. Além disso, o produtor pode <strong>fazer qualquer pergunta em texto</strong> e a IA responderá com orientações sobre o que é cada documento e onde obtê-lo.</p>
|
||||
|
||||
<div class="chat">
|
||||
<div class="msg user">O que é o CAR?</div>
|
||||
<div class="msg bot">O CAR é o Cadastro Ambiental Rural. É feito pelo site car.gov.br. Se você já tem, é só me mandar o número do recibo ou o PDF. Se não tem, procure o escritório do meio ambiente do seu município que eles ajudam a fazer. 👍</div>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 5</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 6 — EXEMPLO COMPLETO -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>4. Exemplo Completo de Uso</h2>
|
||||
<span class="pg">06</span>
|
||||
</div>
|
||||
|
||||
<p>Veja abaixo uma conversa típica entre um produtor e o DocuAgro:</p>
|
||||
|
||||
<div class="chat">
|
||||
<div class="msg user">/start</div>
|
||||
<div class="msg bot">🌱 <strong>Bem-vindo ao DocuAgro!</strong><br><br>Oi! Eu sou o DocuAgro, seu assistente para organizar a documentação da sua propriedade rural.<br><br>📋 A União Europeia criou uma nova regra (EUDR) que exige comprovação de que a produção não vem de área desmatada. Sem essa documentação, pode ter problema na hora de vender.<br><br>São 8 documentos no total. Vamos começar?<br><br>Primeiro, me conta: <strong>qual é o seu nome completo?</strong></div>
|
||||
<div class="msg user">João da Silva Ferreira</div>
|
||||
<div class="msg bot">Beleza, João! 👍 Agora me passa seu <strong>CPF</strong> (é só pra identificação no sistema).</div>
|
||||
<div class="msg user">123.456.789-00</div>
|
||||
<div class="msg bot">Certinho! Qual o <strong>nome da sua propriedade</strong>?</div>
|
||||
<div class="msg user">Fazenda Boa Vista</div>
|
||||
<div class="msg bot">Boa! Em qual <strong>município e estado</strong> fica a Fazenda Boa Vista?</div>
|
||||
<div class="msg user">Sorriso, Mato Grosso</div>
|
||||
<div class="msg bot">Sorriso, MT — anotado! Qual a <strong>área aproximada em hectares</strong>?</div>
|
||||
<div class="msg user">500 hectares</div>
|
||||
<div class="msg bot">500 ha, tá ótimo! E qual a <strong>cultura principal</strong>? (soja, café, gado...)</div>
|
||||
<div class="msg user">Soja</div>
|
||||
<div class="msg bot">Perfeito, João! Tudo anotado. Agora vamos pros documentos. 📄<br><br>O primeiro é o <strong>CAR — Cadastro Ambiental Rural</strong>. É aquele registro do SICAR (car.gov.br). Se você já tem, manda a foto ou o PDF pra mim. Se não tem, me avisa que eu explico como fazer!</div>
|
||||
<div class="msg action">[ João envia foto do CAR ]</div>
|
||||
<div class="msg bot">✅ Recebi seu CAR! Tá sendo analisado, já te aviso o resultado. 📝 Número SICAR encontrado: MT-5107248-ABC123...<br><br>Agora vamos pro próximo: o <strong>CCIR</strong> (Certificado de Cadastro de Imóvel Rural do INCRA)...</div>
|
||||
</div>
|
||||
|
||||
<div class="box info">
|
||||
<h4>💡 Observações</h4>
|
||||
<ul>
|
||||
<li>A IA extrai dados automaticamente via <strong>OCR</strong> (número do CAR, código INCRA, CPF, datas, etc.)</li>
|
||||
<li>Se a foto estiver ilegível, o bot pede para <strong>reenviar</strong> com dicas práticas</li>
|
||||
<li>O processo completo leva em média <strong>15-30 minutos</strong> se o produtor tiver todos os documentos em mãos</li>
|
||||
<li>O produtor pode parar a qualquer momento e <strong>continuar depois</strong> — o progresso é salvo</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 6</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 7 — DOCUMENTOS -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>5. Documentos Coletados</h2>
|
||||
<span class="pg">07</span>
|
||||
</div>
|
||||
|
||||
<p>O DocuAgro coleta e valida <strong>8 documentos obrigatórios</strong> para compliance EUDR:</p>
|
||||
|
||||
<table>
|
||||
<thead><tr><th>#</th><th>Documento</th><th>O que é</th><th>Onde obter</th><th>Validação OCR</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td>1</td><td><strong>CAR</strong></td><td>Cadastro Ambiental Rural</td><td>car.gov.br (SICAR)</td><td>Número SICAR</td></tr>
|
||||
<tr><td>2</td><td><strong>CCIR</strong></td><td>Certificado Imóvel Rural</td><td>sncr.serpro.gov.br (INCRA)</td><td>Código INCRA</td></tr>
|
||||
<tr><td>3</td><td><strong>ITR</strong></td><td>Imposto Territorial Rural</td><td>Receita Federal</td><td>CPF/CNPJ</td></tr>
|
||||
<tr><td>4</td><td><strong>Geo</strong></td><td>Georreferenciamento</td><td>Técnico agrimensor</td><td>Coordenadas GPS</td></tr>
|
||||
<tr><td>5</td><td><strong>Licença</strong></td><td>Licença Ambiental</td><td>Órgão estadual (SEMA/IMA)</td><td>Validade + OCR</td></tr>
|
||||
<tr><td>6</td><td><strong>Contrato</strong></td><td>Contrato de Arrendamento</td><td>Cartório (se não for dono)</td><td>OCR geral</td></tr>
|
||||
<tr><td>7</td><td><strong>NF</strong></td><td>Nota Fiscal de Venda</td><td>Última NF-e ou NF produtor</td><td>CPF/CNPJ + dados</td></tr>
|
||||
<tr><td>8</td><td><strong>Declaração</strong></td><td>Não Desmatamento</td><td>Gerada automaticamente</td><td>Automática ✅</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>🔍 Como a Validação Funciona</h3>
|
||||
<p>Cada documento enviado passa por um pipeline de validação:</p>
|
||||
|
||||
<ol>
|
||||
<li><strong>Recebimento:</strong> Arquivo salvo em diretório isolado do produtor</li>
|
||||
<li><strong>OCR (Tesseract.js):</strong> Extração de texto em português com análise de confiança</li>
|
||||
<li><strong>Validação por tipo:</strong> Algoritmo específico busca campos-chave:
|
||||
<ul>
|
||||
<li>CAR → procura padrão do número SICAR (XX-XXXXXXX-XXXX...)</li>
|
||||
<li>CCIR → procura menção ao INCRA + código do imóvel</li>
|
||||
<li>ITR → procura "Receita Federal" ou "ITR" + CPF/CNPJ</li>
|
||||
<li>Georreferenciamento → extrai coordenadas geográficas</li>
|
||||
<li>Licença → busca "Licença" + datas de validade</li>
|
||||
<li>NF → procura "Nota Fiscal" / "DANFE" + CPF/CNPJ</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><strong>Resultado:</strong> Aprovado ✅, Em análise 🟡, ou Reenviar ❌</li>
|
||||
<li><strong>Dados extraídos:</strong> Salvos no banco para inclusão no dossiê</li>
|
||||
</ol>
|
||||
|
||||
<div class="box warning">
|
||||
<h4>⚠️ Documento 6 — Contrato de Arrendamento</h4>
|
||||
<p>Este documento só é necessário se o produtor <strong>não for proprietário</strong> da terra. Se for dono, pode usar <span class="cmd">/pular</span> para ir ao próximo.</p>
|
||||
</div>
|
||||
|
||||
<div class="box">
|
||||
<h4>✨ Documento 8 — Declaração de Não Desmatamento</h4>
|
||||
<p>Este documento é <strong>gerado automaticamente</strong> pelo sistema. O produtor não precisa providenciar — o DocuAgro cria a autodeclaração com base nos dados cadastrados.</p>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 7</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 8 — IA -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>6. Inteligência Artificial</h2>
|
||||
<span class="pg">08</span>
|
||||
</div>
|
||||
|
||||
<p>O DocuAgro utiliza o modelo <strong>GPT-4o-mini</strong> da OpenAI, configurado como um especialista em documentação agrícola brasileira e compliance EUDR.</p>
|
||||
|
||||
<h3>🧠 Como a IA funciona</h3>
|
||||
|
||||
<h4>Personalidade</h4>
|
||||
<ul>
|
||||
<li>Fala de forma <strong>simples e direta</strong>, como se conversasse com um produtor rural</li>
|
||||
<li>Usa linguagem do campo: "tá certinho", "beleza", "vamos lá"</li>
|
||||
<li>É <strong>paciente</strong> — muitos produtores não estão acostumados com tecnologia</li>
|
||||
<li>Sempre <strong>encoraja</strong>: "tá quase lá!", "mais um pouquinho e fica pronto"</li>
|
||||
<li>Respostas curtas (máx. 3-4 parágrafos)</li>
|
||||
</ul>
|
||||
|
||||
<h4>Contexto Dinâmico</h4>
|
||||
<p>A cada mensagem, a IA recebe o contexto completo do produtor:</p>
|
||||
<ul>
|
||||
<li>Dados pessoais (nome, CPF, propriedade, município)</li>
|
||||
<li>Etapa atual do processo</li>
|
||||
<li>Documentos já enviados e seus status</li>
|
||||
<li>Próximo documento esperado</li>
|
||||
<li>Histórico das últimas 10 mensagens</li>
|
||||
</ul>
|
||||
|
||||
<h4>Extração Inteligente de Dados</h4>
|
||||
<p>Durante o onboarding, a IA usa uma segunda chamada ao GPT para <strong>extrair dados estruturados</strong> das mensagens do produtor (nome, CPF, município, etc.) e salvar automaticamente no banco.</p>
|
||||
|
||||
<h4>Orientação para Obter Documentos</h4>
|
||||
<p>A IA sabe orientar o produtor sobre <strong>como e onde obter</strong> cada documento:</p>
|
||||
|
||||
<div class="chat">
|
||||
<div class="msg user">Não tenho o CCIR, como faço?</div>
|
||||
<div class="msg bot">O CCIR sai pelo site do INCRA (sncr.serpro.gov.br). Se sua propriedade já tá cadastrada, é só imprimir. Senão, precisa ir no INCRA mais perto. Quer que eu explique o passo a passo? 😊</div>
|
||||
</div>
|
||||
|
||||
<h3>🔧 Configuração Técnica</h3>
|
||||
<table>
|
||||
<thead><tr><th>Parâmetro</th><th>Valor</th><th>Motivo</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td>Modelo</td><td>gpt-4o-mini</td><td>Custo baixo, boa qualidade</td></tr>
|
||||
<tr><td>Temperature</td><td>0.7</td><td>Respostas naturais mas consistentes</td></tr>
|
||||
<tr><td>Max tokens</td><td>800</td><td>Respostas curtas e diretas</td></tr>
|
||||
<tr><td>Presence penalty</td><td>0.1</td><td>Evita repetição</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 8</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 9 — PAINEL COOPERATIVA -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>7. Guia da Cooperativa — Painel Web</h2>
|
||||
<span class="pg">09</span>
|
||||
</div>
|
||||
|
||||
<p>A cooperativa ou trading acompanha todos os produtores pelo <strong>Painel Web</strong>, acessível de qualquer navegador.</p>
|
||||
|
||||
<h3>📊 Dashboard</h3>
|
||||
<p>A tela inicial mostra 5 indicadores em tempo real:</p>
|
||||
<table>
|
||||
<thead><tr><th>Indicador</th><th>Descrição</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td>👥 Total de Produtores</td><td>Quantos produtores estão cadastrados</td></tr>
|
||||
<tr><td>✅ Completos</td><td>Produtores com todos os docs aprovados</td></tr>
|
||||
<tr><td>📋 Em Andamento</td><td>Produtores enviando documentos</td></tr>
|
||||
<tr><td>⚠️ Pendentes</td><td>Produtores que não iniciaram ou pararam</td></tr>
|
||||
<tr><td>📄 Documentos Recebidos</td><td>Total de documentos no sistema</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<p>Abaixo do dashboard há a <strong>barra de Compliance EUDR Geral</strong> — mostra o percentual de produtores em conformidade.</p>
|
||||
|
||||
<h3>👥 Lista de Produtores</h3>
|
||||
<p>Tabela com todos os produtores cadastrados, mostrando:</p>
|
||||
<ul>
|
||||
<li><strong>Nome</strong> e CPF</li>
|
||||
<li><strong>Propriedade</strong> e município/UF</li>
|
||||
<li><strong>Documentos:</strong> indicadores visuais (□ = não enviado, ■ = enviado/aprovado) — X/8</li>
|
||||
<li><strong>Status:</strong> Pendente, Em Andamento, Completo</li>
|
||||
<li><strong>Ações:</strong> botões "Ver" (detalhes) e "Dossiê" (gerar PDF)</li>
|
||||
</ul>
|
||||
|
||||
<h4>🔍 Busca</h4>
|
||||
<p>Campo de busca no topo da lista permite filtrar por <strong>nome, CPF, propriedade ou município</strong>.</p>
|
||||
|
||||
<h3>📥 Exportações</h3>
|
||||
|
||||
<h4>Dossiê PDF</h4>
|
||||
<p>Ao clicar em "Dossiê" na lista de produtores, o sistema gera um PDF profissional com:</p>
|
||||
<ul>
|
||||
<li>Capa com dados do produtor e status de compliance</li>
|
||||
<li>Página de dados pessoais e da propriedade</li>
|
||||
<li>Resumo visual de todos os documentos</li>
|
||||
<li>Detalhe de cada documento (status, dados extraídos, miniatura da imagem)</li>
|
||||
<li>Declaração de conformidade EUDR com espaço para assinatura</li>
|
||||
</ul>
|
||||
|
||||
<h4>Exportar CSV</h4>
|
||||
<p>O botão "Exportar CSV" gera uma planilha com todos os produtores — nome, CPF, propriedade, município, estado, área, cultura, status e progresso. Ideal para importar em ERPs ou planilhas.</p>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 9</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 10 — API REST -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>8. API REST</h2>
|
||||
<span class="pg">10</span>
|
||||
</div>
|
||||
|
||||
<p>Todos os dados do DocuAgro são acessíveis via API REST para integração com sistemas externos.</p>
|
||||
|
||||
<table>
|
||||
<thead><tr><th>Endpoint</th><th>Método</th><th>Descrição</th><th>Retorno</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td><span class="cmd">/api/health</span></td><td>GET</td><td>Health check do sistema</td><td>Status, versão, timestamp</td></tr>
|
||||
<tr><td><span class="cmd">/api/dashboard</span></td><td>GET</td><td>Estatísticas gerais</td><td>Total produtores, completos, pendentes, docs</td></tr>
|
||||
<tr><td><span class="cmd">/api/produtores</span></td><td>GET</td><td>Listar todos os produtores</td><td>Array com dados e status de cada um</td></tr>
|
||||
<tr><td><span class="cmd">/api/produtores/:id</span></td><td>GET</td><td>Detalhe de um produtor</td><td>Dados + documentos + último dossiê</td></tr>
|
||||
<tr><td><span class="cmd">/api/produtores/:id/dossie</span></td><td>POST</td><td>Gerar dossiê PDF</td><td>Caminho do arquivo gerado</td></tr>
|
||||
<tr><td><span class="cmd">/api/dossie/download/:arquivo</span></td><td>GET</td><td>Download do dossiê</td><td>Arquivo PDF</td></tr>
|
||||
<tr><td><span class="cmd">/api/exportar/csv</span></td><td>GET</td><td>Exportar todos em CSV</td><td>Arquivo CSV</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>📡 Exemplos de Uso</h3>
|
||||
|
||||
<div class="code-block">
|
||||
<span class="comment"># Health check</span><br>
|
||||
curl http://localhost:3100/api/health<br><br>
|
||||
<span class="comment"># Dashboard</span><br>
|
||||
curl http://localhost:3100/api/dashboard<br><br>
|
||||
<span class="comment"># Listar produtores</span><br>
|
||||
curl http://localhost:3100/api/produtores<br><br>
|
||||
<span class="comment"># Gerar dossiê de um produtor</span><br>
|
||||
curl -X POST http://localhost:3100/api/produtores/PROD_ID/dossie<br><br>
|
||||
<span class="comment"># Exportar CSV</span><br>
|
||||
curl -o produtores.csv http://localhost:3100/api/exportar/csv
|
||||
</div>
|
||||
|
||||
<div class="box warning">
|
||||
<h4>⚠️ Segurança da API (MVP)</h4>
|
||||
<p>No MVP, a API <strong>não possui autenticação</strong>. Para produção, será necessário implementar JWT, rate limiting e HTTPS. Consulte o roadmap de segurança.</p>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 10</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 11 — DOSSIÊ -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>9. Dossiê PDF</h2>
|
||||
<span class="pg">11</span>
|
||||
</div>
|
||||
|
||||
<p>O dossiê é o produto final do DocuAgro — um PDF profissional que reúne toda a documentação do produtor para fins de compliance EUDR.</p>
|
||||
|
||||
<h3>📄 Estrutura do Dossiê</h3>
|
||||
<table>
|
||||
<thead><tr><th>Seção</th><th>Conteúdo</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td><strong>Capa</strong></td><td>Logo DocuAgro, nome do produtor, propriedade, status de compliance, data</td></tr>
|
||||
<tr><td><strong>Dados do Produtor</strong></td><td>Nome, CPF, propriedade, município, estado, área, cultura, data de cadastro</td></tr>
|
||||
<tr><td><strong>Resumo dos Documentos</strong></td><td>Tabela com todos os 8 documentos, status e data de envio</td></tr>
|
||||
<tr><td><strong>Detalhes (por doc)</strong></td><td>Status, arquivo, dados extraídos pelo OCR, resultado da validação, miniatura</td></tr>
|
||||
<tr><td><strong>Declaração Final</strong></td><td>Declaração de conformidade EUDR com espaço para assinatura</td></tr>
|
||||
<tr><td><strong>Rodapé</strong></td><td>Número da página em todas as páginas</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>🎨 Visual</h3>
|
||||
<p>O dossiê usa um tema profissional verde com:</p>
|
||||
<ul>
|
||||
<li>Capa com fundo verde gradiente e dados do produtor</li>
|
||||
<li>Badge de status: "✅ COMPLIANCE COMPLETO" ou "⚠️ EM ANDAMENTO"</li>
|
||||
<li>Tabela com cores alternadas e indicadores visuais por status</li>
|
||||
<li>Miniaturas das imagens dos documentos enviados</li>
|
||||
<li>Declaração formal citando o Regulamento (UE) 2023/1115</li>
|
||||
</ul>
|
||||
|
||||
<h3>📋 Geração</h3>
|
||||
<p>O dossiê pode ser gerado de 3 formas:</p>
|
||||
<ol>
|
||||
<li><strong>Pelo produtor:</strong> comando <span class="cmd">/dossie</span> no bot Telegram</li>
|
||||
<li><strong>Pela cooperativa:</strong> botão "Dossiê" no painel web</li>
|
||||
<li><strong>Via API:</strong> <span class="cmd">POST /api/produtores/:id/dossie</span></li>
|
||||
</ol>
|
||||
|
||||
<p>O PDF é gerado com <strong>PDFKit</strong> e salvo em <span class="cmd">uploads/dossies/</span>. O nome do arquivo segue o padrão: <span class="cmd">dossie_[CPF]_[data_hora].pdf</span></p>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 11</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 12 — INSTALAÇÃO -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>10. Instalação e Configuração</h2>
|
||||
<span class="pg">12</span>
|
||||
</div>
|
||||
|
||||
<h3>📋 Pré-requisitos</h3>
|
||||
<ul>
|
||||
<li><strong>Node.js 18+</strong></li>
|
||||
<li><strong>Token do Bot Telegram</strong> (criar com @BotFather no Telegram)</li>
|
||||
<li><strong>Chave API OpenAI</strong> (platform.openai.com)</li>
|
||||
</ul>
|
||||
|
||||
<h3>🚀 Setup</h3>
|
||||
<div class="code-block">
|
||||
<span class="comment"># 1. Clonar repositório</span><br>
|
||||
git clone http://137.184.77.7:3000/bigtux/docuagro.git<br>
|
||||
cd docuagro<br><br>
|
||||
<span class="comment"># 2. Instalar dependências</span><br>
|
||||
npm install<br><br>
|
||||
<span class="comment"># 3. Configurar variáveis de ambiente</span><br>
|
||||
cp .env.example .env<br>
|
||||
nano .env <span class="comment"># Preencher tokens</span><br><br>
|
||||
<span class="comment"># 4. Criar banco de dados</span><br>
|
||||
npm run setup<br><br>
|
||||
<span class="comment"># 5. Iniciar</span><br>
|
||||
npm start
|
||||
</div>
|
||||
|
||||
<h3>⚙️ Arquivo .env</h3>
|
||||
<div class="code-block">
|
||||
<span class="comment"># Bot Telegram</span><br>
|
||||
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...<br><br>
|
||||
<span class="comment"># OpenAI API</span><br>
|
||||
OPENAI_API_KEY=sk-...<br>
|
||||
OPENAI_MODEL=gpt-4o-mini<br><br>
|
||||
<span class="comment"># Servidor</span><br>
|
||||
PORT=3100<br><br>
|
||||
<span class="comment"># Banco de dados</span><br>
|
||||
DB_PATH=./data/docuagro.db<br><br>
|
||||
<span class="comment"># Uploads</span><br>
|
||||
UPLOAD_DIR=./uploads
|
||||
</div>
|
||||
|
||||
<h3>🔄 Rodar com PM2 (Produção)</h3>
|
||||
<div class="code-block">
|
||||
<span class="comment"># Iniciar com PM2</span><br>
|
||||
npx pm2 start src/index.js --name docuagro<br><br>
|
||||
<span class="comment"># Ver logs</span><br>
|
||||
npx pm2 logs docuagro<br><br>
|
||||
<span class="comment"># Reiniciar</span><br>
|
||||
npx pm2 restart docuagro<br><br>
|
||||
<span class="comment"># Parar</span><br>
|
||||
npx pm2 stop docuagro
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 12</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 13 — ARQUITETURA -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>11. Arquitetura Técnica</h2>
|
||||
<span class="pg">13</span>
|
||||
</div>
|
||||
|
||||
<h3>🛠 Stack</h3>
|
||||
<div style="margin: 10px 0;">
|
||||
<span class="badge">Node.js 18+</span>
|
||||
<span class="badge">Telegraf 4.16</span>
|
||||
<span class="badge">Express.js 4</span>
|
||||
<span class="badge">OpenAI GPT-4o-mini</span>
|
||||
<span class="badge">Tesseract.js</span>
|
||||
<span class="badge">PDFKit</span>
|
||||
<span class="badge">SQLite (better-sqlite3)</span>
|
||||
<span class="badge">HTML/CSS/JS</span>
|
||||
</div>
|
||||
|
||||
<h3>📁 Estrutura de Pastas</h3>
|
||||
<div class="code-block">
|
||||
docuagro/<br>
|
||||
├── src/<br>
|
||||
│ ├── index.js <span class="comment">← Entry point (Express + Bot)</span><br>
|
||||
│ ├── setup-db.js <span class="comment">← Criação do banco SQLite</span><br>
|
||||
│ ├── bot/<br>
|
||||
│ │ └── telegram-bot.js <span class="comment">← Bot Telegram (Telegraf)</span><br>
|
||||
│ ├── api/<br>
|
||||
│ │ └── routes.js <span class="comment">← API REST (Express)</span><br>
|
||||
│ └── services/<br>
|
||||
│ ├── ai-service.js <span class="comment">← Integração OpenAI</span><br>
|
||||
│ ├── ocr-service.js <span class="comment">← OCR (Tesseract.js)</span><br>
|
||||
│ ├── pdf-service.js <span class="comment">← Geração de dossiê PDF</span><br>
|
||||
│ ├── database.js <span class="comment">← Operações SQLite</span><br>
|
||||
│ └── system-prompt.js <span class="comment">← Prompt EUDR da IA</span><br>
|
||||
├── public/ <span class="comment">← Painel web (HTML/CSS/JS)</span><br>
|
||||
├── data/ <span class="comment">← Banco SQLite</span><br>
|
||||
├── uploads/ <span class="comment">← Documentos dos produtores</span><br>
|
||||
├── logos/ <span class="comment">← Logo oficial</span><br>
|
||||
└── docs/ <span class="comment">← Documentação e manuais</span>
|
||||
</div>
|
||||
|
||||
<h3>💾 Banco de Dados (SQLite)</h3>
|
||||
<table>
|
||||
<thead><tr><th>Tabela</th><th>Função</th><th>Campos principais</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td><strong>cooperativas</strong></td><td>Cooperativas cadastradas</td><td>id, nome, cnpj, contato</td></tr>
|
||||
<tr><td><strong>produtores</strong></td><td>Produtores rurais</td><td>id, nome, cpf, propriedade, município, cultura, etapa_atual, status</td></tr>
|
||||
<tr><td><strong>documentos</strong></td><td>Documentos enviados</td><td>id, produtor_id, tipo, status, arquivo_path, dados_extraidos</td></tr>
|
||||
<tr><td><strong>conversas</strong></td><td>Histórico de mensagens</td><td>id, produtor_id, role, conteudo, timestamp</td></tr>
|
||||
<tr><td><strong>dossies</strong></td><td>Dossiês gerados</td><td>id, produtor_id, arquivo_path, docs_incluidos</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<h3>🔐 Segurança</h3>
|
||||
<ul>
|
||||
<li>Cada produtor tem <strong>diretório isolado</strong> de uploads</li>
|
||||
<li><strong>Helmet</strong> + <strong>CORS</strong> configurados no Express</li>
|
||||
<li>Armazenamento <strong>local</strong> (sem cloud pública)</li>
|
||||
<li><strong>Roadmap:</strong> JWT, HTTPS, rate limiting, criptografia, backups</li>
|
||||
</ul>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 13</span></div>
|
||||
</div>
|
||||
|
||||
<!-- PÁG 14 — FAQ -->
|
||||
<div class="page interna">
|
||||
<div class="header-bar">
|
||||
<span class="brand">🌱 DocuAgro</span>
|
||||
<h2>12. FAQ e Troubleshooting</h2>
|
||||
<span class="pg">14</span>
|
||||
</div>
|
||||
|
||||
<h3>❓ Perguntas Frequentes</h3>
|
||||
|
||||
<h4>O produtor precisa instalar algum app?</h4>
|
||||
<p>Não. O DocuAgro funciona 100% pelo <strong>Telegram</strong>, que a maioria já tem instalado.</p>
|
||||
|
||||
<h4>Funciona pelo WhatsApp?</h4>
|
||||
<p>No momento não. O WhatsApp está no roadmap (v2.0). Atualmente funciona apenas pelo Telegram.</p>
|
||||
|
||||
<h4>Quanto custa para o produtor?</h4>
|
||||
<p>O modelo é <strong>B2B</strong> — a cooperativa paga e oferece o serviço aos seus associados. O produtor não paga nada.</p>
|
||||
|
||||
<h4>Os documentos ficam seguros?</h4>
|
||||
<p>Sim. São armazenados em servidor próprio, em diretórios isolados por produtor. Não são enviados para cloud pública.</p>
|
||||
|
||||
<h4>E se o produtor parar no meio?</h4>
|
||||
<p>O progresso é salvo automaticamente. Ele pode voltar a qualquer momento e continuar de onde parou.</p>
|
||||
|
||||
<h4>A IA pode errar na validação?</h4>
|
||||
<p>O OCR faz validação inicial automatizada. Documentos com confiança baixa são marcados como "Em análise" para verificação manual pela cooperativa.</p>
|
||||
|
||||
<h4>Quantos produtores o sistema aguenta?</h4>
|
||||
<p>O SQLite suporta até centenas de milhares de registros. Para escala maior (10k+ produtores simultâneos), recomenda-se migrar para PostgreSQL.</p>
|
||||
|
||||
<h3>🔧 Troubleshooting</h3>
|
||||
|
||||
<table>
|
||||
<thead><tr><th>Problema</th><th>Solução</th></tr></thead>
|
||||
<tbody>
|
||||
<tr><td>Bot não responde</td><td>Verificar se o processo está rodando: <span class="cmd">npx pm2 status</span></td></tr>
|
||||
<tr><td>Erro 409 (Conflict)</td><td>Duas instâncias rodando. Matar todas e reiniciar: <span class="cmd">npx pm2 delete docuagro && npx pm2 start src/index.js --name docuagro</span></td></tr>
|
||||
<tr><td>Token inválido (401)</td><td>Verificar TELEGRAM_BOT_TOKEN no arquivo .env</td></tr>
|
||||
<tr><td>IA não responde</td><td>Verificar OPENAI_API_KEY e saldo da conta OpenAI</td></tr>
|
||||
<tr><td>OCR com confiança baixa</td><td>Pedir ao produtor foto com melhor iluminação e enquadramento</td></tr>
|
||||
<tr><td>Painel não carrega</td><td>Verificar se a porta 3100 está acessível: <span class="cmd">curl localhost:3100/api/health</span></td></tr>
|
||||
<tr><td>Banco corrompido</td><td>Fazer backup e recriar: <span class="cmd">npm run setup</span></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<div style="text-align:center; margin-top:40px; padding-top:20px; border-top:2px solid #e0e0e0;">
|
||||
<p style="font-size:22px; font-weight:700; color:#1B5E20;">🌱 DocuAgro</p>
|
||||
<p style="font-size:14px; color:#666;">Compliance do produtor, na palma da mão.</p>
|
||||
<p style="font-size:12px; color:#999; margin-top:12px;">AI Vertice • aivertice.com • 2026</p>
|
||||
<p style="font-size:11px; color:#bbb; margin-top:8px;">Dúvidas? Suporte técnico disponível.</p>
|
||||
</div>
|
||||
|
||||
<div class="footer"><span>DocuAgro — Manual Completo</span><span>AI Vertice</span><span>Página 14</span></div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user