# 📚 SteelBook - Manual do Usuário ## Bem-vindo ao SteelBook! SteelBook é sua solução completa para criar, organizar e gerar Databooks técnicos profissionais. Este manual guiará você por cada funcionalidade da plataforma. --- ## 📑 Índice 1. [Primeiros Passos](#primeiros-passos) 2. [Dashboard](#dashboard) 3. [Criando um Databook](#criando-um-databook) 4. [Gerenciando Documentos](#gerenciando-documentos) 5. [Tópicos e Categorias](#tópicos-e-categorias) 6. [Configurações](#configurações) 7. [Gerando PDF](#gerando-pdf) 8. [Dicas e Truques](#dicas-e-truques) --- ## Primeiros Passos ### Login 1. Acesse a plataforma SteelBook 2. Digite seu **email** e **senha** 3. Clique em **"Entrar"** 4. Você será redirecionado para o Dashboard > **Dica:** Se esqueceu sua senha, entre em contato com o administrador. ### Sua Primeira Sessão Após fazer login, você verá: - **Dashboard** com seus projetos recentes - **Barra de navegação** no topo - **Menu lateral** com opções principais --- ## Dashboard O Dashboard é sua central de controle. Aqui você vê: ### 📊 Estatísticas Rápidas ``` ┌─────────────────────────────────────────────────────┐ │ Total Projetos: 5 │ Em Andamento: 2 │ Finalizados: 3 │ └─────────────────────────────────────────────────────┘ ``` ### 📋 Projetos Recentes Uma tabela mostrando seus últimos projetos com: | Campo | Descrição | |-------|-----------| | **Projeto** | Nome e número do projeto | | **Cliente** | Empresa cliente | | **Status** | Rascunho, Em Andamento, Revisão, Finalizado | | **Progresso** | Barra visual com percentual | | **Ações** | Ver, Editar, Clonar, Deletar | ### 🎯 Entendendo o Progresso A barra de progresso mostra quantos tópicos já têm documentos: ``` Progresso = (Tópicos com documentos / Total de tópicos) × 100 Exemplo: ├─ Total de tópicos: 28 ├─ Tópicos com documentos: 7 └─ Progresso: 25% ✓ ``` --- ## Criando um Databook ### Passo 1: Novo Databook 1. Clique no botão **"Novo Databook"** (canto superior direito) 2. Você será levado à página de criação ### Passo 2: Informações Básicas Preencha os campos: - **Número do Projeto:** Ex: `PROJ-2024-001` - **Nome do Projeto:** Ex: `Databook Turbina XYZ` - **Cliente:** Selecione na lista ou crie novo - **Template:** Escolha o template padrão ou customizado - **Data de Início:** Quando o projeto começa - **Data de Entrega:** Prazo para conclusão ### Passo 3: Configurações do Databook Na aba **"Configurações"**, customize: #### Informações do Produto - Nome do produto - Tipo (Ex: Turbina, Compressor) - Descrição técnica - Normas aplicáveis #### Informações do Cliente - Nome da empresa - Contato principal - Email - Telefone #### Aparência - **Cores:** Primária e secundária - **Logo da Empresa:** Upload da logo - **Logo do Cliente:** Upload da logo - **Marca d'água:** Imagem de fundo - **Título Principal:** Título do databook - **Subtítulo:** Subtítulo opcional #### Formato do PDF - **Tamanho:** A4 ou Letter - **Orientação:** Retrato ou Paisagem - **Margens:** Ajuste em mm - **Opções:** Marca d'água, Numeração de páginas ### Passo 4: Salvar Clique em **"Salvar Configurações"** para confirmar. --- ## Gerenciando Documentos ### Adicionando Documentos 1. Abra o databook que deseja editar 2. Navegue até a seção desejada 3. Clique em **"+ Adicionar Documento"** 4. Selecione o arquivo (PDF, JPG, PNG) 5. Preencha os dados: - **Título:** Nome do documento - **Número:** Código do documento - **Revisão:** Versão (Ex: Rev. 1) - **Data:** Data do documento - **Tags:** Palavras-chave ### Visualizando Documentos Cada documento mostra: - **Thumbnail:** Prévia do arquivo - **Informações:** Título, número, revisão - **Ações:** Visualizar, Editar, Deletar ### Organizando Documentos Você pode: - **Reordenar:** Arrastar e soltar - **Filtrar:** Por categoria ou tag - **Buscar:** Por título ou número ### Deletando Documentos 1. Clique no ícone **🗑️ (Lixo)** 2. Confirme a exclusão 3. Documento será removido permanentemente --- ## Tópicos e Categorias ### Entendendo Tópicos Tópicos são as seções do seu databook. Exemplo: ``` 1. Atestado de Conformidade 1.1 Certificados 1.2 Desenhos 2. Procedimentos 2.1 Soldagem 2.2 Inspeção ``` ### Gerenciando Tópicos Acesse **Menu → Gestão de Tópicos** #### Criar Novo Tópico 1. Clique **"Novo Tópico"** 2. Preencha: - **Número:** Ex: `1.1` - **Título:** Nome do tópico - **Descrição:** Detalhes (opcional) - **Categoria:** Selecione uma categoria - **Obrigatório:** Marque se é obrigatório 3. Clique **"Criar"** #### Editar Tópico 1. Clique no ícone **✏️ (Editar)** 2. Modifique os dados 3. Clique **"Atualizar"** #### Reordenar Tópicos 1. Clique e segure o ícone **⋮⋮ (Arrastar)** 2. Arraste para a nova posição 3. A ordem é atualizada automaticamente ### Categorias Categorias organizam seus tópicos por tipo: | Categoria | Cor | Uso | |-----------|-----|-----| | 🟢 Certificados | Verde | Certificações e conformidade | | 🔵 Desenhos | Azul | Desenhos técnicos | | 🟠 Relatórios | Laranja | Relatórios de inspeção | | 🟣 Procedimentos | Roxo | Procedimentos e instruções | | 🔴 Normas | Vermelho | Normas e especificações | --- ## Configurações Acesse **Menu → Configurações** para: ### 1️⃣ Mapeamento de Pastas Configure pastas locais ou na nuvem para sincronização automática. **Criar Mapeamento:** 1. Clique **"Novo Mapeamento"** 2. Preencha: - **Tipo de Documento:** Ex: `Certificados` - **Categoria:** Selecione - **Caminho:** Local ou URL da nuvem - **Frequência:** Manual, Ao criar, Diário, Semanal 3. Clique **"Criar"** **Tipos de Armazenamento:** - **Local:** Pasta no seu computador - **Nuvem:** Google Drive, OneDrive, etc. ### 2️⃣ Gerenciamento de Categorias Crie e customize categorias. **Criar Categoria:** 1. Clique **"Nova Categoria"** 2. Preencha: - **Nome:** Ex: `Testes` - **Descrição:** Detalhes - **Cor:** Escolha uma cor - **Ícone:** Opcional 3. Clique **"Criar"** ### 3️⃣ Gerenciamento de Usuários (Apenas para administradores) Adicione e gerencie usuários do sistema. **Adicionar Usuário:** 1. Clique **"Novo Usuário"** 2. Preencha: - **Email:** Email do usuário - **Nome:** Nome completo - **Perfil:** Admin, Gerente, Engenheiro, Cliente 3. Clique **"Criar"** ### 4️⃣ Logs do Sistema Visualize histórico de ações e processamentos. **Filtrar Logs:** - Por data - Por tipo de ação - Por usuário ### 5️⃣ Integração com IA Configure provedores de IA para análise automática. **Configurar IA:** 1. Selecione o provedor (OpenAI, Claude, Gemini) 2. Insira a API Key 3. Clique **"Testar Conexão"** 4. Se OK, ative a integração --- ## Gerando PDF ### Visualizar Preview 1. Abra o databook 2. Clique em **"Preview"** 3. Veja como ficará o PDF final ### Gerar PDF 1. Clique em **"Gerar PDF"** 2. Aguarde o processamento 3. O arquivo será baixado automaticamente ### Personalizações no PDF O PDF incluirá: - ✅ Logo da empresa - ✅ Logo do cliente - ✅ Marca d'água - ✅ Cores personalizadas - ✅ Numeração de páginas - ✅ Todos os documentos organizados --- ## Dicas e Truques ### 💡 Dica 1: Use Categorias Consistentemente Sempre use as mesmas categorias para manter a organização. ### 💡 Dica 2: Nomeie Documentos Claramente Use nomes descritivos: - ✅ Bom: `Certificado_Soldagem_Rev1_2024` - ❌ Ruim: `doc1`, `arquivo` ### 💡 Dica 3: Revise Antes de Gerar PDF Sempre visualize o preview antes de gerar o PDF final. ### 💡 Dica 4: Use Tags para Busca Adicione tags relevantes aos documentos para facilitar busca posterior. ### 💡 Dica 5: Mantenha Backups Exporte seus databooks regularmente como backup. ### 💡 Dica 6: Organize Hierarquicamente Use a numeração hierárquica: - `1` - Tópico principal - `1.1` - Subtópico - `1.1.1` - Sub-subtópico ### 💡 Dica 7: Aproveite a Sincronização Configure mapeamento de pastas para sincronizar automaticamente. --- ## Atalhos de Teclado | Atalho | Ação | |--------|------| | `Ctrl + S` | Salvar | | `Ctrl + N` | Novo | | `Ctrl + Z` | Desfazer | | `Ctrl + Y` | Refazer | | `Esc` | Fechar modal | --- ## Perguntas Frequentes ### P: Como faço para clonar um databook? R: No Dashboard, clique no ícone **📋 (Clonar)** ao lado do projeto. Uma cópia será criada com status "Rascunho". ### P: Posso editar um databook finalizado? R: Sim, mas recomenda-se criar uma nova revisão. Clique em **"Nova Revisão"** nas configurações. ### P: Qual é o tamanho máximo de arquivo? R: Até 50 MB por arquivo. Comprima se necessário. ### P: Como faço backup dos meus databooks? R: Exporte como PDF ou entre em contato com o administrador para backup do banco de dados. ### P: Posso compartilhar um databook com outro usuário? R: Sim, adicione o usuário no painel de configurações e defina as permissões. --- ## Suporte Encontrou um problema? Aqui estão os passos: 1. **Verifique a documentação** - Consulte este manual 2. **Limpe o cache** - Pressione `Ctrl + Shift + Delete` 3. **Recarregue a página** - Pressione `F5` 4. **Entre em contato** - Fale com o administrador --- ## Glossário | Termo | Significado | |-------|------------| | **Databook** | Documento técnico completo com múltiplas seções | | **Tópico** | Seção individual do databook | | **Categoria** | Classificação de tópicos por tipo | | **Documento** | Arquivo (PDF, imagem) adicionado a uma seção | | **Template** | Modelo pré-configurado de tópicos | | **Revisão** | Versão do databook | | **RLS** | Row Level Security - Segurança de dados | | **IA** | Inteligência Artificial para análise automática | --- ## Versão **SteelBook v1.0** - 2024 Desenvolvido com ❤️ para profissionais de engenharia. --- **Última atualização:** Novembro 2024 Para atualizações e novidades, visite o painel de configurações.