# 📢 INSTRUÇÕES PARA SUA EQUIPE - Como Pedir Novo CRUD

**Para: Sua equipe**  
**De: Você** (após ler a documentação)  

---

## ⚡ RESUMO EXECUTIVO

Quando pedirem um novo CRUD:

1. **NÃO** precisa enviar os arquivos MD
2. **NÃO** precisa copiar o prompt inteiro
3. **SIM** pode usar a pasta `/DOCUMENTACAO_PADROES/` como referência
4. **SIM** pode fazer uma solicitação simples com os dados do módulo

---

## 📋 COMO PEDIR (para sua equipe)

### ✅ Forma Correta (Simples):

```
Crie um novo CRUD para:

Nome: dm_novo_modulo
Rótulo: "Seu Rótulo"

DDL:
[COLE AQUI O CREATE TABLE]

Referência: Padrão de dm_motorista/dm_grupopessoa
Documentação: Pasta /DOCUMENTACAO_PADROES/
```

### Ou ainda mais simples:

```
Novo CRUD:
- Nome: dm_novo_modulo
- Rótulo: "Seu Rótulo"
- DDL: [CREATE TABLE aqui]
- Padrão: dm_motorista
```

---

## ❌ O QUE NÃO FAZER

```
❌ NÃO envie toda a documentação novamente
❌ NÃO copie 10 MB de arquivos MD
❌ NÃO passe o prompt inteiro cada vez
❌ NÃO repita os padrões no pedido
```

---

## 📁 ESTRUTURA DE PASTA (Recomendado)

```
/sagadm/
├─ DOCUMENTACAO_PADROES/
│  ├─ LEIA_PRIMEIRO.md
│  ├─ QUICK_PADROES.md
│  ├─ FAQ_STATUS_SOFTDELETE.md
│  ├─ COMO_PEDIR_NOVO_CRUD.md
│  ├─ PROMPT_PADRAO_NOVO_CRUD.md
│  ├─ SNIPPETS_CODIGO_PADRAO.md
│  ├─ GUIA_CRIAR_NOVO_CRUD.md
│  ├─ PADROES_SISTEMA.md
│  ├─ INDICE_PADROES.md
│  ├─ CHEATSHEET_PADROES.md
│  └─ [outros arquivos]
│
├─ dm_motorista/
├─ dm_participante/
└─ [módulos]
```

---

## 🚀 PASSO-A-PASSO

### Para Sua Equipe:

**Passo 1: Prepare o DDL**
```sql
CREATE TABLE public.dim_novo_modulo (
	id serial4 NOT NULL PRIMARY KEY,
	empresa int4 NOT NULL,
	descricao varchar NOT NULL,
	status int4 DEFAULT 0 NOT NULL
);
```

**Passo 2: Envie uma mensagem simples ao Copilot**
```
Crie um novo CRUD para:
- Nome: dm_novo_modulo
- Rótulo: "Novo Módulo"
- DDL: [cole acima]
- Padrão: dm_motorista
- Documentação: /DOCUMENTACAO_PADROES/
```

**Passo 3: Pronto!**
Copilot saberá exatamente qual padrão seguir (está documentado na pasta)

---

## 💡 Por que assim?

### ✅ Vantagens:

1. **Mais rápido** - Equipe não precisa copiar 10MB de docs
2. **Mais limpo** - Solicitações curtas e diretas
3. **Mais fácil** - Menos informação desnecessária
4. **Sempre atualizado** - Documentação fica num lugar único
5. **Fácil revisar** - Basta consultar a pasta

### ❌ Problema se enviar tudo:

- Pedido fica GIGANTE
- Difícil ler o que é importante
- Se atualizar documentação, precisa repassar tudo de novo
- Poluição de contexto

---

## 📖 O que Cada Um Deve Saber

