174 lines
4.8 KiB
Markdown
174 lines
4.8 KiB
Markdown
# 📚 Documentação SteelBook
|
|
|
|
Bem-vindo à documentação completa do SteelBook! Aqui você encontrará tudo que precisa saber sobre a plataforma.
|
|
|
|
## 📖 Documentos Disponíveis
|
|
|
|
### Para Usuários Finais
|
|
|
|
#### [Manual do Usuário](MANUAL_USUARIO.md) 📘
|
|
Guia completo e didático para usar o SteelBook.
|
|
|
|
**Conteúdo:**
|
|
- Primeiros passos e login
|
|
- Navegação pelo Dashboard
|
|
- Criando seu primeiro databook
|
|
- Gerenciando documentos
|
|
- Tópicos e categorias
|
|
- Configurações da plataforma
|
|
- Gerando PDFs profissionais
|
|
- Dicas e truques
|
|
- Perguntas frequentes
|
|
- Glossário de termos
|
|
|
|
**Ideal para:** Usuários novos, gerentes de projeto, engenheiros
|
|
|
|
---
|
|
|
|
### Para Desenvolvedores
|
|
|
|
#### [Arquitetura Técnica](ARQUITETURA_TECNICA.md) 🏗️
|
|
Documentação técnica detalhada sobre a arquitetura do sistema.
|
|
|
|
**Conteúdo:**
|
|
- Visão geral da arquitetura
|
|
- Stack tecnológico
|
|
- Estrutura do banco de dados (13 tabelas)
|
|
- Relacionamentos entre tabelas
|
|
- Fluxo de dados
|
|
- Componentes principais
|
|
- Autenticação e segurança
|
|
- Queries importantes
|
|
- Variáveis de ambiente
|
|
- Deployment
|
|
- Troubleshooting
|
|
|
|
**Ideal para:** Desenvolvedores, arquitetos, DevOps
|
|
|
|
---
|
|
|
|
## 🎯 Começar Rápido
|
|
|
|
### Sou um Usuário Novo
|
|
1. Leia [Primeiros Passos](MANUAL_USUARIO.md#primeiros-passos) no Manual do Usuário
|
|
2. Explore o [Dashboard](MANUAL_USUARIO.md#dashboard)
|
|
3. Crie seu [Primeiro Databook](MANUAL_USUARIO.md#criando-um-databook)
|
|
|
|
### Sou um Desenvolvedor
|
|
1. Entenda a [Arquitetura](ARQUITETURA_TECNICA.md#arquitetura-do-sistema)
|
|
2. Estude o [Banco de Dados](ARQUITETURA_TECNICA.md#banco-de-dados)
|
|
3. Configure o [Ambiente](ARQUITETURA_TECNICA.md#variáveis-de-ambiente)
|
|
|
|
---
|
|
|
|
## 📊 Estrutura da Documentação
|
|
|
|
```
|
|
docs/
|
|
├── README.md # Este arquivo
|
|
├── MANUAL_USUARIO.md # Guia para usuários finais
|
|
└── ARQUITETURA_TECNICA.md # Documentação técnica
|
|
```
|
|
|
|
---
|
|
|
|
## 🔍 Índice Rápido
|
|
|
|
### Conceitos Principais
|
|
|
|
| Conceito | Descrição | Documentação |
|
|
|----------|-----------|--------------|
|
|
| **Databook** | Documento técnico completo | [Manual](MANUAL_USUARIO.md#glossário) |
|
|
| **Tópico** | Seção individual do databook | [Manual](MANUAL_USUARIO.md#tópicos-e-categorias) |
|
|
| **Categoria** | Classificação de tópicos | [Manual](MANUAL_USUARIO.md#categorias) |
|
|
| **Documento** | Arquivo adicionado a uma seção | [Manual](MANUAL_USUARIO.md#gerenciando-documentos) |
|
|
| **Template** | Modelo pré-configurado | [Manual](MANUAL_USUARIO.md#criando-um-databook) |
|
|
| **Progresso** | Percentual de conclusão | [Manual](MANUAL_USUARIO.md#entendendo-o-progresso) |
|
|
|
|
### Funcionalidades
|
|
|
|
| Funcionalidade | Usuário | Desenvolvedor |
|
|
|----------------|--------|---------------|
|
|
| Criar Databook | [Manual](MANUAL_USUARIO.md#criando-um-databook) | [Arquitetura](ARQUITETURA_TECNICA.md#fluxo-de-dados) |
|
|
| Upload Documentos | [Manual](MANUAL_USUARIO.md#adicionando-documentos) | [Arquitetura](ARQUITETURA_TECNICA.md#upload-de-documentos) |
|
|
| Gerar PDF | [Manual](MANUAL_USUARIO.md#gerando-pdf) | [Arquitetura](ARQUITETURA_TECNICA.md#geração-de-pdf) |
|
|
| Configurações | [Manual](MANUAL_USUARIO.md#configurações) | [Arquitetura](ARQUITETURA_TECNICA.md#componentes-principais) |
|
|
|
|
---
|
|
|
|
## 🆘 Precisa de Ajuda?
|
|
|
|
### Problema Comum?
|
|
Consulte a seção [Perguntas Frequentes](MANUAL_USUARIO.md#perguntas-frequentes) do Manual do Usuário.
|
|
|
|
### Erro Técnico?
|
|
Veja [Troubleshooting](ARQUITETURA_TECNICA.md#troubleshooting) na Arquitetura Técnica.
|
|
|
|
### Não encontrou?
|
|
Entre em contato com o time de desenvolvimento.
|
|
|
|
---
|
|
|
|
## 📝 Convenções
|
|
|
|
### Ícones Usados
|
|
|
|
- 📘 Manual do Usuário
|
|
- 🏗️ Arquitetura Técnica
|
|
- 💡 Dica
|
|
- ⚠️ Aviso
|
|
- ✅ Sucesso
|
|
- ❌ Erro
|
|
- 🔐 Segurança
|
|
|
|
### Formatação
|
|
|
|
- **Negrito** - Termos importantes
|
|
- `Código` - Comandos e código
|
|
- > Citação - Notas importantes
|
|
- ```sql - Blocos de código
|
|
|
|
---
|
|
|
|
## 🔄 Versão e Atualizações
|
|
|
|
**Versão Atual:** 1.0.0
|
|
**Última Atualização:** Novembro 2024
|
|
|
|
### Histórico de Versões
|
|
|
|
- **v1.0.0** (Nov 2024) - Lançamento inicial
|
|
- Manual do Usuário completo
|
|
- Arquitetura Técnica detalhada
|
|
- Documentação de todas as funcionalidades
|
|
|
|
---
|
|
|
|
## 📞 Contato e Suporte
|
|
|
|
- **Email:** support@steelbook.dev
|
|
- **GitHub:** [SteelBook Issues](https://github.com/steelbook/issues)
|
|
- **Documentação:** Este arquivo
|
|
|
|
---
|
|
|
|
## 📄 Licença
|
|
|
|
Esta documentação está licenciada sob a Licença MIT.
|
|
|
|
---
|
|
|
|
## 🙏 Contribuindo
|
|
|
|
Encontrou um erro na documentação? Quer adicionar algo?
|
|
|
|
1. Abra uma issue no GitHub
|
|
2. Envie um pull request com as mudanças
|
|
3. Descreva claramente o que foi alterado
|
|
|
|
---
|
|
|
|
**Desenvolvido com ❤️ para profissionais de engenharia.**
|
|
|
|
Última atualização: Novembro 2024
|