+- [Características Principais](#características-principais)
+- [Instalação Rápida](#instalação-rápida)
+- [Arquitetura do Sistema](#arquitetura-do-sistema)
+- [Guia de Uso](#guia-de-uso)
+- [API REST Endpoints](#api-rest-endpoints)
+- [Integração Google Sheets](#integração-google-sheets)
+- [Configuração Avançada](#configuração-avançada)
+- [Troubleshooting](#troubleshooting)
+- [Documentação Técnica](#documentação-técnica)
-## Get started
+---
-1. Install Claude Code:
+## ✨ Características Principais
-**MacOS/Linux:**
+### 📊 Dashboard Executivo (Real-time)
+- ✅ 8 KPIs principais com atualização automática
+- ✅ Gráficos interativos com Chart.js
+- ✅ Análise visual de margens e lucros
+- ✅ Top 3 produtos mais rentáveis
+- ✅ Alertas de produtos em risco
+
+### 📦 Gestão de Produtos (CRUD Completo)
+- ✅ Adicionar, editar e remover produtos
+- ✅ **Comprimento variável por produto** (não apenas padrão)
+- ✅ Cálculo automático de volume (π×r²×h)
+- ✅ Peças por m³ e por estéreo
+- ✅ Validação robusta de entrada
+- ✅ Status visual (ativo/inativo)
+
+### 💰 Análise de Preços (Margem Inteligente)
+- ✅ Preço mínimo e máximo por produto
+- ✅ Cálculo automático de margem (%)
+- ✅ Preço sugerido baseado em margem desejada
+- ✅ Sugestão em massa com um clique
+- ✅ Histórico de alterações
+
+### 📈 Módulo de Vendas (Rastreamento Completo)
+- ✅ Registro de vendas com custos associados
+- ✅ Filtros por período, produto e cliente
+- ✅ Cálculo automático de margem por venda
+- ✅ Relatórios de faturamento
+- ✅ Exportação de dados de vendas
+
+### 📋 Sistema de Orçamentos (Cotação Profissional)
+- ✅ Criação de orçamentos com múltiplos itens
+- ✅ Conversão automática entre unidades
+- ✅ Cálculo de total com descontos
+- ✅ Validade configurável de orçamentos
+- ✅ Histórico de cotações
+
+### 📊 Relatórios Financeiros (Analytics Avançado)
+- ✅ Relatório de vendas por período
+- ✅ Análise de margem por produto
+- ✅ Lucro total e por categoria
+- ✅ Tendências de vendas
+- ✅ Exportação em PDF/CSV
+
+### 🔗 Integração Google Sheets (Sincronização Bidirecional)
+- ✅ Sincronizar produtos DA planilha
+- ✅ Exportar dados PARA planilha
+- ✅ Atualização automática
+- ✅ Suporte a múltiplas planilhas
+- ✅ Histórico de sincronizações
+
+### 📑 Histórico e Auditoria (Compliance)
+- ✅ Registro de todas as operações
+- ✅ Timestamp de cada ação
+- ✅ Usuário que realizou ação
+- ✅ Rastreamento completo
+- ✅ Exportação de audit trail
+
+### 💾 Exportação de Dados (Import/Export)
+- ✅ Exportar para CSV
+- ✅ Exportar para JSON
+- ✅ Importar dados
+- ✅ Backup automático
+- ✅ Sincronização Google Sheets
+
+---
+
+## 🚀 Instalação Rápida
+
+### Pré-requisitos
+```bash
+# Verificar Node.js
+node --version # Deve ser 14+
+npm --version # Deve ser 6+
+```
+
+### Setup em 3 Passos
+
+```bash
+# 1️⃣ Instalar dependências
+npm install
+
+# 2️⃣ Configurar variáveis (opcional - Google Sheets)
+cp .env.example .env
+# Editar .env com sua API Key e Google Sheets ID
+
+# 3️⃣ Iniciar servidor
+npm start
+
+# Ou com auto-reload em desenvolvimento
+npm run dev
+```
+
+O servidor estará disponível em: **http://localhost:3000**
+
+---
+
+## 🏗️ Arquitetura do Sistema
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Frontend (HTML5/JS) │
+│ eucalipto-system-v2.html │
+│ - Interface responsiva (Desktop/Tablet/Mobile) │
+│ - 10 abas funcionais │
+│ - LocalStorage para persistência offline │
+│ - Chart.js para visualizações │
+└────────────────────────┬────────────────────────────────────┘
+ │ REST API (HTTP/JSON)
+ │
+┌────────────────────────▼────────────────────────────────────┐
+│ Backend (Node.js/Express) │
+│ server.js │
+│ - 15+ endpoints RESTful │
+│ - Google Sheets API integration │
+│ - data.json persistence │
+│ - Validação de dados │
+└────────────────────────┬────────────────────────────────────┘
+ ┌────┴────┬──────────┐
+ │ │ │
+ ┌───────▼──┐ ┌────▼────┐ ┌─▼──────────┐
+ │ Arquivo │ │LocalData│ │ Google │
+ │ data.json│ │Storage │ │ Sheets │
+ └──────────┘ └─────────┘ └────────────┘
+```
+
+### Stack Tecnológico
+
+| Camada | Tecnologia | Versão |
+|--------|-----------|--------|
+| Frontend | HTML5/CSS3/JavaScript | Vanilla |
+| Backend | Node.js + Express | 4.18.2 |
+| Banco de Dados | JSON File + localStorage | Local |
+| Integração | Google Sheets API | v4 |
+| Gráficos | Chart.js | 3.9+ |
+| Estilização | CSS Grid + Flexbox | Native |
+
+---
+
+## 👨💼 Guia de Uso
+
+### 1️⃣ Dashboard
+```
+Visualizar overview completo:
+- Margem média geral
+- Lucro por estéreo
+- Total de vendas
+- Produtos ativos
+- Alertas e destaques
+```
+
+### 2️⃣ Adicionar Produto
+```
+1. Clique na aba "📦 PRODUTOS"
+2. Clique em "➕ ADICIONAR PRODUTO"
+3. Preencha:
+ - Nome (ex: "Eucalipto 20cm x 2.2m")
+ - Diâmetro (em cm)
+ - Comprimento (em metros)
+ - Preço Mínimo e Máximo (em R$)
+4. Clique em "Salvar"
+5. Cálculos serão gerados automaticamente
+```
+
+### 3️⃣ Gerenciar Preços
+```
+1. Vá para "💰 PREÇOS"
+2. Veja todos os produtos com:
+ - Volume calculado
+ - Custo total por peça
+ - Margem mínima e máxima
+ - Preço sugerido
+3. Clique "Sugerir Todos" para atualizar margens
+```
+
+### 4️⃣ Registrar Venda
+```
+1. Acesse "📈 VENDAS"
+2. Clique em "➕ NOVA VENDA"
+3. Selecione:
+ - Produto
+ - Quantidade
+ - Preço unitário
+ - Cliente (opcional)
+4. Sistema calcula margem automaticamente
+5. Confirme para salvar
+```
+
+### 5️⃣ Criar Orçamento
+```
+1. Acesse "📋 ORÇAMENTOS"
+2. Clique em "➕ NOVO ORÇAMENTO"
+3. Adicione itens:
+ - Produto
+ - Quantidade
+ - Preço unitário
+4. Sistema calcula total
+5. Salve e compartilhe com cliente
+```
+
+### 6️⃣ Consultar Relatórios
+```
+1. Acesse "📊 RELATÓRIOS"
+2. Escolha tipo de análise:
+ - Vendas por período
+ - Margem por produto
+ - Lucro total
+ - Tendências
+3. Exporte em CSV ou PDF
+```
+
+### 7️⃣ Sincronizar Google Sheets
+```
+1. Acesse "🔗 GOOGLE SHEETS"
+2. Configure API Key no .env
+3. Clique "SINCRONIZAR DE SHEETS"
+ (Carrega produtos da planilha)
+4. Trabalhe normalmente
+5. Clique "EXPORTAR PARA SHEETS"
+ (Envia dados de volta)
+```
+
+---
+
+## 🔌 API REST Endpoints
+
+### Base URL
+```
+http://localhost:3000/api
+```
+
+### Produtos
+
+```bash
+# Listar todos
+GET /produtos
+
+# Criar novo
+POST /produtos
+Body: { nome, diametro, comprimento, precoMin, precoMax }
+
+# Atualizar
+PUT /produtos/:id
+Body: { campo: valor }
+
+# Remover
+DELETE /produtos/:id
+```
+
+### Vendas
+
+```bash
+# Listar vendas
+GET /vendas
+
+# Registrar venda
+POST /vendas
+Body: { produtoId, quantidade, precoUnitario, cliente }
+```
+
+### Orçamentos
+
+```bash
+# Listar orçamentos
+GET /orcamentos
+
+# Criar orçamento
+POST /orcamentos
+Body: { cliente, itens: [{ produtoId, quantidade, precoUnitario }] }
+
+# Remover
+DELETE /orcamentos/:id
+```
+
+### Análise
+
+```bash
+# Dados gerais
+GET /analise
+
+# Relatório de vendas
+GET /relatorios/vendas
+
+# Relatório de margem
+GET /relatorios/margem
+```
+
+### Google Sheets
+
+```bash
+# Status de configuração
+GET /google-sheets/status
+
+# Sincronizar DE Sheets
+GET /google-sheets/sync-from
+
+# Sincronizar PARA Sheets
+GET /google-sheets/sync-to
+```
+
+### Saúde
+
+```bash
+# Verificar servidor
+GET /health
+```
+
+---
+
+## 📊 Integração Google Sheets
+
+### Configuração (5 Passos)
+
+**1. Criar Projeto no Google Cloud**
+```
+https://console.cloud.google.com → Novo Projeto
+```
+
+**2. Ativar Google Sheets API**
+```
+APIs e Serviços → Biblioteca → Google Sheets API → Ativar
+```
+
+**3. Gerar API Key**
+```
+Credenciais → Criar Credenciais → Chave de API
+```
+
+**4. Copiar ID da Planilha**
+```
+URL: https://docs.google.com/spreadsheets/d/AQUI_ESTA_O_ID/edit
+```
+
+**5. Configurar .env**
```bash
-curl -fsSL https://claude.ai/install.sh | bash
+GOOGLE_SHEETS_ID=seu_id_aqui
+GOOGLE_API_KEY=sua_chave_aqui
+PORT=3000
+NODE_ENV=production
```
-**Homebrew (MacOS):**
+### Fluxo de Sincronização
+
+```
+Frontend → POST /google-sheets/sync-from → Carrega dados
+ ↓
+ Google Sheets API
+ ↓
+ Merge com localStorage
+ ↓
+ Atualizar interface
+```
+
+---
+
+## ⚙️ Configuração Avançada
+
+### Variáveis de Ambiente (.env)
+
```bash
-brew install --cask claude-code
+# Google Sheets
+GOOGLE_SHEETS_ID=1r1KgMS5xPI8itdpJf_gGQEfV23Cu32hz
+GOOGLE_API_KEY=sua_chave_de_api_aqui
+
+# Servidor
+PORT=3000
+NODE_ENV=development
+
+# Opcional - Configuração de Custos
+CUSTO_MADEIRA=200 # R$ por estéreo
+CUSTO_TRATAMENTO=30 # R$ por m³
+COEF_STEREO=1.3 # Coeficiente de empacotamento
+COMPRIMENTO_PADRAO=2.2 # metros
+MARGEM_DESEJADA=30 # percentual
```
-**Windows:**
-```powershell
-irm https://claude.ai/install.ps1 | iex
+### Estrutura de Dados (data.json)
+
+```json
+{
+ "produtos": [
+ {
+ "id": "uuid-123",
+ "nome": "Eucalipto 20cm",
+ "diametro": 20,
+ "comprimento": 2.2,
+ "precoMin": 50,
+ "precoMax": 120,
+ "custoTotal": 13.19,
+ "margemMin": 279,
+ "margemMax": 810,
+ "ativo": true,
+ "dataCriacao": "2025-12-16T10:30:00Z"
+ }
+ ],
+ "vendas": [],
+ "orcamentos": [],
+ "historico": [],
+ "config": {
+ "madeira": 200,
+ "tratamento": 30,
+ "coef": 1.3,
+ "comp": 2.2,
+ "margemDesejada": 30
+ }
+}
```
-**NPM:**
+---
+
+## 🆘 Troubleshooting
+
+### ❌ Erro: "Cannot find module 'express'"
+```bash
+npm install
+npm start
+```
+
+### ❌ Erro: "Port 3000 already in use"
```bash
-npm install -g @anthropic-ai/claude-code
+# Usar outra porta
+PORT=3001 npm start
+
+# Ou matar processo existente
+lsof -i :3000
+kill -9 Gestão Total de Produtos, Preços, Vendas, Orçamentos com Google Sheets
+| BITOLA | Ø | COMP | VOL | PÇ/ST | CUSTO | DESCRIÇÃO | STATUS |
|---|
| PRODUTO | CUSTO | PREÇO MÍN | PREÇO MÁX | MARGEM % | SUGERIDO | STATUS |
|---|
| DATA | CLIENTE | PRODUTO | QTDADE | UN. | PREÇO | TOTAL | AÇÕES |
|---|
******Escolha a direção da sincronização:
+ + + +Gestão Completa de Produtos, Preços, Cálculos e Orçamentos
+| BITOLA | Ø cm | COMP. (m) | VOLUME (m³) | PÇ/m³ | PÇ/st | CUSTO/PÇ | STATUS |
|---|
| PRODUTO | CUSTO/PÇ | PREÇO MÍN | PREÇO MÁX | MARGEM MÍN | MARGEM MÁX | SUGERIDO | STATUS |
|---|
| PRODUTO | PÇ/ST | CUSTO/ST | VENDA MÍN | VENDA MÁX | LUCRO MÍN | LUCRO MÁX | MARGEM | STATUS |
|---|