### Desenvolvedor Iniciante:
```
Antes de pedir um CRUD:
1. Leia: /DOCUMENTACAO_PADROES/LEIA_PRIMEIRO.md
2. Leia: /DOCUMENTACAO_PADROES/QUICK_PADROES.md
3. Prepare seu DDL
4. Envie solicitação simples (vide acima)
```

### Desenvolvedor Experiente:
```
Pede direto:
- Nome do módulo
- Rótulo
- DDL
- Referência: padrão de dm_motorista
- Sabe que está em /DOCUMENTACAO_PADROES/ se precisar
```

### Tech Lead:
```
Valida:
1. Solicitação está clara
2. DDL segue padrões (id, status, empresa)
3. Referencia documentação correta
```

---

## 🎯 TEMPLATE FINAL (Copie e compartilhe)

**Para usar:**

Copie isso e compartilhe com seu time:

```
═══════════════════════════════════════════════════════════════════

              ✅ COMO PEDIR UM NOVO CRUD AO COPILOT

═══════════════════════════════════════════════════════════════════

1. Leia a documentação em: /DOCUMENTACAO_PADROES/

2. Prepare seu DDL:
   CREATE TABLE public.dim_novo (
       id serial4 PRIMARY KEY,
       empresa int4 NOT NULL,
       campo1 varchar,
       status int4 DEFAULT 0 NOT NULL
   );

3. Envie mensagem simples:

   "Crie um novo CRUD:
    - Nome: dm_novo
    - Rótulo: Novo
    - DDL: [COLE AQUI]
    - Padrão: dm_motorista
    - Referência: /DOCUMENTACAO_PADROES/"

4. Pronto! Copilot saberá exatamente o que fazer

═══════════════════════════════════════════════════════════════════

Dúvidas? Consulte:
- FAQ: /DOCUMENTACAO_PADROES/FAQ_STATUS_SOFTDELETE.md
- Guia: /DOCUMENTACAO_PADROES/GUIA_CRIAR_NOVO_CRUD.md
- Rápido: /DOCUMENTACAO_PADROES/QUICK_PADROES.md

═══════════════════════════════════════════════════════════════════
```

---

## 🔄 Fluxo Completo

```
SEU DESENVOLVEDOR:
    ↓
Lê /DOCUMENTACAO_PADROES/LEIA_PRIMEIRO.md
    ↓
Prepara DDL
    ↓
Envia SOLICITAÇÃO SIMPLES ao Copilot
    ├─ Nome do módulo
    ├─ Rótulo
    ├─ DDL
    └─ Referência: padrão dm_motorista
    ↓
COPILOT (já tem acesso à pasta):
    ↓
Consulta /DOCUMENTACAO_PADROES/ conforme precisa
    ↓
Cria o CRUD seguindo padrão
    ↓
✅ PRONTO!
```

---

## 📞 Checklist antes de enviar

Dev antes de pedir:
- [ ] Leu LEIA_PRIMEIRO.md
- [ ] Preparou DDL com id, status, empresa
- [ ] Tem o nome do módulo
- [ ] Tem o rótulo
- [ ] Sabe que pode referenciar /DOCUMENTACAO_PADROES/

---

## ✅ RESUMO

| Item | Resposta |
|------|----------|
| Preciso enviar os arquivos MD? | ❌ NÃO |
| Posso referenciar a pasta? | ✅ SIM |
| Preciso copiar o prompt inteiro? | ❌ NÃO |
| Posso fazer solicitação simples? | ✅ SIM |
| Onde está a documentação? | `/DOCUMENTACAO_PADROES/` |
| Como o Copilot acessa? | Via contexto do workspace |

---

## 🎉 Resultado

**Sua equipe:**
- ✅ Não precisa memorizar nada
- ✅ Não precisa passar docs gigantes
- ✅ Pode fazer pedidos simples
- ✅ Tem documentação sempre disponível
- ✅ Padrão consistente em todos CRUDs

---

**Última atualização:** 27/01/2026  
**Versão:** 1.0  
**Status:** Pronto para compartilhar com equipe
