# 📋 MCO - Project Structure Guidelines

## 🎯 **IMPORTANTE: Localização Correta do Projeto idt_app**

### 📍 **Caminho Base Correto:**
```
/Users/ceogrouppra/projects/front/web/angular/projects/idt_app/src
```

### ⚠️ **SEMPRE USAR ESTE CAMINHO:**
- ✅ **Correto**: `projects/idt_app/src/app/shared/components/...`
- ❌ **Incorreto**: `src/app/shared/components/...` (pasta raiz angular)
- ❌ **Incorreto**: `angular/src/app/shared/components/...` (fora do projeto)

## 🗂️ **Estrutura do Projeto Angular:**

```
/Users/ceogrouppra/projects/front/web/angular/
├── projects/
│   └── idt_app/                    ← PROJETO PRINCIPAL
│       ├── src/                    ← SEMPRE TRABALHAR AQUI
│       │   ├── app/
│       │   │   ├── shared/
│       │   │   │   ├── components/
│       │   │   │   └── services/
│       │   │   └── domain/
│       │   └── assets/
│       └── angular.json
└── src/                           ← NÃO USAR (Angular raiz)
    └── app/
```

## 🔍 **Como Identificar o Local Correto:**

### ✅ **Sinais de que está no lugar certo:**
- Path contém `projects/idt_app/src`
- Existe arquivo `projects/idt_app/angular.json`
- Imports funcionam: `../../shared/components/...`

### ❌ **Sinais de que está no lugar errado:**
- Path não contém `projects/idt_app`
- Imports quebrados ou com muitos `../`
- Arquivos não aparecem no build

## 📝 **Lições Aprendidas:**

### 🚨 **Problema que Resolvemos:**
- Criamos arquivos em `/angular/src/` (pasta raiz)
- Build não detectava as mudanças
- Sidebar não atualizava apesar das modificações
- **Solução**: Mover para `projects/idt_app/src/`

### 🎯 **Regra de Ouro:**
> **SEMPRE verificar se o path contém `projects/idt_app/src` antes de criar/editar arquivos**

## 🛠️ **Verificação Rápida:**

### Terminal Check:
```bash
pwd
# Deve retornar: /Users/ceogrouppra/projects/front/web/angular/projects/idt_app
```

### File Search Check:
```bash
ls -la src/app/shared/components/
# Deve listar: sidebar/, tab-system/, etc.
```

## 📚 **Ferramentas de Desenvolvimento:**

### **Build Command:**
```bash
cd /Users/ceogrouppra/projects/front/web/angular/projects/idt_app
ng build
```

### **Dev Server:**
```bash
cd /Users/ceogrouppra/projects/front/web/angular/projects/idt_app  
ng serve
```

---

## 🎯 **RESUMO EXECUTIVO:**

**SEMPRE trabalhar dentro de:** `projects/idt_app/src/`
**NUNCA criar arquivos em:** `angular/src/` ou outras pastas

Esta documentação evitará perda de tempo com arquivos em locais incorretos.

---
*Criado após resolução do problema da sidebar - Evitar repetição de erros de localização*