Configuración del proyecto

Sinopsis del proyecto

Nombre: Plataforma de Comercio Electrónico
Tech Stack: Node.js, PostgreSQL, React 18, Docker
Tamaño del equipo: 5 desarrolladores
Plazo: Q4 2025

Arquitectura

@docs/architecture.md @docs/api-standards.md @docs/database-schema.md

Normas de desarrollo

Estilo de código

Usar Prettier para formatear
Usar ESLint con configuración de airbnb
Longitud máxima de línea: 100 caracteres
Usar sangría de 2 espacios

Convenios sobre la designación de nombres

Archivos: kebab-case (user-controller.js)
Clases: PascalCase (UserService)
Functions/Variables: camelCase (getUserById)
Constantes: UPPER_SNAKE_CASE (API_BASE_URL)
Tablas de bases de datos: snake_case (usuario_cuentas)

Flujo de trabajo de Git

Nombres de las ramas: feature/description o fix/description
Mensajes de comisión: Seguir los compromisos convencionales
PR requerida antes de la fusión
Todos los controles CI/CD deben pasar
Mínimo 1 aprobación requerida

Requisitos de ensayo

Cobertura mínima de código del 80%
Todos los caminos críticos deben tener pruebas
Usar Jest para las pruebas unitarias
Utilizar el ciprés para las pruebas E2E
Nombres de archivo de prueba: *.test.ts o *.spec.ts

Normas API

Únicamente los puntos finales RESTful
Solicitud/respuesta de JSON
Usar códigos de estado HTTP correctamente
Endpoints API de versión: /api/v1/
Documentar todos los puntos finales con ejemplos

Base de datos

Usar migraciones para cambios de esquema
Nunca credenciales de código duro
Usar la conexión de conexión
Habilitar el registro de consultas en desarrollo
Se necesitan copias de seguridad periódicas

Despliegue

Despliegue basado en Docker
Kubernetes orquestación
Estrategia de despliegue verde-azul
Reversión automática en caso de fallo
Las migraciones de la base de datos se ejecutan antes de implementar

Comandos comunes

Comando	Finalidad
`npm run dev`	Iniciar servidor de desarrollo
`npm test`	Ejecutar la suite de pruebas
`npm run lint`	Comprobar el estilo de código
`npm run build`	Construcción para la producción
`npm run migrate`	Ejecutar migraciones de bases de datos

Contactos con el equipo

Tech Lead: Sarah Chen (@sarah.chen)
Director de producto: Mike Johnson (@mike.j)
DevOps: Alex Kim (@alex.k)

Problemas conocidos y soluciones

Posesión de conexión PostgreSQL limitada a 20 durante horas pico
Solución de problemas: Implementar la cola de consultas
Problemas de compatibilidad Safari 14 con generadores de sincronización
Solución: Utilice el transpilador Babel

Panel de control analítico: /projects/analytics
Aplicación móvil: /projects/mobile
Panel de administración: /projects/admin

Última actualización: 4 de agosto de 2026 Versión de Claude Code: 2.1.220 Fuentes: - https://code.claude.com/docs/en/memory Modelos compatibles: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5