admtracksteel/dbmaker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4592338fdf982e1c6277cd5beb2ef541aba06f11
dbmaker/docs/MANUAL_USUARIO.md

10 KiB
Raw Blame History

📚 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
  2. Dashboard
  3. Criando um Databook
  4. Gerenciando Documentos
  5. Tópicos e Categorias
  6. Configurações
  7. Gerando PDF
  8. 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.

Reference in New Issue View Git Blame Copy Permalink