# 📋 Índice do Repositório Mangaba AI

## 🚀 Início Rápido

### Para Iniciantes
1. 📖 [Curso Básico](docs/CURSO_BASICO.md) - **Comece aqui!**
2. 🔧 [Guia de Configuração](docs/SETUP.md)
3. 🧪 [Teste Rápido](#teste-rapido)

### Para Desenvolvedores
1. 📁 [Estrutura do Projeto](ESTRUTURA.md)
2. 🌐 [Protocolos](docs/PROTOCOLS.md)
3. 🔧 [Scripts](docs/SCRIPTS.md)

# 📋 Índice do Repositório Mangaba AI

## 🌟 **PORTAL PRINCIPAL**

### 📖 **[WIKI AVANÇADA COMPLETA](docs/WIKI.md)**
*Seu ponto de partida para toda a documentação - Portal central da Wiki*

---

## 🚀 Início Rápido

### Para Iniciantes
1. 🌟 **[Portal da Wiki](docs/WIKI.md)** - **Comece aqui!**
2. 🎓 **[Curso Básico](docs/CURSO_BASICO.md)** - Tutorial completo
3. ⚙️ **[Configuração](docs/SETUP.md)** - Setup passo-a-passo
4. ❓ **[FAQ](docs/FAQ.md)** - Perguntas frequentes

### Para Desenvolvedores
1. 📁 **[Estrutura do Projeto](ESTRUTURA.md)** - Organização
2. 🌐 **[Protocolos](docs/PROTOCOLS.md)** - A2A e MCP
3. ⭐ **[Melhores Práticas](docs/MELHORES_PRATICAS.md)** - Boas práticas
4. 🤝 **[Contribuição](docs/CONTRIBUICAO.md)** - Como contribuir

## 📚 Wiki Avançada Completa

| Documento | Descrição | Público | Tempo |
|-----------|-----------|---------|-------|
| 🌟 **[WIKI.md](docs/WIKI.md)** | **Portal principal da wiki** | Todos | 5-10 min |
| 🎓 **[CURSO_BASICO.md](docs/CURSO_BASICO.md)** | Curso completo para iniciantes | Iniciantes | 30-45 min |
| ⚙️ **[SETUP.md](docs/SETUP.md)** | Guia detalhado de configuração | Todos | 15-20 min |
| 🌐 **[PROTOCOLS.md](docs/PROTOCOLS.md)** | Documentação técnica A2A/MCP | Desenvolvedores | 45-60 min |
| ⭐ **[MELHORES_PRATICAS.md](docs/MELHORES_PRATICAS.md)** | Guia de boas práticas | Intermediário+ | 20-30 min |
| 🤝 **[CONTRIBUICAO.md](docs/CONTRIBUICAO.md)** | Diretrizes de contribuição | Contribuidores | 25-35 min |
| ❓ **[FAQ.md](docs/FAQ.md)** | Perguntas e respostas comuns | Todos | 10-15 min |
| 📝 **[GLOSSARIO.md](docs/GLOSSARIO.md)** | Definições de termos técnicos | Todos | Consulta |
| 🔧 **[SCRIPTS.md](docs/SCRIPTS.md)** | Documentação dos scripts | Usuários | 15-20 min |
| 📊 **[CHANGELOG.md](docs/CHANGELOG.md)** | Histórico de mudanças | Todos | Consulta |
| 📁 **[ESTRUTURA.md](ESTRUTURA.md)** | Organização do repositório | Desenvolvedores | 10-15 min |

## 🔧 Scripts Disponíveis

| Script | Função | Quando Usar |
|--------|--------|-------------|
| [`quick_setup.py`](scripts/quick_setup.py) | Configuração automática | 🚀 Primeira vez |
| [`validate_env.py`](scripts/validate_env.py) | Validação do ambiente | ✅ Verificar setup |
| [`example_env_usage.py`](scripts/example_env_usage.py) | Exemplo de configuração | 📖 Aprender |
| [`exemplo_curso_basico.py`](scripts/exemplo_curso_basico.py) | Exemplos práticos | 🎓 Curso |
| [`setup_env.py`](scripts/setup_env.py) | Configuração manual | 🔧 Personalizar |

## 📖 Exemplos de Uso

### Por Área
- 🏥 [Médico](examples/medical_example.py)
- ⚖️ [Jurídico](examples/legal_example.py)
- 💰 [Financeiro](examples/finance_example.py)
- 📊 [Marketing](examples/marketing_example.py)
- 🏢 [Administração](examples/administration_example.py)
- 📄 [Análise de Documentos](examples/document_analysis_example.py)
- 🤖 [Automação de Tarefas](examples/task_automation_example.py)
- 🌐 [Tradução](examples/translation_example.py)
- 📈 [ML & Analytics](examples/ml_analytics_example.py)
- 🔗 [Integração API](examples/api_integration_example.py)
- 📝 [Análise de Texto](examples/text_analysis_example.py)

### Por Nível
- 🎯 [Básico](examples/basic_example.py) - **Comece aqui!**
- 🔧 [Intermediário](scripts/exemplo_curso_basico.py)
- 🚀 [Avançado](docs/PROTOCOLS.md)

## 🧪 Teste Rápido

```bash
# 1. Configuração rápida
python scripts/quick_setup.py

# 2. Validar ambiente
python scripts/validate_env.py

# 3. Testar exemplo
python scripts/example_env_usage.py

# 4. Exemplos do curso
python scripts/exemplo_curso_basico.py

# 5. Exemplo interativo
python examples/basic_example.py
```

## 🗂️ Estrutura Organizada

```
mangaba_ai/
├── 🌟 docs/WIKI.md           # Portal principal da wiki
├── 📚 docs/                  # Wiki avançada completa
│   ├── CURSO_BASICO.md       # Curso para iniciantes
│   ├── SETUP.md              # Guia de configuração
│   ├── PROTOCOLS.md          # Documentação A2A/MCP
│   ├── MELHORES_PRATICAS.md  # Guia de boas práticas
│   ├── CONTRIBUICAO.md       # Como contribuir
│   ├── FAQ.md                # Perguntas frequentes
│   ├── GLOSSARIO.md          # Glossário de termos
│   ├── SCRIPTS.md            # Documentação scripts
│   └── CHANGELOG.md          # Histórico de mudanças
├── 🔧 scripts/               # Scripts de configuração
├── 📖 examples/              # Exemplos práticos
├── 🌐 protocols/             # Protocolos de comunicação
├── 🛠️ utils/                 # Utilitários
├── 🧪 tests/                 # Testes automatizados
└── 📋 INDICE.md              # Este arquivo
```

## 🎯 Fluxos de Trabalho

### 🆕 Primeiro Uso
1. 🌟 **[Portal da Wiki](docs/WIKI.md)** - Visão geral e navegação
2. 🎓 **[Curso Básico](docs/CURSO_BASICO.md)** - Aprenda os conceitos
3. ⚙️ **[Configuração](docs/SETUP.md)** - Configure seu ambiente
4. 🧪 **[Validação](scripts/validate_env.py)** - Teste a instalação
5. 📖 **[Exemplo Básico](examples/basic_example.py)** - Primeiro teste

### 🔧 Desenvolvimento
1. 📁 **[Estrutura](ESTRUTURA.md)** - Organização do projeto
2. 🌐 **[Protocolos](docs/PROTOCOLS.md)** - A2A e MCP
3. ⭐ **[Melhores Práticas](docs/MELHORES_PRATICAS.md)** - Boas práticas
4. 🤝 **[Contribuição](docs/CONTRIBUICAO.md)** - Como contribuir
5. 🧪 **[Testes](tests/)** - Executar testes

### 🐛 Solução de Problemas
1. ❓ **[FAQ](docs/FAQ.md)** - Dúvidas comuns
2. 🔧 **[Validação](scripts/validate_env.py)** - Diagnóstico
3. 📝 **[Glossário](docs/GLOSSARIO.md)** - Definições
4. 🔧 **[Scripts](docs/SCRIPTS.md)** - Ferramentas de debug
5. 📊 **[Changelog](docs/CHANGELOG.md)** - Mudanças recentes

---

> 🌟 **Portal Principal**: Comece sempre pela **[Wiki](docs/WIKI.md)** - É o coração da documentação!

> 🆘 **Precisa de ajuda?** Consulte o **[FAQ](docs/FAQ.md)** ou veja as **[Diretrizes de Contribuição](docs/CONTRIBUICAO.md)**

> 🚀 **Quer começar rápido?** Execute `python scripts/quick_setup.py` e depois visite a **[Wiki](docs/WIKI.md)**