Backend para sistema de gestão de sala de aula, estruturado com Clean Architecture, Node.js, TypeScript e Express.
O projeto segue os princípios da Arquitetura Limpa, garantindo que as regras de negócio sejam isoladas de frameworks e detalhes técnicos:
src/domain: O coração do sistema. Contém Entidades e Interfaces de Repositórios. Independente de bibliotecas externas.src/application: Casos de Uso (Use Cases). Orquestra o fluxo de dados, comunicando-se com o domínio e as interfaces de infraestrutura.src/infrastructure: Camada externa. Contém implementações de banco de dados, controladores HTTP (Express), rotas e configurações.
- Linguagem: TypeScript
- Servidor: Express
- Gerenciador de Pacotes: Yarn
- Qualidade: ESLint e Prettier
- Hooks: Husky e lint-staged
-
Instale as dependências:
yarn install
-
O Husky deve ser instalado automaticamente, mas se necessário:
yarn prepare
yarn dev: Inicia o servidor em modo de desenvolvimento com hot-reload.yarn build: Compila o código TypeScript para JavaScript na pastadist/.yarn start: Executa o código compilado (necessário rodar build antes).yarn lint: Executa o linter para verificar padrões de código.yarn format: Formata o código automaticamente seguindo o Prettier.
O projeto conta com arquivos de instruções para assistentes de IA (.copilot-instructions.md e CLAUDE.md), facilitando a manutenção e geração de código condizente com a arquitetura proposta.
Este projeto está sob a licença MIT.