SeniorXMenuComponents

Uma biblioteca Angular especializada que fornece os componentes de menu para a plataforma da Senior Sistemas. Esta biblioteca contém todos os componentes internos necessários para construir o menu de navegação principal do sistema.

📋 Características

• ✅ Angular 18 - Suporte à versão mais recente do Angular
• ✅ Componentes - Conjunto de componentes desenvolvidos especificamente para o menu
• ✅ Standalone Components - Componentes independentes para melhor performance
• ✅ TypeScript - Totalmente tipado com TypeScript
• ✅ Tailwind CSS - Estilização moderna e responsiva
• ✅ Internacionalização - Suporte a múltiplos idiomas (pt-BR, en-US, es-CO)
• ✅ Integração Plataforma - Desenvolvido especificamente para o ecossistema Senior

🚀 Instalação

npm install leon-teste

Componentes Internos

Os seguintes componentes são desenvolvidos internamente para compor o menu principal:

• SidebarHeaderComponent - Cabeçalho do menu com informações do usuário
• Outros componentes - Em desenvolvimento para funcionalidades específicas do menu

💻 Desenvolvimento

Pré-requisitos

• Node.js 18+
• npm 9+
• Angular CLI 18+

Configuração do ambiente

# Clone o repositório
git clone <repository-url>
cd senior-x-menu

# Instale as dependências
npm install

# Inicie o servidor de desenvolvimento
npm start

Scripts disponíveis

| Script | Descrição | | ----------------------- | ------------------------------------------------- | | npm start | Inicia o servidor de desenvolvimento com showcase | | npm run build | Compila a biblioteca para produção | | npm test | Executa os testes unitários | | npm run test:coverage | Executa testes com relatório de cobertura | | npm run lint | Verifica a qualidade do código |

🏗️ Estrutura do Projeto

senior-x-menu/
├── projects/
│   ├── senior-x-menu/              # Biblioteca do menu sidebar
│   │   ├── src/
│   │   │   ├── lib/
│   │   │   │   ├── components/     # Componentes internos do menu
│   │   │   │   │   ├── sidebar-header/    # Cabeçalho do menu
│   │   │   │   │   ├── doc-alert/         # Componente de alertas
│   │   │   │   │   └── [outros...]        # Novos componentes em desenvolvimento
│   │   │   │   ├── locale/         # Tradução para múltiplos idiomas
│   │   │   │   └── styles/         # Estilos Tailwind personalizados
│   │   │   └── public-api.ts       # Exporta apenas o menu principal
│   │   └── package.json
│   └── showcase/                   # Demonstração dos componentes
│       └── src/
│           └── Components/         # Exemplos de uso dos componentes
└── README.md

Arquitetura dos Componentes

• Componentes Internos: Desenvolvidos dentro da biblioteca para funcionalidades específicas do menu
• Menu Principal: Componente que agrega todos os componentes internos
• API Pública: Expõe apenas o componente principal do menu
• Showcase: Ambiente de desenvolvimento e demonstração dos componentes

🌍 Internacionalização

A biblioteca suporta os seguintes idiomas:

• 🇧🇷 Português Brasileiro (pt-BR)
• 🇺🇸 Inglês Americano (en-US)
• 🇨🇴 Espanhol Colombiano (es-CO)

🧪 Testes

Execute os testes unitários:

npm test

Para testes com cobertura:

npm run test:coverage

📝 Showcase e Desenvolvimento

O projeto inclui uma aplicação showcase para desenvolvimento e demonstração dos componentes internos:

npm start

Acesse http://localhost:4200 para visualizar:

• Componentes em desenvolvimento - Visualização individual dos componentes internos
• Menu completo - Prévia do componente principal montado
• Testes de integração - Validação da funcionalidade do menu na plataforma

💡 Para Desenvolvedores: Use o showcase para desenvolver e testar novos componentes antes de integrá-los ao menu principal.

🤝 Contribuição

1. Crie uma branch para sua feature (git checkout -b feature/nova-feature)
2. Commit suas mudanças (git commit -m 'Adiciona nova feature')
3. Push para a branch (git push origin feature/nova-feature)
4. Abra um Pull Request

Padrões de desenvolvimento

• Componentes: Desenvolvidos como standalone components
• Nomenclatura: Use prefixo sx- para seletores dos componentes
• TypeScript: Tipagem forte obrigatória para todas as interfaces
• Testes: Cobertura completa para componentes internos e menu principal
• ESLint: Siga os padrões configurados do projeto
• Commits: Use conventional commits para versionamento
• API Pública: Apenas o menu principal deve ser exportado via public-api.ts

📄 Licença

Este projeto é propriedade da Senior Sistemas. Todos os direitos reservados.

🆘 Suporte

Para dúvidas e suporte:

• 📧 Canal: [Link do canal do time]
• 📚 Documentação: [Link para a documentação]
• 🐛 Bugs: Abra uma issue para [Link do projeto no Jira]

Desenvolvido com ❤️ pela equipe da Senior Sistemas