testes/Modulos Angular/projects/idt_app/docs/general/MCO_PROJECT_STRUCTURE.md

2.7 KiB

📋 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:

pwd
# Deve retornar: /Users/ceogrouppra/projects/front/web/angular/projects/idt_app

File Search Check:

ls -la src/app/shared/components/
# Deve listar: sidebar/, tab-system/, etc.

📚 Ferramentas de Desenvolvimento:

Build Command:

cd /Users/ceogrouppra/projects/front/web/angular/projects/idt_app
ng build

Dev Server:

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