# 📚 Documentação do Mangaba AI

Esta pasta contém a **Wiki Avançada** completa do projeto Mangaba AI, organizada para atender tanto iniciantes quanto usuários avançados.

## 🌟 **Portal de Entrada - Wiki Avançada**

### 📖 **[WIKI.md](WIKI.md) - Portal Principal da Wiki**
*Seu ponto de partida para toda a documentação do projeto*

## 📚 **Documentação Completa**

### 🎓 **Para Iniciantes**
| Documento | Descrição | Tempo de Leitura |
|-----------|-----------|------------------|
| 📖 [WIKI.md](WIKI.md) | **Portal principal** - Visão geral e navegação | 5-10 min |
| 🎓 [CURSO_BASICO.md](CURSO_BASICO.md) | Curso completo passo-a-passo | 30-45 min |
| ⚙️ [SETUP.md](SETUP.md) | Guia detalhado de instalação | 15-20 min |
| ❓ [FAQ.md](FAQ.md) | Perguntas e respostas frequentes | 10-15 min |

### 👨‍💻 **Para Desenvolvedores**
| Documento | Descrição | Público |
|-----------|-----------|---------|
| 🌐 [PROTOCOLS.md](PROTOCOLS.md) | Documentação técnica A2A e MCP | Desenvolvedores |
| ⭐ [MELHORES_PRATICAS.md](MELHORES_PRATICAS.md) | Guia de boas práticas | Intermediário+ |
| 🤝 [CONTRIBUICAO.md](CONTRIBUICAO.md) | Como contribuir com o projeto | Todos |
| 📝 [GLOSSARIO.md](GLOSSARIO.md) | Definições de termos técnicos | Todos |

### 🛠️ **Recursos Técnicos**
| Documento | Descrição | Quando Consultar |
|-----------|-----------|------------------|
| 🔧 [SCRIPTS.md](SCRIPTS.md) | Documentação dos scripts | Configuração e automação |
| 📊 [CHANGELOG.md](CHANGELOG.md) | Histórico de mudanças | Atualizações e versões |
| 📁 [../ESTRUTURA.md](../ESTRUTURA.md) | Organização do repositório | Desenvolvimento |

## 🎯 **Fluxos de Navegação Recomendados**

### 🆕 **Primeira Vez no Projeto**
1. 👀 Comece pelo **[Portal da Wiki](WIKI.md)**
2. 📖 Siga o **[Curso Básico](CURSO_BASICO.md)**
3. ⚙️ Configure com o **[Setup](SETUP.md)**
4. ❓ Tire dúvidas no **[FAQ](FAQ.md)**

### 🔧 **Desenvolvimento e Personalização**
1. 📁 Entenda a **[Estrutura](../ESTRUTURA.md)**
2. 🌐 Domine os **[Protocolos](PROTOCOLS.md)**
3. ⭐ Aplique as **[Melhores Práticas](MELHORES_PRATICAS.md)**
4. 📝 Consulte o **[Glossário](GLOSSARIO.md)** quando necessário

### 🤝 **Contribuição**
1. 📖 Leia **[Como Contribuir](CONTRIBUICAO.md)**
2. ⭐ Siga as **[Melhores Práticas](MELHORES_PRATICAS.md)**
3. 🔧 Use os **[Scripts](SCRIPTS.md)** de validação
4. 📊 Acompanhe o **[Changelog](CHANGELOG.md)**

## 🚀 **Links Rápidos**

### **🎯 Ações Imediatas**
- 🚀 **Começar agora**: [Portal da Wiki](WIKI.md)
- ⚙️ **Configurar**: [Setup Completo](SETUP.md)
- 🧪 **Testar**: [Exemplos](../examples/)
- 🤝 **Contribuir**: [Diretrizes](CONTRIBUICAO.md)

### **📞 Suporte**
- ❓ **Dúvidas**: [FAQ](FAQ.md)
- 💬 **Discussões**: [GitHub Discussions](https://github.com/Mangaba-ai/mangaba_ai/discussions)
- 🐛 **Problemas**: [GitHub Issues](https://github.com/Mangaba-ai/mangaba_ai/issues)
- 📝 **Termos**: [Glossário](GLOSSARIO.md)

## 📁 **Estrutura da Wiki**

```
docs/                           # 📚 Wiki Avançada
├── README.md                   # 📖 Este arquivo (índice da documentação)
├── WIKI.md                     # 🌟 Portal principal da wiki
├── CURSO_BASICO.md            # 🎓 Curso completo para iniciantes
├── SETUP.md                   # ⚙️ Guia de instalação e configuração
├── PROTOCOLS.md               # 🌐 Documentação técnica dos protocolos
├── MELHORES_PRATICAS.md       # ⭐ Guia de boas práticas
├── CONTRIBUICAO.md            # 🤝 Diretrizes de contribuição
├── FAQ.md                     # ❓ Perguntas frequentes
├── GLOSSARIO.md               # 📝 Glossário de termos
├── SCRIPTS.md                 # 🔧 Documentação dos scripts
└── CHANGELOG.md               # 📊 Histórico de mudanças
```

## 🌟 **Características da Wiki**

### ✅ **O que você encontrará**
- 📖 **Documentação completa** em português brasileiro
- 🎯 **Conteúdo estruturado** por nível de experiência
- 💡 **Exemplos práticos** com código real
- 🔗 **Navegação intuitiva** entre seções
- 🔍 **Busca eficiente** com índices detalhados

### 🎯 **Público-Alvo**
- 🆕 **Iniciantes**: Primeiros passos e conceitos básicos
- 🔧 **Intermediários**: Customização e melhores práticas
- 👨‍💻 **Avançados**: Desenvolvimento e contribuição
- 🏢 **Empresas**: Implementação em produção

## 📊 **Estatísticas da Wiki**

| Métrica | Valor |
|---------|-------|
| 📄 **Total de páginas** | 10+ |
| 📝 **Palavras** | 50.000+ |
| 💻 **Exemplos de código** | 100+ |
| 🔗 **Links internos** | 200+ |
| 🌐 **Idioma** | Português brasileiro |

---

## 💡 **Dicas de Navegação**

### 🔍 **Para Encontrar Informações Rapidamente**
1. **Use o [Portal da Wiki](WIKI.md)** como ponto central
2. **Consulte o [FAQ](FAQ.md)** para dúvidas comuns  
3. **Busque no [Glossário](GLOSSARIO.md)** para termos técnicos
4. **Use Ctrl+F** para buscar termos específicos em qualquer página

### 📱 **Para Mobile/Tablet**
- Todos os documentos são responsivos
- Use os índices no topo de cada página
- Navegação por links funcionais
- Estrutura hierárquica clara

---

> 🌟 **Bem-vindo à Wiki Avançada do Mangaba AI!**
> 
> Esta documentação foi criada com muito carinho para a comunidade brasileira de desenvolvedores. Esperamos que ela seja útil em sua jornada com IA!

> 🎯 **Dica**: Marque o [Portal da Wiki](WIKI.md) nos seus favoritos - é seu ponto central de navegação!

---

*Última atualização: Dezembro 2024 | Wiki Versão: 1.0 | Mantida pela comunidade Mangaba AI*