Estudos Portuários: Atracação e Desatracação

Este projeto é um ecossistema de aprendizado focado em operações portuárias no Brasil, com ênfase em atracação e desatracação de embarcações. Ele combina documentos oficiais, planos de estudo e uma aplicação interativa para fixação de conhecimento.

Escopo: gratuito e open source, dedicado a estudo e aprendizagem. O que for opcional e pago (ex.: certas APIs) fica como configuração local do estudante, não como dependência obrigatória do repositório.

🚀 Como Rodar a Aplicação Localmente

A aplicação interativa está localizada no diretório /web. Siga os passos abaixo para configurá-la:

Pré-requisitos

• Node.js: Versão 20.x ou superior.
• Gerenciador de Pacotes: npm (incluído no Node.js).
• Glossário IA (Nível Indústria): Híbrido Groq/LLama 3.1 + Ollama qwen2.5-coder:7b (ver web/.env.example).
• Simulador 3D: Motor v5.0 Industrial Grade com suporte a múltiplas embarcações e telemetria avançada.

Passo a Passo

1. Navegue até o diretório da aplicação:

   cd web

2. Instale as dependências:

   npm install

3. Configure as variáveis de ambiente: No diretório /web, execute cp .env.example .env.local e preencha GROQ_API_KEY. O preset padrão usa Groq + Ollama qwen2.5-coder:7b (indicado para hardware com 24GB+ RAM). Instale o modelo: ollama pull qwen2.5-coder:7b.

4. Inicie o servidor de desenvolvimento:

   npm run dev

5. Acesse no navegador: Abra http://localhost:3000 para visualizar a aplicação.

Detalhes de variáveis de ambiente opcionais, segurança para hospedagem e deploy na Vercel (CLI) estão em web/README.md.

---

📚 Estrutura de Estudos

O conteúdo está dividido em três níveis progressivos, cada um focado em aspectos específicos da legislação e operação portuária brasileira.

Nível	Foco Principal	Conteúdo	Pasta
Básico	Fundamentos	Lei 9.537, NORMAM-204, RIPEAM, Vocabulário	01-basico/
Intermediário	Operação e Regulação	NORMAM-12, Resoluções ANTAQ, Praticagem	02-intermediario/
Avançado	Normas Especiais	Produtos Perigosos, Normas Locais, COLREG IMO	03-avancado/

Fluxo para NotebookLM

Recomendamos criar notebooks separados para cada nível no Google NotebookLM para uma melhor experiência de consulta:

1. Notebook 1 (Básico): Carregar documentos da pasta 01-basico.
2. Notebook 2 (Intermediário): Carregar documentos da pasta 02-intermediario.
3. Notebook 3 (Avançado): Carregar documentos da pasta 03-avancado.

Documentação técnica e continuidade

Ficheiros para desenvolvedores e contexto do simulador 3D, memória do projeto e auditorias: pasta docs/ (comece pelo índice docs/README.md).

---

🔗 Fontes Oficiais

• DPC/Marinha - Normas da Autoridade Marítima (NORMAMs).
• ANTAQ Juris - Consultas a resoluções e normativos.
• Portal Gov.br ANTAQ - Atualizações regulatórias.

---

🛠️ Stack Tecnológica

• Framework: Next.js 16 (App Router + React 19)
• Estilização: Vanilla CSS
• Validação: Zod + React Hook Form
• Inteligência Artificial: SDK AI da Vercel + Groq (Llama Models)
• Gestão de Estado: nuqs (URL State management)