Configuração do Projeto

Visão Geral do Projeto

• Nome: Plataforma de E-commerce
• Stack Tecnológica: Node.js, PostgreSQL, React 18, Docker
• Dimensão da Equipa: 5 programadores
• Prazo: 4.º trimestre de 2025

Arquitetura

@docs/architecture.md

@docs/api-standards.md

@docs/database-schema.md

Normas de Desenvolvimento

Estilo de Código

• Use o Prettier para formatação
• Use o ESLint com a configuração airbnb
• Comprimento máximo de linha: 100 carateres
• Use indentação de 2 espaços

Convenções de Nomenclatura

• Ficheiros: kebab-case (user-controller.js)
• Classes: PascalCase (UserService)
• Funções/Variáveis: camelCase (getUserById)
• Constantes: UPPER_SNAKE_CASE (API_BASE_URL)
• Tabelas da Base de Dados: snake_case (user_accounts)

Fluxo de Trabalho Git

• Nomes de ramos: feature/description ou fix/description
• Mensagens de commit: siga o padrão conventional commits
• PR obrigatório antes do merge
• Todas as verificações de CI/CD têm de passar
• É necessário um mínimo de 1 aprovação

Requisitos de Testes

• Cobertura de código mínima de 80%
• Todos os caminhos críticos têm de ter testes
• Use o Jest para testes unitários
• Use o Cypress para testes E2E
• Nomes de ficheiros de teste: .test.ts ou .spec.ts

Normas de API

• Apenas endpoints RESTful
• Pedido/resposta em JSON
• Use os códigos de estado HTTP corretamente
• Versione os endpoints da API: /api/v1/
• Documente todos os endpoints com exemplos

Base de Dados

• Use migrações para alterações de schema
• Nunca incorpore credenciais no código
• Use agrupamento de ligações
• Ative o registo de consultas em desenvolvimento
• Cópias de segurança regulares obrigatórias

Implementação

• Implementação baseada em Docker
• Orquestração com Kubernetes
• Estratégia de implementação blue-green
• Reversão automática em caso de falha
• As migrações da base de dados são executadas antes da implementação

Comandos Comuns

Contactos da Equipa

• Tech Lead: Sarah Chen (@sarah.chen)
• Product Manager: Mike Johnson (@mike.j)
• DevOps: Alex Kim (@alex.k)

Problemas Conhecidos e Soluções Alternativas

• O agrupamento de ligações do PostgreSQL está limitado a 20 nas horas de ponta
• Solução alternativa: implemente uma fila de consultas
• Problemas de compatibilidade do Safari 14 com geradores assíncronos
• Solução alternativa: use o transpilador Babel

Projetos Relacionados

• Painel de Análises: /projects/analytics
• Aplicação Móvel: /projects/mobile
• Painel de Administração: /projects/admin

Última Atualização: 4 de agosto de 2026

Versão do Claude Code: 2.1.220

Fontes:

• https://code.claude.com/docs/en/memory

Modelos Compatíveis: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5