docs: add project documentation and env template
Environment: - .env.example template with all configuration variables - Database, API, GraphQL, and frontend settings Documentation: - Architecture Decision Records (ADR-001 to ADR-004) - Deployment guide with Docker and K8s instructions - OWASP security checklist - Code review checklist - Activity plan and deliverables Architecture diagrams (PlantUML): - Use cases, domain model, sequence diagrams - Component, ER, state, and deployment diagrams - C4 context diagram Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Andrés Eduardo García Márquez
parent
9f11aab2a8
commit
3e62a94df7
|
|
@ -0,0 +1,42 @@
|
|||
# =============================================================================
|
||||
# Student Enrollment System - Environment Variables
|
||||
# =============================================================================
|
||||
# Copiar este archivo a .env y ajustar los valores
|
||||
# NUNCA commitear el archivo .env con credenciales reales
|
||||
# =============================================================================
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Database (SQL Server)
|
||||
# -----------------------------------------------------------------------------
|
||||
DB_HOST=localhost
|
||||
DB_PORT=1433
|
||||
DB_NAME=StudentEnrollment
|
||||
DB_USER=sa
|
||||
DB_PASSWORD=Your_Str0ng_P@ssword!
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# API (.NET)
|
||||
# -----------------------------------------------------------------------------
|
||||
ASPNETCORE_ENVIRONMENT=Development
|
||||
API_PORT=5000
|
||||
CORS_ORIGINS=http://localhost:4200
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# GraphQL
|
||||
# -----------------------------------------------------------------------------
|
||||
GRAPHQL_MAX_DEPTH=5
|
||||
GRAPHQL_MAX_COMPLEXITY=100
|
||||
GRAPHQL_INTROSPECTION=true
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Logging (Serilog)
|
||||
# -----------------------------------------------------------------------------
|
||||
LOG_LEVEL=Information
|
||||
LOG_PATH=logs/app-.log
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Frontend (Angular)
|
||||
# -----------------------------------------------------------------------------
|
||||
FRONTEND_PORT=4200
|
||||
GRAPHQL_URL=http://localhost:5000/graphql
|
||||
HEALTH_CHECK_URL=http://localhost:5000/health
|
||||
|
|
@ -0,0 +1,127 @@
|
|||
# Code Review Checklist - Sistema Registro Estudiantes
|
||||
|
||||
## Estado: Validado
|
||||
|
||||
### Arquitectura (Clean Architecture)
|
||||
|
||||
| Criterio | Estado | Evidencia |
|
||||
|----------|--------|-----------|
|
||||
| Separación de capas | ✅ | Domain, Application, Adapters, Host |
|
||||
| Regla de dependencia | ✅ | Domain no depende de nada externo |
|
||||
| Ports & Adapters | ✅ | IStudentRepository, IEnrollmentRepository |
|
||||
| CQRS implementado | ✅ | Commands y Queries separados |
|
||||
|
||||
### Principios SOLID
|
||||
|
||||
| Principio | Estado | Evidencia |
|
||||
|-----------|--------|-----------|
|
||||
| **S**ingle Responsibility | ✅ | Cada clase tiene una responsabilidad |
|
||||
| **O**pen/Closed | ✅ | Extensible via interfaces |
|
||||
| **L**iskov Substitution | ✅ | Repositorios intercambiables |
|
||||
| **I**nterface Segregation | ✅ | Interfaces específicas por entidad |
|
||||
| **D**ependency Inversion | ✅ | Inyección de dependencias |
|
||||
|
||||
### Clean Code
|
||||
|
||||
| Criterio | Estado | Notas |
|
||||
|----------|--------|-------|
|
||||
| Naming conventions | ✅ | PascalCase clases, camelCase variables |
|
||||
| Métodos pequeños | ✅ | < 20 líneas promedio |
|
||||
| Sin código duplicado | ✅ | DRY aplicado |
|
||||
| Comentarios mínimos | ✅ | Código autodocumentado |
|
||||
| Archivos < 100 líneas | ✅ | Refactorizado donde necesario |
|
||||
|
||||
### Seguridad
|
||||
|
||||
| Criterio | Estado | Ubicación |
|
||||
|----------|--------|-----------|
|
||||
| Input validation | ✅ | FluentValidation + Regex |
|
||||
| SQL Injection prevention | ✅ | EF Core parametrizado |
|
||||
| XSS prevention | ✅ | Sanitización en validators |
|
||||
| Security headers | ✅ | Program.cs middleware |
|
||||
| Rate limiting | ✅ | 100 req/min |
|
||||
| Query complexity limits | ✅ | Depth 5, complexity 100 |
|
||||
|
||||
### Testing
|
||||
|
||||
| Tipo | Cantidad | Cobertura |
|
||||
|------|----------|-----------|
|
||||
| Domain Tests | 30 | Entidades, ValueObjects, Services |
|
||||
| Application Tests | 66 | Commands, Queries, Validators |
|
||||
| Integration Tests | 5 | GraphQL flujo completo |
|
||||
| Angular Unit Tests | 24 | Services, Pipes |
|
||||
| E2E Tests (Playwright) | 20 | Flujos principales |
|
||||
| **Total** | **145** | |
|
||||
|
||||
### Convenciones de Código
|
||||
|
||||
#### Backend (.NET)
|
||||
|
||||
- [x] Async/await en operaciones I/O
|
||||
- [x] Records para DTOs inmutables
|
||||
- [x] Nullable habilitado
|
||||
- [x] Global usings configurados
|
||||
- [x] FluentValidation para validaciones
|
||||
|
||||
#### Frontend (Angular)
|
||||
|
||||
- [x] Standalone components
|
||||
- [x] Signals para estado reactivo
|
||||
- [x] Lazy loading por feature
|
||||
- [x] OnPush change detection
|
||||
- [x] Apollo Client para GraphQL
|
||||
|
||||
### GraphQL
|
||||
|
||||
| Criterio | Estado |
|
||||
|----------|--------|
|
||||
| Types bien definidos | ✅ |
|
||||
| DataLoaders para N+1 | ✅ |
|
||||
| Error handling | ✅ |
|
||||
| Payloads con errors | ✅ |
|
||||
| Depth limiting | ✅ |
|
||||
|
||||
### Performance
|
||||
|
||||
| Optimización | Implementada |
|
||||
|--------------|--------------|
|
||||
| Response compression | ✅ Brotli + Gzip |
|
||||
| Output caching | ✅ 5 min para subjects/professors |
|
||||
| Apollo cache | ✅ cache-and-network |
|
||||
| Lazy loading | ✅ Por feature module |
|
||||
| Bundle optimization | ✅ < 800KB initial |
|
||||
|
||||
### Documentación
|
||||
|
||||
| Documento | Estado |
|
||||
|-----------|--------|
|
||||
| README.md | ✅ |
|
||||
| CLAUDE.md | ✅ |
|
||||
| OWASP_CHECKLIST.md | ✅ |
|
||||
| GraphQL Schema | ✅ (Banana Cake Pop) |
|
||||
|
||||
---
|
||||
|
||||
## Checklist de Revisión Manual
|
||||
|
||||
### Antes de Merge
|
||||
|
||||
- [ ] Todos los tests pasan
|
||||
- [ ] Build sin errores ni warnings
|
||||
- [ ] Código formateado
|
||||
- [ ] Sin TODOs pendientes críticos
|
||||
- [ ] Variables de entorno documentadas
|
||||
|
||||
### Seguridad
|
||||
|
||||
- [ ] Sin secrets hardcodeados
|
||||
- [ ] Sin console.log en producción
|
||||
- [ ] Validaciones en frontend Y backend
|
||||
- [ ] Error messages no exponen detalles internos
|
||||
|
||||
### UX
|
||||
|
||||
- [ ] Loading states implementados
|
||||
- [ ] Error messages claros
|
||||
- [ ] Responsive design funcional
|
||||
- [ ] Accesibilidad básica (a11y)
|
||||
|
|
@ -0,0 +1,419 @@
|
|||
# Manual de Despliegue
|
||||
|
||||
## Requisitos del Sistema
|
||||
|
||||
| Componente | Versión Mínima |
|
||||
|------------|----------------|
|
||||
| .NET SDK | 10.0 |
|
||||
| Node.js | 22.x |
|
||||
| SQL Server | 2022 |
|
||||
| Docker | 24.x |
|
||||
| Docker Compose | 2.x |
|
||||
|
||||
## Variables de Entorno
|
||||
|
||||
### Backend (.NET)
|
||||
|
||||
| Variable | Descripción | Ejemplo |
|
||||
|----------|-------------|---------|
|
||||
| `ConnectionStrings__DefaultConnection` | Connection string SQL Server | `Server=db;Database=StudentEnrollment;...` |
|
||||
| `ASPNETCORE_ENVIRONMENT` | Ambiente | `Production` |
|
||||
| `ASPNETCORE_URLS` | URLs de escucha | `http://+:5000` |
|
||||
|
||||
### Frontend (Angular)
|
||||
|
||||
| Variable | Descripción | Ejemplo |
|
||||
|----------|-------------|---------|
|
||||
| `API_URL` | URL del backend GraphQL | `https://api.example.com/graphql` |
|
||||
|
||||
## Despliegue con Docker
|
||||
|
||||
### 1. Estructura de Archivos
|
||||
|
||||
```
|
||||
deploy/
|
||||
└── docker/
|
||||
├── Dockerfile.api
|
||||
├── Dockerfile.frontend
|
||||
├── docker-compose.yml
|
||||
└── nginx.conf
|
||||
```
|
||||
|
||||
### 2. Dockerfile Backend
|
||||
|
||||
```dockerfile
|
||||
# deploy/docker/Dockerfile.api
|
||||
FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
|
||||
WORKDIR /src
|
||||
|
||||
COPY src/backend/ .
|
||||
RUN dotnet restore Host/Host.csproj
|
||||
RUN dotnet publish Host/Host.csproj -c Release -o /app
|
||||
|
||||
FROM mcr.microsoft.com/dotnet/aspnet:10.0
|
||||
WORKDIR /app
|
||||
COPY --from=build /app .
|
||||
|
||||
# Non-root user
|
||||
RUN adduser --disabled-password --gecos '' appuser
|
||||
USER appuser
|
||||
|
||||
EXPOSE 5000
|
||||
HEALTHCHECK --interval=30s --timeout=3s \
|
||||
CMD curl -f http://localhost:5000/health || exit 1
|
||||
|
||||
ENTRYPOINT ["dotnet", "Host.dll"]
|
||||
```
|
||||
|
||||
### 3. Dockerfile Frontend
|
||||
|
||||
```dockerfile
|
||||
# deploy/docker/Dockerfile.frontend
|
||||
FROM node:22-alpine AS build
|
||||
WORKDIR /app
|
||||
|
||||
COPY src/frontend/package*.json ./
|
||||
RUN npm ci
|
||||
|
||||
COPY src/frontend/ .
|
||||
RUN npm run build -- --configuration production
|
||||
|
||||
FROM nginx:alpine
|
||||
COPY --from=build /app/dist/student-enrollment/browser /usr/share/nginx/html
|
||||
COPY deploy/docker/nginx.conf /etc/nginx/conf.d/default.conf
|
||||
|
||||
EXPOSE 80
|
||||
HEALTHCHECK --interval=30s --timeout=3s \
|
||||
CMD curl -f http://localhost/ || exit 1
|
||||
```
|
||||
|
||||
### 4. Nginx Configuration
|
||||
|
||||
```nginx
|
||||
# deploy/docker/nginx.conf
|
||||
server {
|
||||
listen 80;
|
||||
server_name localhost;
|
||||
root /usr/share/nginx/html;
|
||||
index index.html;
|
||||
|
||||
# Gzip
|
||||
gzip on;
|
||||
gzip_types text/plain text/css application/json application/javascript;
|
||||
|
||||
# SPA routing
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# Proxy GraphQL
|
||||
location /graphql {
|
||||
proxy_pass http://api:5000/graphql;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
proxy_set_header Host $host;
|
||||
}
|
||||
|
||||
# Security headers
|
||||
add_header X-Frame-Options "DENY" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
}
|
||||
```
|
||||
|
||||
### 5. Docker Compose
|
||||
|
||||
```yaml
|
||||
# deploy/docker/docker-compose.yml
|
||||
services:
|
||||
db:
|
||||
image: mcr.microsoft.com/mssql/server:2022-latest
|
||||
environment:
|
||||
- ACCEPT_EULA=Y
|
||||
- SA_PASSWORD=${DB_PASSWORD}
|
||||
ports:
|
||||
- "1433:1433"
|
||||
volumes:
|
||||
- sqlserver-data:/var/opt/mssql
|
||||
healthcheck:
|
||||
test: /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P $${SA_PASSWORD} -Q "SELECT 1" -C
|
||||
interval: 10s
|
||||
timeout: 3s
|
||||
retries: 10
|
||||
|
||||
api:
|
||||
build:
|
||||
context: ../..
|
||||
dockerfile: deploy/docker/Dockerfile.api
|
||||
environment:
|
||||
- ConnectionStrings__DefaultConnection=Server=db;Database=StudentEnrollment;User Id=sa;Password=${DB_PASSWORD};TrustServerCertificate=True
|
||||
- ASPNETCORE_ENVIRONMENT=Production
|
||||
ports:
|
||||
- "5000:5000"
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
|
||||
frontend:
|
||||
build:
|
||||
context: ../..
|
||||
dockerfile: deploy/docker/Dockerfile.frontend
|
||||
ports:
|
||||
- "80:80"
|
||||
depends_on:
|
||||
- api
|
||||
|
||||
volumes:
|
||||
sqlserver-data:
|
||||
```
|
||||
|
||||
### 6. Ejecutar
|
||||
|
||||
```bash
|
||||
cd deploy/docker
|
||||
|
||||
# Crear archivo .env
|
||||
echo "DB_PASSWORD=Your_Str0ng_P@ssword!" > .env
|
||||
|
||||
# Build e iniciar
|
||||
docker-compose up -d --build
|
||||
|
||||
# Ver logs
|
||||
docker-compose logs -f
|
||||
|
||||
# Detener
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Despliegue Manual
|
||||
|
||||
### Backend
|
||||
|
||||
```bash
|
||||
cd src/backend/Host
|
||||
|
||||
# Build producción
|
||||
dotnet publish -c Release -o ./publish
|
||||
|
||||
# Configurar connection string
|
||||
export ConnectionStrings__DefaultConnection="Server=..."
|
||||
|
||||
# Ejecutar migraciones
|
||||
dotnet ef database update --project ../Adapters/Driven/Persistence
|
||||
|
||||
# Iniciar
|
||||
cd publish
|
||||
dotnet Host.dll
|
||||
```
|
||||
|
||||
### Frontend
|
||||
|
||||
```bash
|
||||
cd src/frontend
|
||||
|
||||
# Build producción
|
||||
ng build --configuration production
|
||||
|
||||
# Los archivos quedan en dist/student-enrollment/browser/
|
||||
# Servir con cualquier servidor web (nginx, apache, etc.)
|
||||
```
|
||||
|
||||
## Checklist Pre-Producción
|
||||
|
||||
### Seguridad
|
||||
|
||||
- [ ] Connection strings en variables de entorno (no en código)
|
||||
- [ ] HTTPS habilitado
|
||||
- [ ] CORS configurado solo para dominios permitidos
|
||||
- [ ] Rate limiting activo
|
||||
- [ ] Security headers configurados
|
||||
- [ ] Logs sin datos sensibles
|
||||
|
||||
### Performance
|
||||
|
||||
- [ ] Response compression habilitado
|
||||
- [ ] Output caching configurado
|
||||
- [ ] Bundle Angular optimizado (< 200KB transferidos)
|
||||
- [ ] Índices de BD aplicados
|
||||
|
||||
### Monitoreo
|
||||
|
||||
- [ ] Health checks funcionando (`/health`)
|
||||
- [ ] Logs centralizados
|
||||
- [ ] Métricas de aplicación
|
||||
|
||||
### Base de Datos
|
||||
|
||||
- [ ] Backup configurado
|
||||
- [ ] Migraciones aplicadas
|
||||
- [ ] Datos seed cargados (5 profesores, 10 materias)
|
||||
|
||||
## URLs de Verificación
|
||||
|
||||
| Servicio | URL | Esperado |
|
||||
|----------|-----|----------|
|
||||
| API Health | `http://api:5000/health` | 200 OK |
|
||||
| GraphQL Playground | `http://api:5000/graphql` | Banana Cake Pop |
|
||||
| Frontend | `http://frontend:80` | App Angular |
|
||||
|
||||
## Rollback
|
||||
|
||||
```bash
|
||||
# Docker
|
||||
docker-compose down
|
||||
docker-compose up -d --no-build # Usa imágenes anteriores
|
||||
|
||||
# Manual
|
||||
# Restaurar versión anterior de DLLs/archivos
|
||||
# Rollback de migraciones si es necesario:
|
||||
dotnet ef database update <MigrationName>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Despliegue en Kubernetes (k3s)
|
||||
|
||||
### Estructura de Manifiestos
|
||||
|
||||
```
|
||||
deploy/k3s/
|
||||
├── namespace.yaml # Namespace dedicado
|
||||
├── secrets.yaml # Credenciales BD
|
||||
├── configmap.yaml # Configuración
|
||||
├── sqlserver.yaml # Base de datos
|
||||
├── api.yaml # Backend GraphQL
|
||||
├── frontend.yaml # Frontend Angular
|
||||
├── ingress.yaml # Traefik ingress
|
||||
├── ingress-tls.yaml # TLS con cert-manager
|
||||
├── hpa.yaml # Autoscaling
|
||||
├── networkpolicy.yaml # Seguridad de red
|
||||
├── kustomization.yaml # Kustomize config
|
||||
└── deploy.sh # Script de despliegue
|
||||
```
|
||||
|
||||
### Requisitos k3s
|
||||
|
||||
- k3s instalado y funcionando
|
||||
- kubectl configurado
|
||||
- Acceso al cluster
|
||||
- (Opcional) cert-manager para TLS
|
||||
|
||||
### Despliegue Rápido
|
||||
|
||||
```bash
|
||||
cd deploy/k3s
|
||||
|
||||
# Opción 1: Con script
|
||||
./deploy.sh all # Build + Deploy
|
||||
|
||||
# Opción 2: Con kustomize
|
||||
kubectl apply -k .
|
||||
|
||||
# Verificar estado
|
||||
kubectl get all -n student-enrollment
|
||||
```
|
||||
|
||||
### Comandos del Script
|
||||
|
||||
```bash
|
||||
./deploy.sh build # Construir imágenes Docker
|
||||
./deploy.sh deploy # Desplegar a k3s
|
||||
./deploy.sh status # Ver estado del cluster
|
||||
./deploy.sh logs api # Ver logs del API
|
||||
./deploy.sh forward # Port-forward para desarrollo
|
||||
./deploy.sh delete # Eliminar deployment
|
||||
```
|
||||
|
||||
### Configurar Secrets
|
||||
|
||||
```bash
|
||||
# Editar secrets antes de desplegar
|
||||
kubectl create secret generic student-secrets \
|
||||
--namespace=student-enrollment \
|
||||
--from-literal=db-password='TuPasswordSeguro123!' \
|
||||
--from-literal=db-connection-string='Server=sqlserver;Database=StudentEnrollment;User Id=sa;Password=TuPasswordSeguro123!;TrustServerCertificate=True' \
|
||||
--dry-run=client -o yaml > secrets.yaml
|
||||
```
|
||||
|
||||
### Acceso Local (Desarrollo)
|
||||
|
||||
```bash
|
||||
# Agregar entrada en /etc/hosts
|
||||
echo "127.0.0.1 students.local" | sudo tee -a /etc/hosts
|
||||
|
||||
# Port forward
|
||||
./deploy.sh forward
|
||||
|
||||
# Acceder en:
|
||||
# - Frontend: http://localhost:8080
|
||||
# - API: http://localhost:5000/graphql
|
||||
```
|
||||
|
||||
### Habilitar TLS (Producción)
|
||||
|
||||
```bash
|
||||
# 1. Instalar cert-manager
|
||||
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.14.0/cert-manager.yaml
|
||||
|
||||
# 2. Editar ingress-tls.yaml con tu dominio y email
|
||||
|
||||
# 3. Aplicar ingress con TLS
|
||||
kubectl apply -f ingress-tls.yaml -n student-enrollment
|
||||
```
|
||||
|
||||
### Scaling Manual
|
||||
|
||||
```bash
|
||||
# Escalar API
|
||||
kubectl scale deployment student-api -n student-enrollment --replicas=3
|
||||
|
||||
# Escalar Frontend
|
||||
kubectl scale deployment student-frontend -n student-enrollment --replicas=2
|
||||
```
|
||||
|
||||
### Monitoreo
|
||||
|
||||
```bash
|
||||
# Estado de pods
|
||||
kubectl get pods -n student-enrollment -w
|
||||
|
||||
# Logs en tiempo real
|
||||
kubectl logs -n student-enrollment -l app=student-api -f
|
||||
|
||||
# Eventos
|
||||
kubectl get events -n student-enrollment --sort-by='.lastTimestamp'
|
||||
|
||||
# Recursos
|
||||
kubectl top pods -n student-enrollment
|
||||
```
|
||||
|
||||
### Rollback en k3s
|
||||
|
||||
```bash
|
||||
# Ver historial de deployments
|
||||
kubectl rollout history deployment/student-api -n student-enrollment
|
||||
|
||||
# Rollback a versión anterior
|
||||
kubectl rollout undo deployment/student-api -n student-enrollment
|
||||
|
||||
# Rollback a revisión específica
|
||||
kubectl rollout undo deployment/student-api -n student-enrollment --to-revision=2
|
||||
```
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
```bash
|
||||
# Pod no inicia
|
||||
kubectl describe pod <pod-name> -n student-enrollment
|
||||
|
||||
# Conectar a pod
|
||||
kubectl exec -it <pod-name> -n student-enrollment -- /bin/sh
|
||||
|
||||
# Verificar conectividad BD
|
||||
kubectl exec -it <api-pod> -n student-enrollment -- \
|
||||
curl -v telnet://sqlserver:1433
|
||||
|
||||
# Verificar ingress
|
||||
kubectl describe ingress student-ingress -n student-enrollment
|
||||
```
|
||||
|
|
@ -0,0 +1,270 @@
|
|||
# Entregables - Prueba Técnica Senior .NET/Angular
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Empresa:** Inter Rapidísimo
|
||||
**Cargo:** Desarrollador Master .NET/Angular
|
||||
|
||||
---
|
||||
|
||||
## Resumen Ejecutivo
|
||||
|
||||
Sistema web completo para gestión de inscripciones de estudiantes con las siguientes características:
|
||||
|
||||
- **Backend:** .NET 10, GraphQL (HotChocolate), Clean Architecture
|
||||
- **Frontend:** Angular 21, Standalone Components, Signals
|
||||
- **Base de Datos:** SQL Server con EF Core
|
||||
- **Seguridad:** OWASP compliant, rate limiting, query complexity
|
||||
- **Testing:** 145 tests automatizados
|
||||
- **Despliegue:** Docker + Kubernetes (k3s)
|
||||
|
||||
---
|
||||
|
||||
## Estructura del Proyecto
|
||||
|
||||
```
|
||||
/
|
||||
├── src/
|
||||
│ ├── backend/ # .NET 10 API GraphQL
|
||||
│ │ ├── Domain/ # Entidades, Value Objects, Ports
|
||||
│ │ ├── Application/ # Commands, Queries, DTOs
|
||||
│ │ ├── Adapters/ # GraphQL API, Persistence
|
||||
│ │ └── Host/ # Entry point, DI
|
||||
│ └── frontend/ # Angular 21 SPA
|
||||
├── tests/ # Tests automatizados
|
||||
├── docs/ # Documentación
|
||||
└── deploy/ # Docker + k3s
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Funcionalidades Implementadas
|
||||
|
||||
### Requisitos Funcionales
|
||||
|
||||
| # | Requisito | Estado |
|
||||
|---|-----------|--------|
|
||||
| 1 | CRUD completo de estudiantes | ✅ |
|
||||
| 2 | Inscripción en materias (max 3) | ✅ |
|
||||
| 3 | Visualización de compañeros de clase | ✅ |
|
||||
| 4 | Restricción de profesor único | ✅ |
|
||||
| 5 | 10 materias, 5 profesores | ✅ |
|
||||
| 6 | 3 créditos por materia | ✅ |
|
||||
| 7 | Validación de inscripciones | ✅ |
|
||||
| 8 | UI responsiva | ✅ |
|
||||
| 9 | Manejo de errores | ✅ |
|
||||
|
||||
### Reglas de Negocio
|
||||
|
||||
- ✅ Máximo 3 materias por estudiante (9 créditos)
|
||||
- ✅ No repetir profesor en inscripciones
|
||||
- ✅ Validación en Domain Layer (pura, testeable)
|
||||
- ✅ Mensajes de error descriptivos
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura
|
||||
|
||||
### Clean Architecture
|
||||
|
||||
```
|
||||
Host → Adapters → Application → Domain
|
||||
```
|
||||
|
||||
- **Domain:** Entidades puras, sin dependencias
|
||||
- **Application:** Casos de uso con CQRS
|
||||
- **Adapters:** GraphQL API + EF Core
|
||||
- **Host:** Composición y DI
|
||||
|
||||
### Patrones Implementados
|
||||
|
||||
| Patrón | Uso |
|
||||
|--------|-----|
|
||||
| CQRS | Separación Commands/Queries |
|
||||
| Repository | Abstracción de persistencia |
|
||||
| Ports & Adapters | Inversión de dependencias |
|
||||
| DataLoader | Evitar N+1 en GraphQL |
|
||||
| Specification | Consultas reutilizables |
|
||||
|
||||
---
|
||||
|
||||
## Testing
|
||||
|
||||
### Resumen de Tests
|
||||
|
||||
| Tipo | Cantidad | Cobertura |
|
||||
|------|----------|-----------|
|
||||
| Domain Tests | 30 | Entidades, Value Objects, Services |
|
||||
| Application Tests | 66 | Commands, Queries, Validators |
|
||||
| Integration Tests | 5 | GraphQL API completa |
|
||||
| Angular Unit Tests | 24 | Services, Pipes |
|
||||
| E2E Tests (Playwright) | 20 | Flujos de usuario |
|
||||
| **Total** | **145** | |
|
||||
|
||||
### Ejecutar Tests
|
||||
|
||||
```bash
|
||||
# Backend
|
||||
dotnet test
|
||||
|
||||
# Frontend
|
||||
cd src/frontend
|
||||
ng test --watch=false
|
||||
|
||||
# E2E
|
||||
npx playwright test
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Seguridad (OWASP)
|
||||
|
||||
| Control | Implementación |
|
||||
|---------|----------------|
|
||||
| Input Validation | FluentValidation + Regex |
|
||||
| SQL Injection | EF Core parametrizado |
|
||||
| XSS Prevention | Sanitización en validators |
|
||||
| Security Headers | CSP, HSTS, X-Frame-Options |
|
||||
| Rate Limiting | 100 req/min (fixed window) |
|
||||
| Query Complexity | Depth 5, Cost 100 |
|
||||
| Logging | Serilog (sin datos sensibles) |
|
||||
|
||||
---
|
||||
|
||||
## Documentación
|
||||
|
||||
| Documento | Ubicación |
|
||||
|-----------|-----------|
|
||||
| README principal | `/README.md` |
|
||||
| Arquitectura Backend | `/docs/entregables/02-diseno/arquitectura/` |
|
||||
| Modelo de Dominio | `/docs/entregables/02-diseno/modelo-dominio/` |
|
||||
| Diseño BD | `/docs/entregables/02-diseno/base-datos/` |
|
||||
| Esquema GraphQL | `/docs/entregables/02-diseno/esquema-graphql/` |
|
||||
| ADRs | `/docs/architecture/decisions/` |
|
||||
| OWASP Checklist | `/docs/OWASP_CHECKLIST.md` |
|
||||
| Manual Despliegue | `/docs/DEPLOYMENT.md` |
|
||||
|
||||
---
|
||||
|
||||
## Despliegue
|
||||
|
||||
### Docker
|
||||
|
||||
```bash
|
||||
cd deploy/docker
|
||||
docker-compose up -d --build
|
||||
```
|
||||
|
||||
### Kubernetes (k3s)
|
||||
|
||||
```bash
|
||||
cd deploy/k3s
|
||||
./deploy.sh all
|
||||
```
|
||||
|
||||
### URLs
|
||||
|
||||
| Servicio | URL |
|
||||
|----------|-----|
|
||||
| Frontend | http://localhost:80 |
|
||||
| API GraphQL | http://localhost:5000/graphql |
|
||||
| Playground | http://localhost:5000/graphql |
|
||||
|
||||
---
|
||||
|
||||
## Competencias Demostradas
|
||||
|
||||
### Arquitectura y Diseño
|
||||
|
||||
- ✅ Clean Architecture con separación de capas
|
||||
- ✅ Principios SOLID aplicados
|
||||
- ✅ Domain-Driven Design (DDD lite)
|
||||
- ✅ CQRS para separación de concerns
|
||||
|
||||
### Backend (.NET)
|
||||
|
||||
- ✅ .NET 10 con C# 13
|
||||
- ✅ GraphQL con HotChocolate
|
||||
- ✅ EF Core con Fluent API
|
||||
- ✅ FluentValidation
|
||||
- ✅ DataLoaders para N+1
|
||||
|
||||
### Frontend (Angular)
|
||||
|
||||
- ✅ Angular 21 con Standalone Components
|
||||
- ✅ Signals para estado reactivo
|
||||
- ✅ Apollo Client para GraphQL
|
||||
- ✅ Angular Material UI
|
||||
- ✅ Lazy Loading
|
||||
|
||||
### DevOps
|
||||
|
||||
- ✅ Docker multi-stage builds
|
||||
- ✅ Kubernetes manifests
|
||||
- ✅ Health checks
|
||||
- ✅ Horizontal Pod Autoscaler
|
||||
|
||||
### Testing
|
||||
|
||||
- ✅ Unit tests con alta cobertura
|
||||
- ✅ Integration tests
|
||||
- ✅ E2E tests con Playwright
|
||||
- ✅ Mocking de dependencias
|
||||
|
||||
### Seguridad
|
||||
|
||||
- ✅ OWASP Top 10 compliance
|
||||
- ✅ Input validation
|
||||
- ✅ Rate limiting
|
||||
- ✅ Security headers
|
||||
|
||||
---
|
||||
|
||||
## Cómo Ejecutar
|
||||
|
||||
### Desarrollo Local
|
||||
|
||||
```bash
|
||||
# Backend
|
||||
cd src/backend/Host
|
||||
dotnet run
|
||||
|
||||
# Frontend
|
||||
cd src/frontend
|
||||
npm install
|
||||
ng serve
|
||||
```
|
||||
|
||||
### Con Docker
|
||||
|
||||
```bash
|
||||
cd deploy/docker
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
### Tests
|
||||
|
||||
```bash
|
||||
# Todos los tests backend
|
||||
dotnet test
|
||||
|
||||
# Tests frontend
|
||||
cd src/frontend && ng test
|
||||
|
||||
# E2E
|
||||
cd src/frontend && npx playwright test
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Decisiones Técnicas
|
||||
|
||||
Ver ADRs completos en `/docs/architecture/decisions/`:
|
||||
|
||||
1. **ADR-001:** Clean Architecture - Testabilidad y mantenibilidad
|
||||
2. **ADR-002:** GraphQL vs REST - Flexibilidad en queries
|
||||
3. **ADR-003:** Signals vs RxJS - Simplicidad en estado local
|
||||
4. **ADR-004:** Validación 3 capas - Defensa en profundidad
|
||||
|
||||
---
|
||||
|
||||
*Desarrollado como prueba técnica para Inter Rapidísimo*
|
||||
|
|
@ -0,0 +1,78 @@
|
|||
# OWASP Top 10 Security Checklist
|
||||
|
||||
## Estado: Validado
|
||||
|
||||
| # | Vulnerabilidad | Mitigación Implementada | Ubicación |
|
||||
|---|---------------|-------------------------|-----------|
|
||||
| A01 | **Broken Access Control** | No aplica (sin autenticación requerida) | N/A |
|
||||
| A02 | **Cryptographic Failures** | HTTPS forzado en producción (HSTS) | `Program.cs:127` |
|
||||
| A03 | **Injection** | FluentValidation + Regex sanitization, EF Core parameterized queries | `CreateStudentValidator.cs`, `EnrollStudentValidator.cs` |
|
||||
| A04 | **Insecure Design** | Clean Architecture, input validation en todas las capas | Arquitectura por capas |
|
||||
| A05 | **Security Misconfiguration** | Security headers (CSP, X-Frame-Options, etc.), Exception details disabled in prod | `Program.cs:106-130`, `GraphQLExtensions.cs:53` |
|
||||
| A06 | **Vulnerable Components** | Dependencias actualizadas (.NET 10, Angular 21) | `*.csproj`, `package.json` |
|
||||
| A07 | **Auth Failures** | No aplica (sin autenticación en este MVP) | N/A |
|
||||
| A08 | **Data Integrity Failures** | Input validation, FluentValidation, GraphQL type safety | Validators |
|
||||
| A09 | **Security Logging Failures** | Serilog structured logging, sensitive data filtering | `appsettings.json:38-45` |
|
||||
| A10 | **Server-Side Request Forgery** | No endpoints que acepten URLs externas | N/A |
|
||||
|
||||
## Medidas de Seguridad Implementadas
|
||||
|
||||
### Backend (.NET)
|
||||
|
||||
1. **Input Validation**
|
||||
- FluentValidation con regex patterns
|
||||
- Sanitización de HTML/scripts
|
||||
- Longitud máxima de campos
|
||||
- Validación de formato email
|
||||
|
||||
2. **Security Headers**
|
||||
- `Content-Security-Policy`
|
||||
- `X-Content-Type-Options: nosniff`
|
||||
- `X-Frame-Options: DENY`
|
||||
- `Referrer-Policy: strict-origin-when-cross-origin`
|
||||
- `Permissions-Policy`
|
||||
- `Strict-Transport-Security` (producción)
|
||||
|
||||
3. **Rate Limiting**
|
||||
- 100 requests/minuto para queries GraphQL
|
||||
- 30 mutations/minuto
|
||||
- Queue limit para prevenir acumulación
|
||||
|
||||
4. **GraphQL Security**
|
||||
- Query depth limit: 5 niveles
|
||||
- Query complexity limit: 100
|
||||
- Execution timeout: 30 segundos
|
||||
- Pagination max: 50 items
|
||||
|
||||
5. **Logging Seguro**
|
||||
- Filtrado de datos sensibles (passwords, tokens)
|
||||
- Structured logging con Serilog
|
||||
- Rotación de logs (7 días)
|
||||
|
||||
### Frontend (Angular)
|
||||
|
||||
1. **XSS Prevention**
|
||||
- Angular sanitization por defecto
|
||||
- Content Security Policy
|
||||
|
||||
2. **CSRF Protection**
|
||||
- No cookies de sesión (stateless GraphQL)
|
||||
|
||||
3. **Secure Communication**
|
||||
- Solo HTTPS en producción
|
||||
- GraphQL sobre HTTPS
|
||||
|
||||
## Pruebas de Seguridad Recomendadas
|
||||
|
||||
```bash
|
||||
# Test security headers
|
||||
curl -I http://localhost:5000/graphql
|
||||
|
||||
# Test rate limiting (debe retornar 429 después de 100 requests)
|
||||
for i in {1..150}; do curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5000/graphql; done
|
||||
|
||||
# Test query depth (debe fallar con depth > 5)
|
||||
curl -X POST http://localhost:5000/graphql \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"query":"{ students { enrollments { subject { professor { subjects { name } } } } } }"}'
|
||||
```
|
||||
|
|
@ -0,0 +1,245 @@
|
|||
# Plan de Actividades - Prueba Técnica Senior .NET/Angular
|
||||
|
||||
## Información del Proyecto
|
||||
- **Cargo:** Desarrollador Master .NET/Angular
|
||||
- **Empresa:** Inter Rapidísimo
|
||||
- **Proyecto:** Sistema de Registro de Estudiantes
|
||||
- **Stack:** .NET 10 + GraphQL (HotChocolate) + Angular 21 + SQL Server
|
||||
|
||||
---
|
||||
|
||||
## Procesos de Fábrica de Software
|
||||
|
||||
| Código | Proceso | Descripción |
|
||||
|--------|---------|-------------|
|
||||
| **AN** | Análisis | Levantamiento de requisitos, historias de usuario |
|
||||
| **DI** | Diseño | Arquitectura, modelos, prototipos UI/UX |
|
||||
| **DE** | Desarrollo | Codificación, implementación |
|
||||
| **QA** | Quality Assurance | Testing, revisión de código |
|
||||
| **DV** | DevOps | CI/CD, containerización, despliegue |
|
||||
| **DO** | Documentación | Técnica, usuario, API |
|
||||
| **SE** | Seguridad | Validaciones, autenticación, OWASP |
|
||||
|
||||
---
|
||||
|
||||
## Tabla de Actividades
|
||||
|
||||
### Fase 1: Análisis y Planificación (AN)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 1.1 | Análisis de requisitos funcionales | Identificar y documentar los 9 requisitos del enunciado, criterios de aceptación por cada uno | Analista | AN |
|
||||
| 1.2 | Identificación de reglas de negocio | Documentar restricciones: máx 3 materias, 3 créditos/materia, 5 profesores con 2 materias c/u, restricción de profesor único | Analista | AN |
|
||||
| 1.3 | Definición de historias de usuario | Crear historias con formato "Como [rol] quiero [acción] para [beneficio]" con criterios de aceptación | Product Owner | AN |
|
||||
| 1.4 | Análisis de requisitos no funcionales | Definir: rendimiento (<200ms respuesta), seguridad (OWASP Top 10), usabilidad (responsive), mantenibilidad | Arquitecto | AN |
|
||||
| 1.5 | Identificación de riesgos técnicos | Mapear riesgos: complejidad de validaciones, integración frontend-backend, manejo de concurrencia | Líder Técnico | AN |
|
||||
|
||||
### Fase 2: Diseño de Arquitectura (DI)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 2.1 | Diseño de arquitectura backend | Definir Clean Architecture: Domain, Application, Infrastructure, GraphQL. Diagrama de capas y dependencias | Arquitecto Backend | DI |
|
||||
| 2.2 | Diseño del modelo de dominio | Crear diagrama de entidades: Student, Subject, Professor, Enrollment. Definir agregados y value objects | Arquitecto Backend | DI |
|
||||
| 2.3 | Diseño de base de datos | Modelo E-R normalizado (3FN), índices, constraints, scripts DDL con integridad referencial | DBA/Arquitecto | DI |
|
||||
| 2.4 | Diseño de esquema GraphQL | Definir Types, Queries, Mutations, Inputs, Payloads. Diseñar resolvers y DataLoaders para N+1 | Arquitecto Backend | DI |
|
||||
| 2.5 | Diseño de arquitectura frontend | Definir estructura Angular: standalone components, signals, lazy loading, Apollo Client para GraphQL | Arquitecto Frontend | DI |
|
||||
| 2.6 | Diseño de componentes UI | Wireframes de pantallas: listado estudiantes, formulario inscripción, selección materias, vista compañeros | UI/UX Designer | DI |
|
||||
| 2.7 | Definición de contratos GraphQL | Schema GraphQL completo, DTOs de request/response, interfaces de servicios, contratos entre capas | Arquitecto | DI |
|
||||
| 2.8 | Diseño de estrategia de manejo de errores | Definir excepciones de dominio, error handling en GraphQL (Union types para errores), respuestas estandarizadas | Arquitecto | DI |
|
||||
|
||||
### Fase 3: Configuración del Entorno (DV)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 3.1 | Inicialización del repositorio | Crear estructura de carpetas, .gitignore, README, CLAUDE.md con convenciones del proyecto | DevOps | DV |
|
||||
| 3.2 | Configuración solución .NET | Crear solución con 4 proyectos (Domain, Application, Infrastructure, GraphQL), referencias entre proyectos | Backend Dev | DV |
|
||||
| 3.3 | Configuración proyecto Angular | ng new con standalone, configurar ESLint, Prettier, paths aliases, Apollo Angular para GraphQL | Frontend Dev | DV |
|
||||
| 3.4 | Configuración de base de datos | Docker compose para SQL Server, scripts de inicialización, connection strings por ambiente | DevOps/DBA | DV |
|
||||
| 3.5 | Configuración de variables de entorno | User secrets para desarrollo, appsettings por ambiente, environment.ts en Angular | DevOps | DV |
|
||||
| 3.6 | Configuración de herramientas de calidad | EditorConfig, .NET analyzers, ESLint rules, Husky para pre-commit hooks | DevOps | DV |
|
||||
|
||||
### Fase 4: Desarrollo Backend (DE)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 4.1 | Implementar capa Domain | Entidades (Student, Subject, Professor, Enrollment), Value Objects, interfaces de repositorios, excepciones de dominio | Backend Dev | DE |
|
||||
| 4.2 | Implementar reglas de negocio en Domain | Validaciones en entidades: EnrollmentPolicy (max 3 materias), ProfessorConstraint (no repetir profesor) | Backend Dev | DE |
|
||||
| 4.3 | Implementar capa Application - DTOs | Records inmutables para requests/responses, mappers con Mapster o extension methods | Backend Dev | DE |
|
||||
| 4.4 | Implementar capa Application - Servicios | StudentService, EnrollmentService con casos de uso: Create, Update, Delete, GetAll, GetById, GetClassmates | Backend Dev | DE |
|
||||
| 4.5 | Implementar validadores FluentValidation | Validators para CreateStudentInput, EnrollStudentInput con reglas de negocio | Backend Dev | DE |
|
||||
| 4.6 | Implementar capa Infrastructure - DbContext | Configurar EF Core 10, Fluent API para mapeos, configuraciones de entidades, seeding de datos iniciales | Backend Dev | DE |
|
||||
| 4.7 | Implementar capa Infrastructure - Repositorios | Repositorios genérico y específicos, Unit of Work, queries optimizadas con Include/ThenInclude | Backend Dev | DE |
|
||||
| 4.8 | Implementar GraphQL Types | StudentType, SubjectType, ProfessorType, EnrollmentType con HotChocolate | Backend Dev | DE |
|
||||
| 4.9 | Implementar GraphQL Queries | Resolvers para: students, student(id), subjects, availableSubjects(studentId), classmates(studentId), professors | Backend Dev | DE |
|
||||
| 4.10 | Implementar GraphQL Mutations | createStudent, updateStudent, deleteStudent, enrollStudent, unenrollStudent con Payloads de respuesta | Backend Dev | DE |
|
||||
| 4.11 | Implementar DataLoaders | DataLoaders para evitar N+1: StudentByIdDataLoader, SubjectByIdDataLoader, ProfessorByIdDataLoader | Backend Dev | DE |
|
||||
| 4.12 | Implementar middleware de errores | ExceptionHandlingMiddleware, mapeo de excepciones de dominio a errores GraphQL | Backend Dev | DE |
|
||||
| 4.13 | Configurar Dependency Injection | Registrar servicios por capa en Program.cs, configurar HotChocolate con servicios | Backend Dev | DE |
|
||||
| 4.14 | Implementar migraciones EF Core | Crear migración inicial, script de seed para profesores y materias predefinidas | Backend Dev | DE |
|
||||
|
||||
### Fase 5: Desarrollo Frontend (DE)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 5.1 | Configurar Apollo Angular | Instalar apollo-angular, configurar ApolloModule con endpoint GraphQL, cache policies | Frontend Dev | DE |
|
||||
| 5.2 | Implementar GraphQL Queries en Angular | Archivos .graphql o queries en TypeScript para students, subjects, classmates | Frontend Dev | DE |
|
||||
| 5.3 | Implementar GraphQL Mutations en Angular | Mutations para crear/editar estudiante, inscribir/desinscribir materias | Frontend Dev | DE |
|
||||
| 5.4 | Implementar capa Core - Servicios | StudentService, SubjectService, EnrollmentService usando Apollo Client | Frontend Dev | DE |
|
||||
| 5.5 | Implementar capa Core - Interceptores | HttpErrorInterceptor para manejo global de errores, LoadingInterceptor para indicador de carga | Frontend Dev | DE |
|
||||
| 5.6 | Implementar capa Shared - Componentes UI | ButtonComponent, InputComponent, CardComponent, TableComponent, ModalComponent, AlertComponent | Frontend Dev | DE |
|
||||
| 5.7 | Implementar capa Shared - Directivas y Pipes | HighlightDirective, TooltipDirective, TruncatePipe, CreditsPipe | Frontend Dev | DE |
|
||||
| 5.8 | Implementar feature Students - Listado | Tabla con estudiantes usando Apollo watchQuery, búsqueda, paginación, acciones CRUD | Frontend Dev | DE |
|
||||
| 5.9 | Implementar feature Students - Formulario | Reactive form para crear/editar estudiante con validaciones, mutation de Apollo | Frontend Dev | DE |
|
||||
| 5.10 | Implementar feature Enrollment - Selección materias | Componente con query availableSubjects, validación visual de restricción de profesor, contador de créditos | Frontend Dev | DE |
|
||||
| 5.11 | Implementar feature Enrollment - Vista compañeros | Query classmates con listado de nombres por materia inscrita | Frontend Dev | DE |
|
||||
| 5.12 | Implementar gestión de estado | Signals para estado local, Apollo cache para estado del servidor, optimistic updates | Frontend Dev | DE |
|
||||
| 5.13 | Implementar manejo de errores UI | Toast notifications, estados de error en formularios, manejo de errores GraphQL | Frontend Dev | DE |
|
||||
| 5.14 | Implementar responsive design | CSS con mobile-first, breakpoints para tablet/desktop, Angular Material responsive | Frontend Dev | DE |
|
||||
| 5.15 | Implementar loading states | Skeletons, spinners, estados de carga con Apollo loading state | Frontend Dev | DE |
|
||||
|
||||
### Fase 6: Integración GraphQL (DE)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 6.1 | Configurar CORS | Permitir origen del frontend en desarrollo y producción, headers para GraphQL | Backend Dev | DE |
|
||||
| 6.2 | Configurar Banana Cake Pop | Playground integrado de HotChocolate para testing de queries/mutations | Backend Dev | DE |
|
||||
| 6.3 | Implementar health checks | Endpoint /health para verificar conectividad a BD y servicios | Backend Dev | DE |
|
||||
| 6.4 | Configurar Apollo DevTools | Habilitar Apollo DevTools en desarrollo para debugging de queries y cache | Frontend Dev | DE |
|
||||
| 6.5 | Implementar caché de Apollo | Configurar cache policies: cache-first para datos estáticos, network-only para datos dinámicos | Frontend Dev | DE |
|
||||
| 6.6 | Generar tipos TypeScript | Usar GraphQL Code Generator para generar tipos desde el schema GraphQL | Frontend Dev | DE |
|
||||
|
||||
### Fase 7: Seguridad (SE)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 7.1 | Implementar validación de entrada | Sanitización de inputs, validación en frontend y backend, prevención de inyección | Security Dev | SE |
|
||||
| 7.2 | Configurar headers de seguridad | Content-Security-Policy, X-Content-Type-Options, X-Frame-Options, HSTS | Security Dev | SE |
|
||||
| 7.3 | Implementar rate limiting | Limitar requests por IP para prevenir DoS, configurar en middleware GraphQL | Security Dev | SE |
|
||||
| 7.4 | Configurar query complexity | Limitar profundidad y complejidad de queries GraphQL para prevenir ataques | Security Dev | SE |
|
||||
| 7.5 | Validar OWASP Top 10 | Revisar: Injection, Broken Auth, XSS, Insecure Design, Security Misconfiguration | Security Dev | SE |
|
||||
| 7.6 | Configurar logging seguro | No loguear datos sensibles, structured logging con Serilog, niveles apropiados | Security Dev | SE |
|
||||
|
||||
### Fase 8: Testing (QA)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 8.1 | Unit tests - Domain | Tests para reglas de negocio: validación max 3 materias, restricción profesor, cálculo créditos | QA/Backend Dev | QA |
|
||||
| 8.2 | Unit tests - Application | Tests para servicios, mappers, validators usando mocks de repositorios | QA/Backend Dev | QA |
|
||||
| 8.3 | Integration tests - GraphQL | Tests de queries y mutations con WebApplicationFactory, base de datos in-memory | QA/Backend Dev | QA |
|
||||
| 8.4 | Unit tests - Angular Components | Tests con Jest/Jasmine para componentes, servicios con Apollo testing utilities | QA/Frontend Dev | QA |
|
||||
| 8.5 | E2E tests | Tests con Playwright para flujos críticos: registro estudiante, inscripción materias | QA | QA |
|
||||
| 8.6 | Tests de reglas de negocio | Casos de prueba específicos para restricciones: intentar 4ta materia, mismo profesor | QA | QA |
|
||||
| 8.7 | Code review | Revisión de código aplicando checklist: SOLID, Clean Code, convenciones, seguridad | Líder Técnico | QA |
|
||||
| 8.8 | Análisis de código estático | Ejecutar analyzers .NET, ESLint, corregir code smells, vulnerabilidades, duplicación | QA | QA |
|
||||
|
||||
### Fase 9: Optimización y Rendimiento (DE)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 9.1 | Optimizar queries EF Core | Revisar N+1 (usar DataLoaders), AsNoTracking para lecturas, proyecciones con Select, índices en BD | Backend Dev | DE |
|
||||
| 9.2 | Implementar caché backend | Response caching para queries estáticas, memory cache para datos frecuentes | Backend Dev | DE |
|
||||
| 9.3 | Optimizar bundle Angular | Lazy loading de rutas, tree shaking, análisis de bundle size | Frontend Dev | DE |
|
||||
| 9.4 | Optimizar rendimiento UI | OnPush change detection, trackBy en ngFor, debounce en búsquedas | Frontend Dev | DE |
|
||||
| 9.5 | Comprimir assets | Minificación CSS/JS, compresión gzip/brotli | DevOps | DE |
|
||||
|
||||
### Fase 10: Documentación (DO)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 10.1 | Documentar arquitectura | Diagrama C4 (Context, Container, Component), decisiones de arquitectura (ADR) | Arquitecto | DO |
|
||||
| 10.2 | Documentar esquema GraphQL | Schema completo con descripciones, ejemplos de queries/mutations en Banana Cake Pop | Backend Dev | DO |
|
||||
| 10.3 | Documentar modelo de datos | Diagrama E-R, diccionario de datos, scripts de creación comentados | DBA | DO |
|
||||
| 10.4 | README del proyecto | Instrucciones de instalación, configuración, ejecución, estructura del proyecto | Líder Técnico | DO |
|
||||
| 10.5 | Documentar decisiones técnicas | Por qué Clean Architecture, por qué GraphQL vs REST, por qué Signals vs RxJS | Arquitecto | DO |
|
||||
| 10.6 | Manual de despliegue | Pasos para deploy, variables de entorno requeridas, checklist pre-producción | DevOps | DO |
|
||||
|
||||
### Fase 11: Entrega y Despliegue (DV)
|
||||
|
||||
| # | Actividad | Detalle | Rol | Proceso |
|
||||
|---|-----------|---------|-----|---------|
|
||||
| 11.1 | Configurar Dockerfile GraphQL | Multi-stage build, imagen optimizada, health check, non-root user | DevOps | DV |
|
||||
| 11.2 | Configurar Dockerfile frontend | Build con Node, serve con Nginx, configuración de proxy para GraphQL | DevOps | DV |
|
||||
| 11.3 | Crear docker-compose | Orquestación de GraphQL API, frontend, SQL Server, configuración de red y volúmenes | DevOps | DV |
|
||||
| 11.4 | Pruebas de despliegue | Verificar funcionamiento end-to-end en ambiente containerizado | DevOps/QA | DV |
|
||||
| 11.5 | Preparar entregables | Empaquetar código fuente, scripts BD, documentación, instrucciones de ejecución | Líder Técnico | DV |
|
||||
| 11.6 | Validación final | Checklist de requisitos cumplidos, demo funcional, revisión de calidad | Líder Técnico | DV |
|
||||
|
||||
---
|
||||
|
||||
## Resumen por Proceso
|
||||
|
||||
| Proceso | Actividades | Peso |
|
||||
|---------|-------------|------|
|
||||
| Análisis (AN) | 5 | 5% |
|
||||
| Diseño (DI) | 8 | 15% |
|
||||
| DevOps (DV) | 12 | 10% |
|
||||
| Desarrollo Backend (DE) | 14 | 30% |
|
||||
| Desarrollo Frontend (DE) | 15 | 25% |
|
||||
| Seguridad (SE) | 6 | 5% |
|
||||
| Testing (QA) | 8 | 5% |
|
||||
| Documentación (DO) | 6 | 5% |
|
||||
| **TOTAL** | **74** | **100%** |
|
||||
|
||||
---
|
||||
|
||||
## Criterios de Calidad Senior
|
||||
|
||||
### Competencias Demostradas
|
||||
|
||||
| Área | Evidencia |
|
||||
|------|-----------|
|
||||
| **Arquitectura** | Clean Architecture, separación de concerns, principios SOLID |
|
||||
| **GraphQL** | Schema bien diseñado, DataLoaders para N+1, error handling |
|
||||
| **Código Limpio** | Naming conventions, SRP, métodos pequeños, sin duplicación |
|
||||
| **Testing** | Cobertura de reglas críticas, tests unitarios y de integración |
|
||||
| **Seguridad** | OWASP compliance, validación de inputs, query complexity limits |
|
||||
| **Rendimiento** | Queries optimizadas, caching estratégico, Apollo cache |
|
||||
| **Mantenibilidad** | Código autodocumentado, arquitectura desacoplada, DTOs |
|
||||
| **DevOps** | Containerización, configuración por ambiente |
|
||||
| **Documentación** | Schema GraphQL documentado, README completo |
|
||||
|
||||
### Diferenciadores Senior vs Junior
|
||||
|
||||
| Aspecto | Junior | Senior (Este proyecto) |
|
||||
|---------|--------|------------------------|
|
||||
| Arquitectura | Monolítico, acoplado | Clean Architecture, capas bien definidas |
|
||||
| API | REST básico | GraphQL con HotChocolate, DataLoaders |
|
||||
| Validaciones | Solo en frontend | Frontend + Backend + Domain |
|
||||
| Errores | Try-catch genéricos | Excepciones de dominio, Union types para errores |
|
||||
| Testing | Manual o ninguno | Unit + Integration + E2E automatizados |
|
||||
| Estado Frontend | Variables globales | Signals + Apollo Cache |
|
||||
| BD | EF directo en controller | Repository + Unit of Work + Specifications |
|
||||
| Seguridad | Ninguna | OWASP, headers, rate limiting, query complexity |
|
||||
|
||||
---
|
||||
|
||||
## Orden de Ejecución Recomendado
|
||||
|
||||
```
|
||||
Bloque 1: Fundamentos
|
||||
├── AN (1.1-1.5) → Requisitos claros
|
||||
├── DI (2.1-2.8) → Arquitectura definida
|
||||
└── DV (3.1-3.6) → Ambiente configurado
|
||||
|
||||
Bloque 2: Backend Core
|
||||
├── DE (4.1-4.7) → Domain + Application + Infrastructure
|
||||
└── DE (4.8-4.14) → GraphQL API funcional
|
||||
|
||||
Bloque 3: Frontend Core
|
||||
├── DE (5.1-5.7) → Core + Shared + Apollo config
|
||||
└── DE (5.8-5.15) → Features completas
|
||||
|
||||
Bloque 4: Integración
|
||||
└── DE (6.1-6.6) → Frontend ↔ Backend conectados
|
||||
|
||||
Bloque 5: Calidad
|
||||
├── SE (7.1-7.6) → Seguridad implementada
|
||||
├── QA (8.1-8.8) → Tests ejecutados
|
||||
└── DE (9.1-9.5) → Optimizaciones aplicadas
|
||||
|
||||
Bloque 6: Entrega
|
||||
├── DO (10.1-10.6) → Documentación completa
|
||||
└── DV (11.1-11.6) → Despliegue validado
|
||||
```
|
||||
|
||||
> **Nota:** Ejecutar los bloques secuencialmente. Dentro de cada bloque, las actividades pueden paralelizarse según disponibilidad de recursos.
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
# PRUEBA TECNICA APLICACION WEB
|
||||
|
||||
1. Los resultados deben ser enviados en un documento adjunto.
|
||||
2. Los entregables deben venir adjuntos.
|
||||
|
||||
## El test consiste en:
|
||||
|
||||
Una aplicación para registro de estudiantes:
|
||||
|
||||
1. Realizar un CRUD que le permita a un usuario realizar un registro en línea.
|
||||
2. El estudiante se adhiere a un programa de créditos
|
||||
3. Existen 10 materias
|
||||
4. Cada materia equivale a 3 créditos.
|
||||
5. El estudiante sólo podrá seleccionar 3 materias.
|
||||
6. Hay 5 profesores que dictan 2 materias cada uno.
|
||||
7. El estudiante no podrá tener clases con el mismo profesor.
|
||||
8. Cada estudiante puede ver en línea los registros de otros estudiantes.
|
||||
9. El estudiante podrá ver sólo el nombre de los alumnos con quienes compartirá cada clase.
|
||||
|
||||
## Entregables:
|
||||
|
||||
Una aplicación web o Cliente servidor
|
||||
Base de datos o scripts para su creación en MySql / SQL
|
||||
|
|
@ -0,0 +1,45 @@
|
|||
# ADR-001: Clean Architecture
|
||||
|
||||
**Estado:** Aceptado
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
## Contexto
|
||||
|
||||
Necesitamos una arquitectura que permita:
|
||||
- Testabilidad de reglas de negocio
|
||||
- Independencia de frameworks
|
||||
- Mantenibilidad a largo plazo
|
||||
- Separación clara de responsabilidades
|
||||
|
||||
## Decisión
|
||||
|
||||
Adoptar **Clean Architecture** con 4 capas: Domain, Application, Adapters, Host.
|
||||
|
||||
```
|
||||
Host → Adapters → Application → Domain
|
||||
```
|
||||
|
||||
## Consecuencias
|
||||
|
||||
### Positivas
|
||||
- Domain sin dependencias externas (puro C#)
|
||||
- Reglas de negocio testeables sin mocks de infraestructura
|
||||
- Fácil cambiar ORM o base de datos
|
||||
- Fácil cambiar de REST a GraphQL (o viceversa)
|
||||
|
||||
### Negativas
|
||||
- Mayor cantidad de archivos/proyectos
|
||||
- Curva de aprendizaje inicial
|
||||
- Overhead para proyectos muy pequeños
|
||||
|
||||
## Alternativas Consideradas
|
||||
|
||||
| Alternativa | Razón de Descarte |
|
||||
|-------------|-------------------|
|
||||
| N-Layer tradicional | Alto acoplamiento, difícil testear |
|
||||
| Vertical Slices | Menor separación de concerns |
|
||||
| Monolítico simple | No escala con complejidad |
|
||||
|
||||
## Referencias
|
||||
|
||||
- [Clean Architecture - Robert C. Martin](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
# ADR-002: GraphQL vs REST
|
||||
|
||||
**Estado:** Aceptado
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
## Contexto
|
||||
|
||||
La aplicación tiene relaciones complejas:
|
||||
- Estudiantes → Inscripciones → Materias → Profesores
|
||||
- Consultas como "materias disponibles" requieren múltiples joins
|
||||
- Frontend necesita flexibilidad en datos solicitados
|
||||
|
||||
## Decisión
|
||||
|
||||
Usar **GraphQL** con HotChocolate como API.
|
||||
|
||||
## Consecuencias
|
||||
|
||||
### Positivas
|
||||
- **No over-fetching:** Cliente pide solo campos necesarios
|
||||
- **No under-fetching:** Una query obtiene datos relacionados
|
||||
- **Schema tipado:** Contrato explícito frontend-backend
|
||||
- **Playground incluido:** Banana Cake Pop para testing
|
||||
- **DataLoaders:** Resuelve N+1 automáticamente
|
||||
|
||||
### Negativas
|
||||
- Complejidad adicional vs REST simple
|
||||
- Curva de aprendizaje GraphQL
|
||||
- Requiere configurar query complexity limits
|
||||
- Cache más complejo que HTTP caching
|
||||
|
||||
## Ejemplo Comparativo
|
||||
|
||||
### REST (múltiples requests)
|
||||
```
|
||||
GET /students/1
|
||||
GET /students/1/enrollments
|
||||
GET /subjects/1
|
||||
GET /professors/1
|
||||
```
|
||||
|
||||
### GraphQL (una query)
|
||||
```graphql
|
||||
query {
|
||||
student(id: 1) {
|
||||
name
|
||||
enrollments {
|
||||
subject {
|
||||
name
|
||||
professor { name }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Alternativas
|
||||
|
||||
| Alternativa | Razón de Descarte |
|
||||
|-------------|-------------------|
|
||||
| REST | Over/under-fetching, múltiples endpoints |
|
||||
| OData | Menos flexible, menos ecosistema |
|
||||
| gRPC | No ideal para frontend web |
|
||||
|
||||
## Referencias
|
||||
|
||||
- [HotChocolate Docs](https://chillicream.com/docs/hotchocolate)
|
||||
|
|
@ -0,0 +1,68 @@
|
|||
# ADR-003: Signals vs RxJS para Estado Local
|
||||
|
||||
**Estado:** Aceptado
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
## Contexto
|
||||
|
||||
Angular 21 introduce Signals como alternativa a RxJS para estado reactivo.
|
||||
Necesitamos decidir el enfoque para manejo de estado en el frontend.
|
||||
|
||||
## Decisión
|
||||
|
||||
Usar **Signals para estado local** + **Apollo Client para estado del servidor**.
|
||||
|
||||
```typescript
|
||||
// Estado local con Signals
|
||||
students = signal<Student[]>([]);
|
||||
loading = signal(true);
|
||||
|
||||
// Estado del servidor con Apollo
|
||||
this.apollo.watchQuery<GetStudentsQuery>({...})
|
||||
```
|
||||
|
||||
## Consecuencias
|
||||
|
||||
### Positivas
|
||||
- **Simplicidad:** Signals más intuitivos que BehaviorSubject
|
||||
- **Performance:** Integración nativa con OnPush
|
||||
- **Menos boilerplate:** No requiere async pipe en templates
|
||||
- **Type-safe:** Mejor inferencia de tipos
|
||||
|
||||
### Negativas
|
||||
- Tecnología relativamente nueva
|
||||
- Menos operadores que RxJS
|
||||
- Apollo aún usa Observables internamente
|
||||
|
||||
## Patrón Adoptado
|
||||
|
||||
```typescript
|
||||
@Component({
|
||||
changeDetection: ChangeDetectionStrategy.OnPush,
|
||||
})
|
||||
export class StudentListComponent {
|
||||
// Estado local
|
||||
students = signal<Student[]>([]);
|
||||
loading = signal(true);
|
||||
|
||||
// Suscripción a Apollo
|
||||
ngOnInit() {
|
||||
this.studentService.getStudents().subscribe(({ data, loading }) => {
|
||||
this.students.set(data);
|
||||
this.loading.set(loading);
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Alternativas
|
||||
|
||||
| Alternativa | Razón de Descarte |
|
||||
|-------------|-------------------|
|
||||
| RxJS puro | Mayor complejidad, más boilerplate |
|
||||
| NgRx | Overkill para esta aplicación |
|
||||
| Akita | Dependencia adicional innecesaria |
|
||||
|
||||
## Referencias
|
||||
|
||||
- [Angular Signals](https://angular.dev/guide/signals)
|
||||
|
|
@ -0,0 +1,70 @@
|
|||
# ADR-004: Estrategia de Validación en 3 Capas
|
||||
|
||||
**Estado:** Aceptado
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
## Contexto
|
||||
|
||||
Las reglas de negocio críticas son:
|
||||
- Máximo 3 materias por estudiante (9 créditos)
|
||||
- No repetir profesor en inscripciones
|
||||
- Datos de entrada válidos (email, nombre)
|
||||
|
||||
## Decisión
|
||||
|
||||
Validar en **3 capas** con responsabilidades distintas:
|
||||
|
||||
| Capa | Responsabilidad | Tecnología |
|
||||
|------|-----------------|------------|
|
||||
| Frontend | UX, feedback rápido | Reactive Forms |
|
||||
| Application | Estructura de datos, sanitización | FluentValidation |
|
||||
| Domain | Reglas de negocio puras | Domain Services |
|
||||
|
||||
## Implementación
|
||||
|
||||
### Frontend (UX)
|
||||
```typescript
|
||||
this.form = this.fb.group({
|
||||
name: ['', [Validators.required, Validators.minLength(3)]],
|
||||
email: ['', [Validators.required, Validators.email]],
|
||||
});
|
||||
```
|
||||
|
||||
### Application (Sanitización + XSS)
|
||||
```csharp
|
||||
RuleFor(x => x.Name)
|
||||
.NotEmpty()
|
||||
.Must(NotContainDangerousContent); // Previene XSS
|
||||
```
|
||||
|
||||
### Domain (Negocio)
|
||||
```csharp
|
||||
public void ValidateEnrollment(Student student, Subject subject)
|
||||
{
|
||||
if (student.Enrollments.Count >= 3)
|
||||
throw new MaxEnrollmentsExceededException();
|
||||
|
||||
if (student.HasProfessor(subject.ProfessorId))
|
||||
throw new SameProfessorConstraintException();
|
||||
}
|
||||
```
|
||||
|
||||
## Consecuencias
|
||||
|
||||
### Positivas
|
||||
- Defensa en profundidad
|
||||
- Separación de responsabilidades
|
||||
- UX mejorada (errores rápidos)
|
||||
- Seguridad garantizada (backend siempre valida)
|
||||
|
||||
### Negativas
|
||||
- Duplicación parcial de reglas
|
||||
- Mantener sincronizadas las validaciones
|
||||
|
||||
## Regla de Oro
|
||||
|
||||
> **Nunca confíes en el frontend.** El backend SIEMPRE debe validar.
|
||||
|
||||
## Referencias
|
||||
|
||||
- [OWASP Input Validation](https://owasp.org/www-community/Input_Validation)
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
# Architecture Decision Records (ADR)
|
||||
|
||||
Registro de decisiones arquitectónicas del proyecto.
|
||||
|
||||
## Índice
|
||||
|
||||
| ADR | Título | Estado |
|
||||
|-----|--------|--------|
|
||||
| [ADR-001](ADR-001-clean-architecture.md) | Clean Architecture | Aceptado |
|
||||
| [ADR-002](ADR-002-graphql-vs-rest.md) | GraphQL vs REST | Aceptado |
|
||||
| [ADR-003](ADR-003-angular-signals.md) | Signals vs RxJS | Aceptado |
|
||||
| [ADR-004](ADR-004-validation-strategy.md) | Estrategia de Validación | Aceptado |
|
||||
|
||||
## Formato ADR
|
||||
|
||||
Cada ADR sigue el formato:
|
||||
|
||||
1. **Título:** Nombre descriptivo
|
||||
2. **Estado:** Propuesto | Aceptado | Deprecado | Reemplazado
|
||||
3. **Contexto:** Por qué se necesita esta decisión
|
||||
4. **Decisión:** Qué se decidió
|
||||
5. **Consecuencias:** Positivas y negativas
|
||||
6. **Alternativas:** Opciones consideradas y descartadas
|
||||
|
||||
## Convenciones
|
||||
|
||||
- Nuevos ADRs: `ADR-XXX-nombre-descriptivo.md`
|
||||
- Nunca modificar ADRs aceptados (crear uno nuevo que lo reemplace)
|
||||
- Mantener este índice actualizado
|
||||
|
|
@ -0,0 +1,51 @@
|
|||
@startuml use-cases
|
||||
!theme plain
|
||||
skinparam actorStyle awesome
|
||||
skinparam packageStyle rectangle
|
||||
skinparam usecaseBackgroundColor #F8F9FA
|
||||
skinparam usecaseBorderColor #495057
|
||||
skinparam actorBackgroundColor #007AFF
|
||||
|
||||
title Sistema de Registro de Estudiantes - Diagrama de Casos de Uso
|
||||
|
||||
actor "Estudiante" as student
|
||||
|
||||
rectangle "Sistema de Inscripción" {
|
||||
usecase "Registrarse en el sistema" as UC1
|
||||
usecase "Iniciar sesión" as UC2
|
||||
usecase "Ver materias disponibles" as UC3
|
||||
usecase "Inscribirse en materia" as UC4
|
||||
usecase "Cancelar inscripción" as UC5
|
||||
usecase "Ver mis inscripciones" as UC6
|
||||
usecase "Ver compañeros de clase" as UC7
|
||||
usecase "Actualizar perfil" as UC8
|
||||
|
||||
usecase "Validar límite de créditos\n(máx 9 créditos)" as UC4a
|
||||
usecase "Validar restricción de profesor\n(no repetir profesor)" as UC4b
|
||||
}
|
||||
|
||||
student --> UC1
|
||||
student --> UC2
|
||||
student --> UC3
|
||||
student --> UC4
|
||||
student --> UC5
|
||||
student --> UC6
|
||||
student --> UC7
|
||||
student --> UC8
|
||||
|
||||
UC4 ..> UC4a : <<include>>
|
||||
UC4 ..> UC4b : <<include>>
|
||||
|
||||
note right of UC4
|
||||
Reglas de negocio:
|
||||
- Máximo 3 materias (9 créditos)
|
||||
- No puede tener 2 materias
|
||||
del mismo profesor
|
||||
end note
|
||||
|
||||
note right of UC7
|
||||
Solo muestra nombres
|
||||
de compañeros por materia
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 14 KiB |
|
|
@ -0,0 +1,94 @@
|
|||
@startuml domain-model
|
||||
!theme plain
|
||||
skinparam classAttributeIconSize 0
|
||||
skinparam classFontStyle bold
|
||||
skinparam classBackgroundColor #F8F9FA
|
||||
skinparam classBorderColor #495057
|
||||
|
||||
title Sistema de Registro de Estudiantes - Modelo de Dominio
|
||||
|
||||
package "Domain" {
|
||||
|
||||
class Student <<Entity>> {
|
||||
- id: int
|
||||
- name: string
|
||||
- email: Email
|
||||
- enrollments: List<Enrollment>
|
||||
--
|
||||
+ getTotalCredits(): int
|
||||
+ canEnrollIn(subject: Subject): bool
|
||||
+ enroll(subject: Subject): Enrollment
|
||||
+ unenroll(enrollmentId: int): void
|
||||
}
|
||||
|
||||
class Subject <<Entity>> {
|
||||
- id: int
|
||||
- name: string
|
||||
- credits: int {= 3}
|
||||
- professorId: int
|
||||
--
|
||||
+ getProfessor(): Professor
|
||||
}
|
||||
|
||||
class Professor <<Entity>> {
|
||||
- id: int
|
||||
- name: string
|
||||
- subjects: List<Subject>
|
||||
--
|
||||
+ getSubjects(): List<Subject>
|
||||
}
|
||||
|
||||
class Enrollment <<Entity>> {
|
||||
- id: int
|
||||
- studentId: int
|
||||
- subjectId: int
|
||||
- enrolledAt: DateTime
|
||||
--
|
||||
+ getStudent(): Student
|
||||
+ getSubject(): Subject
|
||||
}
|
||||
|
||||
class Email <<Value Object>> {
|
||||
- value: string
|
||||
--
|
||||
+ {static} create(value: string): Email
|
||||
- validate(value: string): void
|
||||
}
|
||||
|
||||
class EnrollmentDomainService <<Domain Service>> {
|
||||
--
|
||||
+ validateEnrollment(student: Student, subject: Subject): void
|
||||
- checkMaxEnrollments(student: Student): void
|
||||
- checkProfessorConstraint(student: Student, subject: Subject): void
|
||||
}
|
||||
|
||||
' Relaciones
|
||||
Student "1" *-- "0..3" Enrollment : tiene
|
||||
Subject "1" *-- "0..*" Enrollment : inscripciones
|
||||
Professor "1" *-- "2" Subject : imparte
|
||||
Student *-- Email : email
|
||||
|
||||
EnrollmentDomainService ..> Student : valida
|
||||
EnrollmentDomainService ..> Subject : valida
|
||||
}
|
||||
|
||||
note bottom of Student
|
||||
<b>Invariantes:</b>
|
||||
- Máximo 3 inscripciones
|
||||
- Email válido y único
|
||||
- No repetir profesor
|
||||
end note
|
||||
|
||||
note bottom of Subject
|
||||
<b>Invariantes:</b>
|
||||
- Créditos = 3 (fijo)
|
||||
- Pertenece a un profesor
|
||||
end note
|
||||
|
||||
note right of Professor
|
||||
Cada profesor
|
||||
imparte exactamente
|
||||
2 materias
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 24 KiB |
|
|
@ -0,0 +1,91 @@
|
|||
@startuml sequence-enrollment
|
||||
!theme plain
|
||||
skinparam sequenceMessageAlign center
|
||||
skinparam responseMessageBelowArrow true
|
||||
skinparam sequenceParticipantBackgroundColor #F8F9FA
|
||||
skinparam sequenceParticipantBorderColor #495057
|
||||
|
||||
title Secuencia: Inscripción de Estudiante en Materia
|
||||
|
||||
actor "Estudiante" as user
|
||||
participant "Frontend\n(Angular)" as frontend
|
||||
participant "API GraphQL\n(HotChocolate)" as api
|
||||
participant "EnrollStudentHandler" as handler
|
||||
participant "EnrollmentDomainService" as domainService
|
||||
participant "StudentRepository" as studentRepo
|
||||
participant "SubjectRepository" as subjectRepo
|
||||
participant "EnrollmentRepository" as enrollRepo
|
||||
database "SQL Server" as db
|
||||
|
||||
== Solicitud de Inscripción ==
|
||||
|
||||
user -> frontend : Selecciona materia\ny hace clic en "Inscribir"
|
||||
activate frontend
|
||||
|
||||
frontend -> api : mutation enrollStudent(\n studentId, subjectId)
|
||||
activate api
|
||||
|
||||
api -> handler : Handle(EnrollStudentCommand)
|
||||
activate handler
|
||||
|
||||
== Obtención de Datos ==
|
||||
|
||||
handler -> studentRepo : GetByIdWithEnrollmentsAsync(studentId)
|
||||
activate studentRepo
|
||||
studentRepo -> db : SELECT Student + Enrollments
|
||||
db --> studentRepo : Student data
|
||||
studentRepo --> handler : Student
|
||||
deactivate studentRepo
|
||||
|
||||
handler -> subjectRepo : GetByIdAsync(subjectId)
|
||||
activate subjectRepo
|
||||
subjectRepo -> db : SELECT Subject
|
||||
db --> subjectRepo : Subject data
|
||||
subjectRepo --> handler : Subject
|
||||
deactivate subjectRepo
|
||||
|
||||
== Validación de Reglas de Negocio ==
|
||||
|
||||
handler -> domainService : ValidateEnrollment(student, subject)
|
||||
activate domainService
|
||||
|
||||
domainService -> domainService : CheckMaxEnrollments()\n[máx 3 materias]
|
||||
|
||||
alt Estudiante tiene 3 materias
|
||||
domainService --> handler : throw MaxEnrollmentsExceededException
|
||||
handler --> api : Error: "Límite de materias alcanzado"
|
||||
api --> frontend : { errors: [...] }
|
||||
frontend --> user : Muestra mensaje de error
|
||||
end
|
||||
|
||||
domainService -> domainService : CheckProfessorConstraint()\n[no repetir profesor]
|
||||
|
||||
alt Ya tiene materia con el profesor
|
||||
domainService --> handler : throw SameProfessorConstraintException
|
||||
handler --> api : Error: "Ya tienes materia con este profesor"
|
||||
api --> frontend : { errors: [...] }
|
||||
frontend --> user : Muestra mensaje de error
|
||||
end
|
||||
|
||||
domainService --> handler : Validación OK
|
||||
deactivate domainService
|
||||
|
||||
== Persistencia ==
|
||||
|
||||
handler -> enrollRepo : AddAsync(enrollment)
|
||||
activate enrollRepo
|
||||
enrollRepo -> db : INSERT Enrollment
|
||||
db --> enrollRepo : OK
|
||||
enrollRepo --> handler : Enrollment
|
||||
deactivate enrollRepo
|
||||
|
||||
handler --> api : EnrollmentPayload
|
||||
deactivate handler
|
||||
|
||||
api --> frontend : { enrollment: {...} }
|
||||
deactivate api
|
||||
|
||||
frontend --> user : Muestra confirmación:\n"Inscrito en [materia]"
|
||||
deactivate frontend
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 34 KiB |
|
|
@ -0,0 +1,134 @@
|
|||
@startuml components
|
||||
!theme plain
|
||||
skinparam componentStyle uml2
|
||||
skinparam packageStyle rectangle
|
||||
skinparam componentBackgroundColor #F8F9FA
|
||||
skinparam componentBorderColor #495057
|
||||
skinparam packageBackgroundColor #FFFFFF
|
||||
skinparam packageBorderColor #DEE2E6
|
||||
|
||||
title Sistema de Registro de Estudiantes - Arquitectura de Componentes
|
||||
|
||||
package "Frontend (Angular 21)" as frontend {
|
||||
[App Component] as app
|
||||
[Student List] as studentList
|
||||
[Student Form] as studentForm
|
||||
[Enrollment Page] as enrollPage
|
||||
[Classmates Page] as classmates
|
||||
|
||||
package "Core" {
|
||||
[Apollo Client] as apollo
|
||||
[Student Service] as studentSvc
|
||||
[Enrollment Service] as enrollSvc
|
||||
[Connectivity Service] as connSvc
|
||||
[Error Handler] as errorHandler
|
||||
}
|
||||
|
||||
package "Shared" {
|
||||
[Connectivity Overlay] as overlay
|
||||
[Loading Spinner] as spinner
|
||||
[Confirm Dialog] as dialog
|
||||
}
|
||||
}
|
||||
|
||||
package "Backend (.NET 10)" as backend {
|
||||
|
||||
package "Host" as host {
|
||||
[Program.cs] as program
|
||||
[DI Container] as di
|
||||
}
|
||||
|
||||
package "Adapters" as adapters {
|
||||
package "Driving (Primary)" {
|
||||
[GraphQL API\n(HotChocolate)] as graphql
|
||||
[Query] as query
|
||||
[Mutation] as mutation
|
||||
[Types] as types
|
||||
}
|
||||
|
||||
package "Driven (Secondary)" {
|
||||
[Repositories] as repos
|
||||
[DataLoaders] as loaders
|
||||
[DbContext] as dbContext
|
||||
}
|
||||
}
|
||||
|
||||
package "Application" as application {
|
||||
[Commands] as commands
|
||||
[Queries] as queries
|
||||
[Handlers] as handlers
|
||||
[Validators] as validators
|
||||
[DTOs] as dtos
|
||||
}
|
||||
|
||||
package "Domain" as domain {
|
||||
[Entities] as entities
|
||||
[Value Objects] as valueObjects
|
||||
[Domain Services] as domainSvc
|
||||
[Ports (Interfaces)] as ports
|
||||
}
|
||||
}
|
||||
|
||||
database "SQL Server 2022" as sqlserver {
|
||||
[Students]
|
||||
[Subjects]
|
||||
[Professors]
|
||||
[Enrollments]
|
||||
}
|
||||
|
||||
cloud "Browser" as browser
|
||||
|
||||
' Conexiones Frontend
|
||||
browser --> app
|
||||
app --> studentList
|
||||
app --> studentForm
|
||||
app --> enrollPage
|
||||
app --> classmates
|
||||
app --> overlay
|
||||
|
||||
studentList --> studentSvc
|
||||
studentForm --> studentSvc
|
||||
enrollPage --> enrollSvc
|
||||
classmates --> enrollSvc
|
||||
overlay --> connSvc
|
||||
|
||||
studentSvc --> apollo
|
||||
enrollSvc --> apollo
|
||||
connSvc ..> errorHandler
|
||||
|
||||
' Conexiones Backend
|
||||
apollo --> graphql : HTTP/GraphQL
|
||||
|
||||
graphql --> query
|
||||
graphql --> mutation
|
||||
query --> handlers
|
||||
mutation --> handlers
|
||||
handlers --> validators
|
||||
handlers --> commands
|
||||
handlers --> queries
|
||||
|
||||
commands --> domainSvc
|
||||
queries --> repos
|
||||
domainSvc --> entities
|
||||
domainSvc --> valueObjects
|
||||
|
||||
repos --> dbContext
|
||||
loaders --> dbContext
|
||||
dbContext --> sqlserver
|
||||
|
||||
' Implementación de puertos
|
||||
repos ..|> ports : implements
|
||||
|
||||
note right of domain
|
||||
<b>Regla de Dependencia:</b>
|
||||
Domain no depende
|
||||
de capas externas
|
||||
end note
|
||||
|
||||
note bottom of graphql
|
||||
Endpoints:
|
||||
- /graphql
|
||||
- /health
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 51 KiB |
|
|
@ -0,0 +1,72 @@
|
|||
@startuml entity-relationship
|
||||
!theme plain
|
||||
skinparam linetype ortho
|
||||
skinparam classBackgroundColor #F8F9FA
|
||||
skinparam classBorderColor #495057
|
||||
|
||||
title Sistema de Registro de Estudiantes - Diagrama Entidad-Relación
|
||||
|
||||
entity "Students" as students {
|
||||
* **Id** : int <<PK>>
|
||||
--
|
||||
* Name : nvarchar(100)
|
||||
* Email : nvarchar(255) <<unique>>
|
||||
* CreatedAt : datetime2
|
||||
UpdatedAt : datetime2
|
||||
}
|
||||
|
||||
entity "Professors" as professors {
|
||||
* **Id** : int <<PK>>
|
||||
--
|
||||
* Name : nvarchar(100)
|
||||
}
|
||||
|
||||
entity "Subjects" as subjects {
|
||||
* **Id** : int <<PK>>
|
||||
--
|
||||
* Name : nvarchar(100)
|
||||
* Credits : int {= 3}
|
||||
* **ProfessorId** : int <<FK>>
|
||||
}
|
||||
|
||||
entity "Enrollments" as enrollments {
|
||||
* **Id** : int <<PK>>
|
||||
--
|
||||
* **StudentId** : int <<FK>>
|
||||
* **SubjectId** : int <<FK>>
|
||||
* EnrolledAt : datetime2
|
||||
--
|
||||
<<unique>> (StudentId, SubjectId)
|
||||
}
|
||||
|
||||
' Relaciones
|
||||
students ||--o{ enrollments : "tiene"
|
||||
subjects ||--o{ enrollments : "inscripciones"
|
||||
professors ||--|| subjects : "imparte 2"
|
||||
|
||||
note right of students
|
||||
<b>Restricciones:</b>
|
||||
- Email único
|
||||
- Máximo 3 enrollments
|
||||
end note
|
||||
|
||||
note right of subjects
|
||||
<b>Datos iniciales:</b>
|
||||
10 materias
|
||||
3 créditos cada una
|
||||
end note
|
||||
|
||||
note right of professors
|
||||
<b>Datos iniciales:</b>
|
||||
5 profesores
|
||||
2 materias cada uno
|
||||
end note
|
||||
|
||||
note bottom of enrollments
|
||||
<b>Reglas de negocio:</b>
|
||||
- (StudentId, SubjectId) único
|
||||
- Estudiante no puede tener
|
||||
2 materias del mismo profesor
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 18 KiB |
|
|
@ -0,0 +1,49 @@
|
|||
@startuml state-enrollment
|
||||
!theme plain
|
||||
skinparam stateBackgroundColor #F8F9FA
|
||||
skinparam stateBorderColor #495057
|
||||
|
||||
title Estado de Inscripción del Estudiante
|
||||
|
||||
[*] --> SinMaterias : Registro inicial
|
||||
|
||||
state "Sin Materias" as SinMaterias {
|
||||
state "0 créditos" as cred0
|
||||
}
|
||||
|
||||
state "Inscripción Parcial" as Parcial {
|
||||
state "3 créditos\n(1 materia)" as cred3
|
||||
state "6 créditos\n(2 materias)" as cred6
|
||||
}
|
||||
|
||||
state "Inscripción Completa" as Completa {
|
||||
state "9 créditos\n(3 materias)" as cred9
|
||||
}
|
||||
|
||||
SinMaterias --> Parcial : inscribir(materia)
|
||||
Parcial --> Parcial : inscribir(materia)\n[créditos < 9]
|
||||
Parcial --> Completa : inscribir(materia)\n[créditos = 6]
|
||||
Completa --> Parcial : cancelar(inscripción)
|
||||
Parcial --> SinMaterias : cancelar(inscripción)\n[única materia]
|
||||
|
||||
note right of Completa
|
||||
No puede inscribir
|
||||
más materias
|
||||
end note
|
||||
|
||||
note left of Parcial
|
||||
<b>Validaciones en cada inscripción:</b>
|
||||
- Límite de créditos
|
||||
- No repetir profesor
|
||||
- Materia no duplicada
|
||||
end note
|
||||
|
||||
state validacion <<choice>>
|
||||
|
||||
SinMaterias --> validacion : intenta inscribir
|
||||
Parcial --> validacion : intenta inscribir
|
||||
|
||||
validacion --> Parcial : [válido]
|
||||
validacion --> [*] : [inválido]\nmuestra error
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 15 KiB |
|
|
@ -0,0 +1,67 @@
|
|||
@startuml deployment
|
||||
!theme plain
|
||||
skinparam nodeBackgroundColor #F8F9FA
|
||||
skinparam nodeBorderColor #495057
|
||||
skinparam componentBackgroundColor #E9ECEF
|
||||
|
||||
title Sistema de Registro de Estudiantes - Diagrama de Despliegue
|
||||
|
||||
node "Cliente" as client {
|
||||
component "Navegador Web" as browser {
|
||||
[Angular SPA]
|
||||
}
|
||||
}
|
||||
|
||||
node "Docker Host" as docker {
|
||||
|
||||
node "student-frontend" as frontendContainer <<container>> {
|
||||
component "Nginx" as nginx {
|
||||
[Static Files]
|
||||
[Reverse Proxy]
|
||||
}
|
||||
}
|
||||
|
||||
node "student-api" as apiContainer <<container>> {
|
||||
component "ASP.NET Core" as aspnet {
|
||||
[Kestrel Server]
|
||||
[GraphQL Endpoint]
|
||||
[Health Check]
|
||||
}
|
||||
}
|
||||
|
||||
node "student-db" as dbContainer <<container>> {
|
||||
database "SQL Server 2022" as sqlserver {
|
||||
[StudentEnrollment DB]
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
' Conexiones
|
||||
browser --> nginx : HTTP :80
|
||||
nginx --> aspnet : HTTP :5000\n/graphql
|
||||
aspnet --> sqlserver : TCP :1433
|
||||
|
||||
note right of nginx
|
||||
<b>Nginx Config:</b>
|
||||
- Gzip/Brotli compression
|
||||
- Static file caching
|
||||
- GraphQL proxy
|
||||
- Security headers
|
||||
end note
|
||||
|
||||
note right of aspnet
|
||||
<b>Optimizaciones:</b>
|
||||
- Server GC
|
||||
- ReadyToRun
|
||||
- Connection pooling
|
||||
- Rate limiting
|
||||
end note
|
||||
|
||||
note right of sqlserver
|
||||
<b>Recursos:</b>
|
||||
- 2 CPU cores
|
||||
- 2.5 GB RAM
|
||||
- Persistent volume
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 22 KiB |
|
|
@ -0,0 +1,54 @@
|
|||
@startuml c4-context
|
||||
!theme plain
|
||||
skinparam rectangleBackgroundColor #F8F9FA
|
||||
skinparam rectangleBorderColor #495057
|
||||
|
||||
title Sistema de Registro de Estudiantes - Diagrama de Contexto (C4 Level 1)
|
||||
|
||||
skinparam rectangle {
|
||||
RoundCorner 10
|
||||
}
|
||||
|
||||
actor "Estudiante" as student <<Persona>>
|
||||
|
||||
rectangle "Sistema de Registro\nde Estudiantes" as system <<Software System>> #lightblue {
|
||||
}
|
||||
|
||||
rectangle "Base de Datos\nSQL Server" as database <<External System>> #lightgray {
|
||||
}
|
||||
|
||||
student --> system : Usa para registrarse\ne inscribirse en materias
|
||||
system --> database : Lee y escribe\ndatos de inscripciones
|
||||
|
||||
note right of student
|
||||
<b>Estudiante</b>
|
||||
Usuario del sistema que:
|
||||
- Se registra en el sistema
|
||||
- Se inscribe en materias (máx 3)
|
||||
- Ve sus compañeros de clase
|
||||
- Consulta inscripciones
|
||||
end note
|
||||
|
||||
note right of system
|
||||
<b>Sistema de Registro</b>
|
||||
Aplicación web que permite:
|
||||
- CRUD de estudiantes
|
||||
- Inscripción en materias
|
||||
- Validación de reglas de negocio
|
||||
- Visualización de compañeros
|
||||
|
||||
<b>Stack:</b>
|
||||
Frontend: Angular 21
|
||||
Backend: .NET 10 + GraphQL
|
||||
end note
|
||||
|
||||
note right of database
|
||||
<b>SQL Server 2022</b>
|
||||
Almacena:
|
||||
- Estudiantes
|
||||
- Profesores
|
||||
- Materias
|
||||
- Inscripciones
|
||||
end note
|
||||
|
||||
@enduml
|
||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 10 KiB |
|
|
@ -0,0 +1,45 @@
|
|||
# Diagramas UML - Sistema de Registro de Estudiantes
|
||||
|
||||
Diagramas de arquitectura y diseño del sistema, creados con PlantUML siguiendo el estándar UML 2.5.
|
||||
|
||||
## Diagramas Disponibles
|
||||
|
||||
| # | Diagrama | Archivo | Descripción |
|
||||
|---|----------|---------|-------------|
|
||||
| 1 | Casos de Uso | [01-use-cases](./01-use-cases.svg) | Funcionalidades del sistema desde perspectiva del estudiante |
|
||||
| 2 | Modelo de Dominio | [02-domain-model](./02-domain-model.svg) | Entidades, Value Objects y servicios de dominio |
|
||||
| 3 | Secuencia: Inscripción | [03-sequence-enrollment](./03-sequence-enrollment.svg) | Flujo completo del proceso de inscripción |
|
||||
| 4 | Componentes | [04-components](./04-components.svg) | Arquitectura de componentes frontend y backend |
|
||||
| 5 | Entidad-Relación | [05-entity-relationship](./05-entity-relationship.svg) | Modelo de base de datos |
|
||||
| 6 | Estados: Inscripción | [06-state-enrollment](./06-state-enrollment.svg) | Estados del estudiante según créditos |
|
||||
| 7 | Despliegue | [07-deployment](./07-deployment.svg) | Infraestructura Docker |
|
||||
| 8 | C4 Contexto | [08-c4-context](./08-c4-context.svg) | Vista de alto nivel del sistema |
|
||||
|
||||
## Regenerar Diagramas
|
||||
|
||||
Los archivos `.puml` son la fuente. Para regenerar los SVG:
|
||||
|
||||
```bash
|
||||
cd docs/architecture/diagrams
|
||||
|
||||
# Regenerar todos
|
||||
for f in *.puml; do
|
||||
cat "$f" | plantuml -tsvg -pipe > "${f%.puml}.svg"
|
||||
done
|
||||
|
||||
# O uno específico
|
||||
cat 01-use-cases.puml | plantuml -tsvg -pipe > 01-use-cases.svg
|
||||
```
|
||||
|
||||
## Requisitos
|
||||
|
||||
- [PlantUML](https://plantuml.com/) instalado
|
||||
- Java Runtime (requerido por PlantUML)
|
||||
|
||||
```bash
|
||||
# Ubuntu/Debian
|
||||
sudo apt install plantuml
|
||||
|
||||
# Verificar instalación
|
||||
plantuml -version
|
||||
```
|
||||
|
|
@ -0,0 +1,386 @@
|
|||
# AN-003: Historias de Usuario
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes - Inter Rapidísimo
|
||||
**Rol:** Product Owner
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Épica Principal
|
||||
|
||||
**EP-001: Sistema de Inscripción de Estudiantes**
|
||||
|
||||
Como institución educativa, necesito un sistema web que permita a los estudiantes registrarse e inscribirse en materias siguiendo las reglas del programa de créditos, para gestionar eficientemente el proceso de matrícula.
|
||||
|
||||
---
|
||||
|
||||
## 2. Historias de Usuario
|
||||
|
||||
### US-001: Registro de Estudiante
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-001 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Alta |
|
||||
| **Story Points** | 5 |
|
||||
| **Sprint** | 1 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante nuevo**,
|
||||
> quiero **registrarme en el sistema con mi nombre y correo electrónico**,
|
||||
> para **poder acceder al programa de inscripción de materias**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Registro exitoso de estudiante
|
||||
Given estoy en la página de registro
|
||||
When ingreso un nombre válido "Juan Pérez"
|
||||
And ingreso un email válido "juan@email.com"
|
||||
And presiono el botón "Registrar"
|
||||
Then el sistema crea mi cuenta
|
||||
And veo un mensaje de confirmación
|
||||
And soy redirigido a la página de inscripción
|
||||
|
||||
Scenario: Registro con email duplicado
|
||||
Given existe un estudiante con email "juan@email.com"
|
||||
When intento registrarme con el mismo email
|
||||
Then veo el mensaje "Ya existe un estudiante con este email"
|
||||
And el formulario no se envía
|
||||
|
||||
Scenario: Registro con email inválido
|
||||
Given estoy en la página de registro
|
||||
When ingreso un email inválido "juanemail.com"
|
||||
Then veo el mensaje "Formato de email no válido"
|
||||
And el botón de registro está deshabilitado
|
||||
```
|
||||
|
||||
**Notas Técnicas:**
|
||||
- Validación de email en frontend y backend
|
||||
- Email almacenado en minúsculas (normalización)
|
||||
|
||||
---
|
||||
|
||||
### US-002: Consulta de Materias Disponibles
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-002 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Alta |
|
||||
| **Story Points** | 3 |
|
||||
| **Sprint** | 1 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **ver el catálogo de las 10 materias disponibles**,
|
||||
> para **conocer mis opciones de inscripción**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Ver catálogo completo
|
||||
Given estoy autenticado como estudiante
|
||||
When accedo a la sección de materias
|
||||
Then veo una lista de 10 materias
|
||||
And cada materia muestra nombre, créditos (3) y profesor
|
||||
|
||||
Scenario: Ver detalle de materia
|
||||
Given estoy viendo el catálogo de materias
|
||||
When selecciono "Matemáticas I"
|
||||
Then veo el nombre del profesor asignado
|
||||
And veo que equivale a 3 créditos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### US-003: Inscripción en Materia
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-003 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Alta |
|
||||
| **Story Points** | 8 |
|
||||
| **Sprint** | 1 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **inscribirme en una materia disponible**,
|
||||
> para **acumular créditos en mi programa académico**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Inscripción exitosa
|
||||
Given tengo menos de 3 materias inscritas
|
||||
And la materia "Física I" está disponible para mí
|
||||
When presiono "Inscribir" en "Física I"
|
||||
Then la materia se agrega a mis inscripciones
|
||||
And mis créditos aumentan en 3
|
||||
And veo mensaje de confirmación
|
||||
|
||||
Scenario: Intento inscripción con máximo alcanzado
|
||||
Given ya tengo 3 materias inscritas
|
||||
When intento inscribir otra materia
|
||||
Then veo el mensaje "Ya tienes el máximo de 3 materias"
|
||||
And el botón de inscripción está deshabilitado
|
||||
|
||||
Scenario: Intento inscripción con mismo profesor
|
||||
Given estoy inscrito en "Matemáticas I" (Profesor A)
|
||||
When intento inscribir "Matemáticas II" (Profesor A)
|
||||
Then veo el mensaje "Ya tienes una materia con este profesor"
|
||||
And la inscripción no se procesa
|
||||
```
|
||||
|
||||
**Notas Técnicas:**
|
||||
- Validaciones RN-003 y RN-005 en capa de dominio
|
||||
- Transacción atómica para inscripción
|
||||
|
||||
---
|
||||
|
||||
### US-004: Cancelación de Inscripción
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-004 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Media |
|
||||
| **Story Points** | 3 |
|
||||
| **Sprint** | 1 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante inscrito**,
|
||||
> quiero **cancelar la inscripción de una materia**,
|
||||
> para **liberar espacio y poder inscribir otra**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Cancelación exitosa
|
||||
Given estoy inscrito en "Física I"
|
||||
When presiono "Cancelar inscripción" en esa materia
|
||||
And confirmo la acción
|
||||
Then la materia se elimina de mis inscripciones
|
||||
And mis créditos disminuyen en 3
|
||||
And la materia vuelve a estar disponible
|
||||
|
||||
Scenario: Cancelar con confirmación
|
||||
Given estoy inscrito en "Física I"
|
||||
When presiono "Cancelar inscripción"
|
||||
Then veo un diálogo de confirmación
|
||||
And puedo cancelar o confirmar la acción
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### US-005: Visualización de Materias No Disponibles
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-005 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Media |
|
||||
| **Story Points** | 3 |
|
||||
| **Sprint** | 2 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **ver claramente qué materias no puedo inscribir y por qué**,
|
||||
> para **tomar decisiones informadas sobre mi inscripción**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Ver materias bloqueadas por profesor
|
||||
Given estoy inscrito en "Matemáticas I" (Profesor A)
|
||||
When veo el catálogo de materias
|
||||
Then "Matemáticas II" aparece deshabilitada
|
||||
And veo el tooltip "Ya tienes materia con Profesor A"
|
||||
|
||||
Scenario: Ver contador de materias restantes
|
||||
Given tengo 2 materias inscritas
|
||||
When veo mi panel de inscripción
|
||||
Then veo "2/3 materias inscritas"
|
||||
And veo "Puedes inscribir 1 materia más"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### US-006: Consulta de Otros Estudiantes
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-006 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Baja |
|
||||
| **Story Points** | 2 |
|
||||
| **Sprint** | 2 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **ver la lista de otros estudiantes en el sistema**,
|
||||
> para **conocer quiénes están en el programa**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Ver lista de estudiantes
|
||||
Given estoy autenticado como estudiante
|
||||
When accedo a la sección de estudiantes
|
||||
Then veo una lista de todos los estudiantes registrados
|
||||
And cada estudiante muestra solo su nombre
|
||||
```
|
||||
|
||||
**Notas:**
|
||||
- Por privacidad, no se muestra email ni materias de otros estudiantes
|
||||
|
||||
---
|
||||
|
||||
### US-007: Ver Compañeros de Clase
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-007 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Media |
|
||||
| **Story Points** | 5 |
|
||||
| **Sprint** | 2 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante inscrito en materias**,
|
||||
> quiero **ver los nombres de mis compañeros en cada clase**,
|
||||
> para **conocer con quiénes compartiré el curso**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Ver compañeros por materia
|
||||
Given estoy inscrito en "Física I"
|
||||
And otros estudiantes también están inscritos en "Física I"
|
||||
When accedo a "Mis compañeros de clase"
|
||||
Then veo "Física I" como sección
|
||||
And bajo ella veo la lista de nombres de compañeros
|
||||
|
||||
Scenario: Sin compañeros en materia
|
||||
Given estoy inscrito en "Redes I"
|
||||
And ningún otro estudiante está inscrito en "Redes I"
|
||||
When accedo a "Mis compañeros de clase"
|
||||
Then veo "Redes I" con mensaje "Sin compañeros aún"
|
||||
|
||||
Scenario: Privacidad de datos
|
||||
Given estoy viendo mis compañeros de clase
|
||||
Then solo veo los nombres
|
||||
And NO veo emails ni otras materias de mis compañeros
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### US-008: Actualización de Datos Personales
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-008 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Baja |
|
||||
| **Story Points** | 2 |
|
||||
| **Sprint** | 2 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **actualizar mi nombre o correo electrónico**,
|
||||
> para **mantener mis datos actualizados**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Actualización exitosa de nombre
|
||||
Given estoy en mi perfil
|
||||
When cambio mi nombre a "Juan Carlos Pérez"
|
||||
And presiono "Guardar"
|
||||
Then mis datos se actualizan
|
||||
And veo mensaje de confirmación
|
||||
|
||||
Scenario: Cambio de email a uno existente
|
||||
Given existe otro estudiante con email "otro@email.com"
|
||||
When intento cambiar mi email a "otro@email.com"
|
||||
Then veo el mensaje "Este email ya está registrado"
|
||||
And el cambio no se procesa
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### US-009: Eliminación de Cuenta
|
||||
|
||||
| Campo | Valor |
|
||||
|-------|-------|
|
||||
| **ID** | US-009 |
|
||||
| **Épica** | EP-001 |
|
||||
| **Prioridad** | Baja |
|
||||
| **Story Points** | 2 |
|
||||
| **Sprint** | 2 |
|
||||
|
||||
**Historia:**
|
||||
> Como **estudiante registrado**,
|
||||
> quiero **eliminar mi cuenta del sistema**,
|
||||
> para **remover mis datos si ya no deseo participar**.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
```gherkin
|
||||
Scenario: Eliminación con confirmación
|
||||
Given estoy en mi perfil
|
||||
When presiono "Eliminar cuenta"
|
||||
Then veo un diálogo de confirmación
|
||||
When confirmo la eliminación
|
||||
Then mi cuenta y todas mis inscripciones se eliminan
|
||||
And soy redirigido a la página de inicio
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Backlog Priorizado
|
||||
|
||||
| Prioridad | Historia | Story Points | Sprint |
|
||||
|-----------|----------|--------------|--------|
|
||||
| 1 | US-001: Registro de Estudiante | 5 | 1 |
|
||||
| 2 | US-002: Consulta de Materias | 3 | 1 |
|
||||
| 3 | US-003: Inscripción en Materia | 8 | 1 |
|
||||
| 4 | US-004: Cancelación de Inscripción | 3 | 1 |
|
||||
| 5 | US-005: Materias No Disponibles | 3 | 2 |
|
||||
| 6 | US-007: Ver Compañeros | 5 | 2 |
|
||||
| 7 | US-006: Consulta de Estudiantes | 2 | 2 |
|
||||
| 8 | US-008: Actualizar Datos | 2 | 2 |
|
||||
| 9 | US-009: Eliminar Cuenta | 2 | 2 |
|
||||
|
||||
**Total Story Points:** 33
|
||||
|
||||
---
|
||||
|
||||
## 4. Definición de Listo (DoR)
|
||||
|
||||
- [ ] Historia tiene criterios de aceptación claros
|
||||
- [ ] Dependencias identificadas
|
||||
- [ ] Estimación en story points
|
||||
- [ ] Diseño de UI aprobado (si aplica)
|
||||
- [ ] APIs definidas
|
||||
|
||||
## 5. Definición de Terminado (DoD)
|
||||
|
||||
- [ ] Código implementado y revisado
|
||||
- [ ] Tests unitarios (>80% coverage)
|
||||
- [ ] Tests de integración pasando
|
||||
- [ ] Documentación actualizada
|
||||
- [ ] Validaciones de negocio probadas
|
||||
- [ ] Sin deuda técnica crítica
|
||||
|
||||
---
|
||||
|
||||
## 6. Aprobación
|
||||
|
||||
| Rol | Nombre | Fecha | Firma |
|
||||
|-----|--------|-------|-------|
|
||||
| Product Owner | Sistema | 2026-01-07 | ✓ |
|
||||
| Scrum Master | Pendiente | - | - |
|
||||
| Tech Lead | Pendiente | - | - |
|
||||
|
|
@ -0,0 +1,304 @@
|
|||
# AN-002: Reglas de Negocio
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes - Inter Rapidísimo
|
||||
**Rol:** Analista de Sistemas
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Resumen
|
||||
|
||||
Este documento define las reglas de negocio que gobiernan el sistema de registro de estudiantes. Estas reglas son invariantes y deben ser validadas en la capa de dominio.
|
||||
|
||||
---
|
||||
|
||||
## 2. Reglas de Negocio
|
||||
|
||||
### RN-001: Estructura del Catálogo de Materias
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-001 |
|
||||
| **Nombre** | Catálogo Fijo de Materias |
|
||||
| **Descripción** | El sistema contiene exactamente 10 materias académicas |
|
||||
| **Tipo** | Restricción Estructural |
|
||||
| **Severidad** | Crítica |
|
||||
|
||||
**Datos Iniciales (Seed):**
|
||||
|
||||
| ID | Materia | Profesor Asignado |
|
||||
|----|---------|-------------------|
|
||||
| 1 | Matemáticas I | Profesor A |
|
||||
| 2 | Matemáticas II | Profesor A |
|
||||
| 3 | Física I | Profesor B |
|
||||
| 4 | Física II | Profesor B |
|
||||
| 5 | Programación I | Profesor C |
|
||||
| 6 | Programación II | Profesor C |
|
||||
| 7 | Base de Datos I | Profesor D |
|
||||
| 8 | Base de Datos II | Profesor D |
|
||||
| 9 | Redes I | Profesor E |
|
||||
| 10 | Redes II | Profesor E |
|
||||
|
||||
**Validación:** `COUNT(Subjects) == 10`
|
||||
|
||||
---
|
||||
|
||||
### RN-002: Valor Uniforme de Créditos
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-002 |
|
||||
| **Nombre** | Créditos por Materia |
|
||||
| **Descripción** | Cada materia equivale exactamente a 3 créditos |
|
||||
| **Tipo** | Restricción de Valor |
|
||||
| **Severidad** | Crítica |
|
||||
|
||||
**Fórmula:**
|
||||
```
|
||||
Créditos_Materia = 3 (constante)
|
||||
Créditos_Estudiante = COUNT(Inscripciones) × 3
|
||||
Créditos_Máximos = 9 (3 materias × 3 créditos)
|
||||
```
|
||||
|
||||
**Validación:** `Subject.Credits == 3`
|
||||
|
||||
---
|
||||
|
||||
### RN-003: Límite de Inscripciones por Estudiante
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-003 |
|
||||
| **Nombre** | Máximo 3 Materias |
|
||||
| **Descripción** | Un estudiante solo puede inscribirse en máximo 3 materias |
|
||||
| **Tipo** | Restricción de Cardinalidad |
|
||||
| **Severidad** | Crítica |
|
||||
|
||||
**Escenarios:**
|
||||
|
||||
| Materias Actuales | Acción | Resultado |
|
||||
|-------------------|--------|-----------|
|
||||
| 0-2 | Inscribir | ✓ Permitido |
|
||||
| 3 | Inscribir | ✗ Rechazado |
|
||||
| 1-3 | Cancelar | ✓ Permitido |
|
||||
|
||||
**Validación:** `Student.Enrollments.Count <= 3`
|
||||
|
||||
**Mensaje de Error:** "El estudiante ya tiene el máximo de 3 materias inscritas"
|
||||
|
||||
---
|
||||
|
||||
### RN-004: Asignación Profesores-Materias
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-004 |
|
||||
| **Nombre** | Distribución de Profesores |
|
||||
| **Descripción** | Existen 5 profesores, cada uno dicta exactamente 2 materias |
|
||||
| **Tipo** | Restricción Estructural |
|
||||
| **Severidad** | Crítica |
|
||||
|
||||
**Invariantes:**
|
||||
- `COUNT(Professors) == 5`
|
||||
- `∀ Professor: COUNT(Professor.Subjects) == 2`
|
||||
- `∀ Subject: Subject.Professor != NULL`
|
||||
|
||||
**Validación:**
|
||||
```csharp
|
||||
professors.All(p => p.Subjects.Count == 2)
|
||||
subjects.All(s => s.ProfessorId != null)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RN-005: Restricción de Profesor Único (CRÍTICA)
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-005 |
|
||||
| **Nombre** | Prohibición de Mismo Profesor |
|
||||
| **Descripción** | Un estudiante NO puede inscribirse en dos materias dictadas por el mismo profesor |
|
||||
| **Tipo** | Restricción de Integridad |
|
||||
| **Severidad** | **CRÍTICA** |
|
||||
|
||||
**Lógica de Validación:**
|
||||
|
||||
```
|
||||
PARA inscribir(estudiante, nuevaMateria):
|
||||
profesorNuevaMateria = nuevaMateria.Profesor
|
||||
profesoresActuales = estudiante.Inscripciones.Select(i => i.Materia.Profesor)
|
||||
|
||||
SI profesorNuevaMateria EN profesoresActuales:
|
||||
RECHAZAR "Ya tienes una materia con este profesor"
|
||||
SINO:
|
||||
PERMITIR inscripción
|
||||
```
|
||||
|
||||
**Casos de Prueba:**
|
||||
|
||||
| Estudiante tiene | Intenta inscribir | Resultado |
|
||||
|------------------|-------------------|-----------|
|
||||
| Matemáticas I (Prof A) | Matemáticas II (Prof A) | ✗ Rechazado |
|
||||
| Matemáticas I (Prof A) | Física I (Prof B) | ✓ Permitido |
|
||||
| Física I (Prof B), Programación I (Prof C) | Redes I (Prof E) | ✓ Permitido |
|
||||
| Física I (Prof B), Programación I (Prof C) | Física II (Prof B) | ✗ Rechazado |
|
||||
|
||||
**Mensaje de Error:** "No puedes inscribir {materia} porque ya tienes una materia con {profesor}"
|
||||
|
||||
---
|
||||
|
||||
### RN-006: Unicidad de Email
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-006 |
|
||||
| **Nombre** | Email Único por Estudiante |
|
||||
| **Descripción** | Cada estudiante debe tener un email único en el sistema |
|
||||
| **Tipo** | Restricción de Unicidad |
|
||||
| **Severidad** | Alta |
|
||||
|
||||
**Validación:** `UNIQUE(Student.Email)`
|
||||
|
||||
**Mensaje de Error:** "Ya existe un estudiante registrado con este email"
|
||||
|
||||
---
|
||||
|
||||
### RN-007: Formato de Email Válido
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-007 |
|
||||
| **Nombre** | Validación de Email |
|
||||
| **Descripción** | El email debe cumplir formato estándar RFC 5322 |
|
||||
| **Tipo** | Restricción de Formato |
|
||||
| **Severidad** | Alta |
|
||||
|
||||
**Patrón:** `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
|
||||
|
||||
**Mensaje de Error:** "El formato del email no es válido"
|
||||
|
||||
---
|
||||
|
||||
### RN-008: Visibilidad de Compañeros
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RN-008 |
|
||||
| **Nombre** | Privacidad de Datos |
|
||||
| **Descripción** | Un estudiante solo puede ver el NOMBRE de sus compañeros de clase |
|
||||
| **Tipo** | Restricción de Privacidad |
|
||||
| **Severidad** | Media |
|
||||
|
||||
**Datos Visibles:**
|
||||
- ✓ Nombre del compañero
|
||||
- ✗ Email del compañero
|
||||
- ✗ Otras materias del compañero
|
||||
|
||||
**Condición:** Solo aplica para materias donde ambos estudiantes están inscritos
|
||||
|
||||
---
|
||||
|
||||
## 3. Matriz de Validación por Capa
|
||||
|
||||
| Regla | Domain | Application | Adapter |
|
||||
|-------|--------|-------------|---------|
|
||||
| RN-001 | ✗ | ✗ | Seed Data |
|
||||
| RN-002 | ValueObject | ✗ | ✗ |
|
||||
| RN-003 | DomainService | ✗ | ✗ |
|
||||
| RN-004 | ✗ | ✗ | Seed Data |
|
||||
| RN-005 | **DomainService** | ✗ | ✗ |
|
||||
| RN-006 | ✗ | Validator | DB Constraint |
|
||||
| RN-007 | ValueObject | Validator | ✗ |
|
||||
| RN-008 | ✗ | Query Handler | ✗ |
|
||||
|
||||
---
|
||||
|
||||
## 4. Implementación en Código
|
||||
|
||||
### RN-003 y RN-005 (Domain Service)
|
||||
|
||||
```csharp
|
||||
// Domain/Services/EnrollmentDomainService.cs
|
||||
public class EnrollmentDomainService
|
||||
{
|
||||
public Result ValidateEnrollment(Student student, Subject newSubject)
|
||||
{
|
||||
// RN-003: Máximo 3 materias
|
||||
if (student.Enrollments.Count >= 3)
|
||||
return Result.Failure("MAX_ENROLLMENTS_EXCEEDED");
|
||||
|
||||
// RN-005: No repetir profesor
|
||||
var existingProfessorIds = student.Enrollments
|
||||
.Select(e => e.Subject.ProfessorId)
|
||||
.ToHashSet();
|
||||
|
||||
if (existingProfessorIds.Contains(newSubject.ProfessorId))
|
||||
return Result.Failure("SAME_PROFESSOR_CONSTRAINT");
|
||||
|
||||
return Result.Success();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### RN-007 (Value Object)
|
||||
|
||||
```csharp
|
||||
// Domain/ValueObjects/Email.cs
|
||||
public record Email
|
||||
{
|
||||
public string Value { get; }
|
||||
|
||||
private Email(string value) => Value = value;
|
||||
|
||||
public static Result<Email> Create(string email)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(email))
|
||||
return Result.Failure<Email>("EMAIL_REQUIRED");
|
||||
|
||||
if (!EmailRegex.IsMatch(email))
|
||||
return Result.Failure<Email>("EMAIL_INVALID_FORMAT");
|
||||
|
||||
return Result.Success(new Email(email.ToLowerInvariant()));
|
||||
}
|
||||
|
||||
private static readonly Regex EmailRegex = new(
|
||||
@"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$",
|
||||
RegexOptions.Compiled);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Diagrama de Restricciones
|
||||
|
||||
```
|
||||
┌─────────────────────┐
|
||||
│ ESTUDIANTE │
|
||||
│ - Nombre │
|
||||
│ - Email (único) │
|
||||
└──────────┬──────────┘
|
||||
│
|
||||
│ máx 3 inscripciones
|
||||
│ (RN-003)
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ INSCRIPCIÓN │
|
||||
└──────────┬──────────┘
|
||||
│
|
||||
no puede repetir │ profesor (RN-005)
|
||||
▼
|
||||
┌─────────────┐ ┌─────────────────────┐ ┌─────────────┐
|
||||
│ PROFESOR │──────│ MATERIA │──────│ 3 CRÉDITOS │
|
||||
│ (5 total) │ 1:2 │ (10 total) │ │ (RN-002) │
|
||||
└─────────────┘ └─────────────────────┘ └─────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Aprobación
|
||||
|
||||
| Rol | Nombre | Fecha | Firma |
|
||||
|-----|--------|-------|-------|
|
||||
| Analista | Sistema | 2026-01-07 | ✓ |
|
||||
| Product Owner | Pendiente | - | - |
|
||||
| Arquitecto | Pendiente | - | - |
|
||||
|
|
@ -0,0 +1,208 @@
|
|||
# AN-001: Análisis de Requisitos Funcionales
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes - Inter Rapidísimo
|
||||
**Rol:** Analista de Sistemas
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Resumen Ejecutivo
|
||||
|
||||
Sistema web para gestión de inscripciones estudiantiles con programa de créditos académicos. Permite CRUD de estudiantes, inscripción en materias con restricciones de negocio, y visualización de compañeros de clase.
|
||||
|
||||
---
|
||||
|
||||
## 2. Requisitos Funcionales Identificados
|
||||
|
||||
### RF-001: Registro de Estudiantes (CRUD)
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-001 |
|
||||
| **Nombre** | Gestión CRUD de Estudiantes |
|
||||
| **Descripción** | El sistema debe permitir crear, leer, actualizar y eliminar registros de estudiantes |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 1 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-001.1: Usuario puede crear estudiante con nombre y email válido
|
||||
- [ ] CA-001.2: Usuario puede consultar lista de estudiantes registrados
|
||||
- [ ] CA-001.3: Usuario puede actualizar datos de un estudiante existente
|
||||
- [ ] CA-001.4: Usuario puede eliminar un estudiante (cascade con inscripciones)
|
||||
- [ ] CA-001.5: Email debe ser único en el sistema
|
||||
|
||||
---
|
||||
|
||||
### RF-002: Programa de Créditos
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-002 |
|
||||
| **Nombre** | Adhesión a Programa de Créditos |
|
||||
| **Descripción** | Los estudiantes se inscriben en un programa basado en créditos académicos |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 2 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-002.1: Sistema muestra créditos totales del estudiante
|
||||
- [ ] CA-002.2: Créditos se calculan automáticamente según materias inscritas
|
||||
- [ ] CA-002.3: Máximo 9 créditos por estudiante (3 materias × 3 créditos)
|
||||
|
||||
---
|
||||
|
||||
### RF-003: Catálogo de Materias
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-003 |
|
||||
| **Nombre** | Gestión de 10 Materias |
|
||||
| **Descripción** | El sistema debe gestionar un catálogo fijo de 10 materias académicas |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 3 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-003.1: Sistema contiene exactamente 10 materias predefinidas
|
||||
- [ ] CA-003.2: Usuario puede consultar catálogo completo de materias
|
||||
- [ ] CA-003.3: Cada materia muestra nombre, créditos y profesor asignado
|
||||
|
||||
---
|
||||
|
||||
### RF-004: Valor de Créditos por Materia
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-004 |
|
||||
| **Nombre** | Asignación de 3 Créditos por Materia |
|
||||
| **Descripción** | Cada materia del catálogo equivale a exactamente 3 créditos |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 4 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-004.1: Todas las materias tienen valor fijo de 3 créditos
|
||||
- [ ] CA-004.2: Sistema muestra créditos en detalle de cada materia
|
||||
|
||||
---
|
||||
|
||||
### RF-005: Límite de Materias por Estudiante
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-005 |
|
||||
| **Nombre** | Máximo 3 Materias por Estudiante |
|
||||
| **Descripción** | Un estudiante solo puede inscribirse en máximo 3 materias |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 5 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-005.1: Sistema impide inscripción si estudiante ya tiene 3 materias
|
||||
- [ ] CA-005.2: Sistema muestra contador de materias inscritas
|
||||
- [ ] CA-005.3: Mensaje de error claro al intentar exceder límite
|
||||
|
||||
---
|
||||
|
||||
### RF-006: Asignación Profesores-Materias
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-006 |
|
||||
| **Nombre** | 5 Profesores con 2 Materias c/u |
|
||||
| **Descripción** | El sistema tiene 5 profesores, cada uno dicta exactamente 2 materias |
|
||||
| **Prioridad** | Alta |
|
||||
| **Fuente** | Enunciado punto 6 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-006.1: Sistema contiene exactamente 5 profesores predefinidos
|
||||
- [ ] CA-006.2: Cada profesor tiene asignadas exactamente 2 materias
|
||||
- [ ] CA-006.3: Usuario puede ver qué profesor dicta cada materia
|
||||
|
||||
---
|
||||
|
||||
### RF-007: Restricción de Profesor Único
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-007 |
|
||||
| **Nombre** | Prohibición de Mismo Profesor |
|
||||
| **Descripción** | Un estudiante no puede inscribirse en dos materias del mismo profesor |
|
||||
| **Prioridad** | Crítica |
|
||||
| **Fuente** | Enunciado punto 7 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-007.1: Sistema valida profesor al momento de inscripción
|
||||
- [ ] CA-007.2: Materias no disponibles se muestran deshabilitadas con razón
|
||||
- [ ] CA-007.3: Mensaje de error específico: "Ya tienes una materia con este profesor"
|
||||
|
||||
---
|
||||
|
||||
### RF-008: Visualización de Registros
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-008 |
|
||||
| **Nombre** | Consulta de Otros Estudiantes |
|
||||
| **Descripción** | Cada estudiante puede ver en línea los registros de otros estudiantes |
|
||||
| **Prioridad** | Media |
|
||||
| **Fuente** | Enunciado punto 8 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-008.1: Usuario puede ver lista de todos los estudiantes registrados
|
||||
- [ ] CA-008.2: Información visible: nombre (según restricciones de privacidad)
|
||||
|
||||
---
|
||||
|
||||
### RF-009: Compañeros de Clase
|
||||
|
||||
| Atributo | Descripción |
|
||||
|----------|-------------|
|
||||
| **ID** | RF-009 |
|
||||
| **Nombre** | Ver Nombres de Compañeros por Materia |
|
||||
| **Descripción** | El estudiante puede ver solo el nombre de alumnos con quienes compartirá clase |
|
||||
| **Prioridad** | Media |
|
||||
| **Fuente** | Enunciado punto 9 |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] CA-009.1: Sistema muestra compañeros agrupados por materia
|
||||
- [ ] CA-009.2: Solo se muestra el nombre (no email ni otros datos)
|
||||
- [ ] CA-009.3: Solo muestra compañeros de materias donde está inscrito
|
||||
|
||||
---
|
||||
|
||||
## 3. Matriz de Trazabilidad
|
||||
|
||||
| Requisito | Historia | Componente Backend | Componente Frontend |
|
||||
|-----------|----------|-------------------|---------------------|
|
||||
| RF-001 | US-001 | StudentController, StudentService | StudentFormComponent |
|
||||
| RF-002 | US-002 | EnrollmentService | DashboardComponent |
|
||||
| RF-003 | US-003 | SubjectController | SubjectListComponent |
|
||||
| RF-004 | US-003 | Subject Entity | SubjectCardComponent |
|
||||
| RF-005 | US-004 | EnrollmentValidator | EnrollmentComponent |
|
||||
| RF-006 | US-003 | Professor Entity | ProfessorListComponent |
|
||||
| RF-007 | US-005 | EnrollmentDomainService | EnrollmentComponent |
|
||||
| RF-008 | US-006 | StudentQuery | StudentListComponent |
|
||||
| RF-009 | US-007 | ClassmatesQuery | ClassmatesComponent |
|
||||
|
||||
---
|
||||
|
||||
## 4. Dependencias entre Requisitos
|
||||
|
||||
```
|
||||
RF-001 (Estudiantes)
|
||||
↓
|
||||
RF-002 (Programa Créditos) ← RF-004 (3 créditos/materia)
|
||||
↓
|
||||
RF-005 (Max 3 materias) ← RF-003 (10 materias)
|
||||
↓ ↓
|
||||
RF-007 (Restricción profesor) ← RF-006 (5 profesores)
|
||||
↓
|
||||
RF-008/RF-009 (Visualización)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Aprobación
|
||||
|
||||
| Rol | Nombre | Fecha | Firma |
|
||||
|-----|--------|-------|-------|
|
||||
| Analista | Sistema | 2026-01-07 | ✓ |
|
||||
| Product Owner | Pendiente | - | - |
|
||||
| Líder Técnico | Pendiente | - | - |
|
||||
|
|
@ -0,0 +1,315 @@
|
|||
# AN-004: Requisitos No Funcionales
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes - Inter Rapidísimo
|
||||
**Rol:** Arquitecto de Software
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Resumen
|
||||
|
||||
Este documento define los atributos de calidad (requisitos no funcionales) que el sistema debe cumplir, estableciendo métricas medibles y criterios de aceptación.
|
||||
|
||||
---
|
||||
|
||||
## 2. Requisitos No Funcionales
|
||||
|
||||
### RNF-001: Rendimiento - Tiempo de Respuesta
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-001 |
|
||||
| **Categoría** | Rendimiento |
|
||||
| **Prioridad** | Alta |
|
||||
| **Métrica** | Tiempo de respuesta < 200ms (P95) |
|
||||
|
||||
**Descripción:**
|
||||
El sistema debe responder a las solicitudes del usuario en menos de 200 milisegundos en el percentil 95.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
|
||||
| Operación | Tiempo Máximo |
|
||||
|-----------|---------------|
|
||||
| Consulta lista de estudiantes | < 150ms |
|
||||
| Consulta catálogo materias | < 100ms |
|
||||
| Inscripción en materia | < 200ms |
|
||||
| Crear/actualizar estudiante | < 200ms |
|
||||
| Consulta compañeros de clase | < 150ms |
|
||||
|
||||
**Medición:**
|
||||
- Herramienta: Application Insights / Logs estructurados
|
||||
- Ambiente: Producción simulada
|
||||
- Carga: 100 usuarios concurrentes
|
||||
|
||||
---
|
||||
|
||||
### RNF-002: Rendimiento - Throughput
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-002 |
|
||||
| **Categoría** | Rendimiento |
|
||||
| **Prioridad** | Media |
|
||||
| **Métrica** | >= 500 requests/segundo |
|
||||
|
||||
**Descripción:**
|
||||
El sistema debe soportar al menos 500 solicitudes por segundo sin degradación.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] API soporta 500 req/s con latencia < 200ms
|
||||
- [ ] Sin errores 5xx bajo carga normal
|
||||
- [ ] CPU < 80% bajo carga máxima
|
||||
|
||||
---
|
||||
|
||||
### RNF-003: Seguridad - OWASP Top 10
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-003 |
|
||||
| **Categoría** | Seguridad |
|
||||
| **Prioridad** | Crítica |
|
||||
| **Estándar** | OWASP Top 10 2021 |
|
||||
|
||||
**Descripción:**
|
||||
El sistema debe estar protegido contra las 10 vulnerabilidades más críticas según OWASP.
|
||||
|
||||
**Controles por Vulnerabilidad:**
|
||||
|
||||
| # | Vulnerabilidad | Control Implementado |
|
||||
|---|----------------|----------------------|
|
||||
| A01 | Broken Access Control | Validación de permisos en cada endpoint |
|
||||
| A02 | Cryptographic Failures | HTTPS obligatorio, hashing de datos sensibles |
|
||||
| A03 | Injection | Consultas parametrizadas (EF Core), validación de entrada |
|
||||
| A04 | Insecure Design | Clean Architecture, validación en dominio |
|
||||
| A05 | Security Misconfiguration | Headers de seguridad, CORS restrictivo |
|
||||
| A06 | Vulnerable Components | Auditoría de dependencias (`dotnet list package --vulnerable`) |
|
||||
| A07 | Auth Failures | Rate limiting, validación de sesión |
|
||||
| A08 | Data Integrity Failures | Validación de DTOs, firma de respuestas |
|
||||
| A09 | Logging Failures | Logs estructurados sin datos sensibles |
|
||||
| A10 | SSRF | Validación de URLs, no fetch de recursos externos |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Análisis SAST sin vulnerabilidades críticas
|
||||
- [ ] Headers de seguridad configurados (CSP, X-Frame-Options, etc.)
|
||||
- [ ] Sin secretos en código fuente
|
||||
- [ ] HTTPS en todos los endpoints
|
||||
|
||||
---
|
||||
|
||||
### RNF-004: Seguridad - Validación de Entrada
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-004 |
|
||||
| **Categoría** | Seguridad |
|
||||
| **Prioridad** | Alta |
|
||||
|
||||
**Descripción:**
|
||||
Toda entrada del usuario debe ser validada tanto en frontend como en backend.
|
||||
|
||||
**Reglas de Validación:**
|
||||
|
||||
| Campo | Regla Frontend | Regla Backend |
|
||||
|-------|----------------|---------------|
|
||||
| Nombre | Required, MaxLength(100) | FluentValidation |
|
||||
| Email | Required, EmailFormat | ValueObject + Validator |
|
||||
| IDs | Numeric | Tipo fuerte (int) |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Ningún input llega a la BD sin validación
|
||||
- [ ] Mensajes de error claros y sin información sensible
|
||||
- [ ] Sanitización de HTML en campos de texto
|
||||
|
||||
---
|
||||
|
||||
### RNF-005: Usabilidad - Responsive Design
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-005 |
|
||||
| **Categoría** | Usabilidad |
|
||||
| **Prioridad** | Alta |
|
||||
| **Estándar** | Mobile First |
|
||||
|
||||
**Descripción:**
|
||||
La interfaz debe adaptarse correctamente a diferentes tamaños de pantalla.
|
||||
|
||||
**Breakpoints Soportados:**
|
||||
|
||||
| Dispositivo | Ancho | Soporte |
|
||||
|-------------|-------|---------|
|
||||
| Mobile | 320px - 480px | Obligatorio |
|
||||
| Tablet | 481px - 768px | Obligatorio |
|
||||
| Desktop | 769px - 1024px | Obligatorio |
|
||||
| Large Desktop | > 1024px | Obligatorio |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] UI funcional en Chrome, Firefox, Safari, Edge
|
||||
- [ ] Sin scroll horizontal en mobile
|
||||
- [ ] Formularios usables con teclado virtual
|
||||
- [ ] Touch targets >= 44px
|
||||
|
||||
---
|
||||
|
||||
### RNF-006: Usabilidad - Accesibilidad
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-006 |
|
||||
| **Categoría** | Usabilidad |
|
||||
| **Prioridad** | Media |
|
||||
| **Estándar** | WCAG 2.1 Nivel AA |
|
||||
|
||||
**Descripción:**
|
||||
El sistema debe ser accesible para usuarios con discapacidades.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Contraste de colores >= 4.5:1
|
||||
- [ ] Navegación completa por teclado
|
||||
- [ ] Labels en todos los inputs
|
||||
- [ ] Atributos ARIA donde corresponda
|
||||
- [ ] Textos alternativos en imágenes
|
||||
|
||||
---
|
||||
|
||||
### RNF-007: Mantenibilidad - Cobertura de Tests
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-007 |
|
||||
| **Categoría** | Mantenibilidad |
|
||||
| **Prioridad** | Alta |
|
||||
| **Métrica** | >= 80% cobertura |
|
||||
|
||||
**Descripción:**
|
||||
El código debe tener una cobertura de tests unitarios mínima del 80%.
|
||||
|
||||
**Distribución de Tests:**
|
||||
|
||||
| Capa | Cobertura Mínima | Tipo de Tests |
|
||||
|------|------------------|---------------|
|
||||
| Domain | 90% | Unit tests |
|
||||
| Application | 85% | Unit + Integration |
|
||||
| Adapters | 70% | Integration |
|
||||
| Frontend | 75% | Unit + Component |
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Cobertura global >= 80%
|
||||
- [ ] Todas las reglas de negocio con tests
|
||||
- [ ] Tests ejecutables en CI/CD
|
||||
|
||||
---
|
||||
|
||||
### RNF-008: Mantenibilidad - Calidad de Código
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-008 |
|
||||
| **Categoría** | Mantenibilidad |
|
||||
| **Prioridad** | Media |
|
||||
|
||||
**Descripción:**
|
||||
El código debe seguir estándares de calidad medibles.
|
||||
|
||||
**Métricas:**
|
||||
|
||||
| Métrica | Umbral |
|
||||
|---------|--------|
|
||||
| Complejidad ciclomática | < 10 por método |
|
||||
| Duplicación de código | < 3% |
|
||||
| Archivos | < 100 líneas |
|
||||
| Métodos | < 30 líneas |
|
||||
| Warnings del compilador | 0 |
|
||||
|
||||
**Herramientas:**
|
||||
- .NET: `dotnet format`, Roslyn Analyzers
|
||||
- Angular: ESLint, Prettier
|
||||
|
||||
---
|
||||
|
||||
### RNF-009: Disponibilidad
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-009 |
|
||||
| **Categoría** | Disponibilidad |
|
||||
| **Prioridad** | Media |
|
||||
| **Métrica** | 99% uptime |
|
||||
|
||||
**Descripción:**
|
||||
El sistema debe estar disponible el 99% del tiempo durante horario laboral.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Health checks implementados
|
||||
- [ ] Reinicio automático ante fallos
|
||||
- [ ] Graceful shutdown
|
||||
- [ ] Logs de errores para diagnóstico
|
||||
|
||||
---
|
||||
|
||||
### RNF-010: Escalabilidad
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RNF-010 |
|
||||
| **Categoría** | Escalabilidad |
|
||||
| **Prioridad** | Baja |
|
||||
|
||||
**Descripción:**
|
||||
La arquitectura debe permitir escalado horizontal sin cambios de código.
|
||||
|
||||
**Criterios de Aceptación:**
|
||||
- [ ] Aplicación stateless
|
||||
- [ ] Configuración externalizada
|
||||
- [ ] Base de datos separada de aplicación
|
||||
- [ ] Contenedores Docker funcionales
|
||||
|
||||
---
|
||||
|
||||
## 3. Matriz de Priorización
|
||||
|
||||
| ID | Requisito | Prioridad | Impacto | Esfuerzo |
|
||||
|----|-----------|-----------|---------|----------|
|
||||
| RNF-003 | Seguridad OWASP | Crítica | Alto | Alto |
|
||||
| RNF-001 | Tiempo respuesta | Alta | Alto | Medio |
|
||||
| RNF-004 | Validación entrada | Alta | Alto | Medio |
|
||||
| RNF-005 | Responsive | Alta | Alto | Medio |
|
||||
| RNF-007 | Cobertura tests | Alta | Medio | Alto |
|
||||
| RNF-002 | Throughput | Media | Medio | Medio |
|
||||
| RNF-006 | Accesibilidad | Media | Medio | Medio |
|
||||
| RNF-008 | Calidad código | Media | Medio | Bajo |
|
||||
| RNF-009 | Disponibilidad | Media | Alto | Medio |
|
||||
| RNF-010 | Escalabilidad | Baja | Bajo | Alto |
|
||||
|
||||
---
|
||||
|
||||
## 4. Estrategia de Validación
|
||||
|
||||
### Tests de Rendimiento
|
||||
```bash
|
||||
# k6 para load testing
|
||||
k6 run --vus 100 --duration 30s tests/performance/api-load.js
|
||||
```
|
||||
|
||||
### Tests de Seguridad
|
||||
```bash
|
||||
# OWASP ZAP scan
|
||||
docker run -t owasp/zap2docker-stable zap-baseline.py -t https://localhost:5001
|
||||
```
|
||||
|
||||
### Tests de Accesibilidad
|
||||
```bash
|
||||
# Lighthouse CI
|
||||
npx lighthouse https://localhost:4200 --only-categories=accessibility
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Aprobación
|
||||
|
||||
| Rol | Nombre | Fecha | Firma |
|
||||
|-----|--------|-------|-------|
|
||||
| Arquitecto | Sistema | 2026-01-07 | ✓ |
|
||||
| Líder Técnico | Pendiente | - | - |
|
||||
| QA Lead | Pendiente | - | - |
|
||||
|
|
@ -0,0 +1,400 @@
|
|||
# AN-005: Análisis de Riesgos Técnicos
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes - Inter Rapidísimo
|
||||
**Rol:** Líder Técnico
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Resumen
|
||||
|
||||
Identificación y evaluación de riesgos técnicos que podrían impactar el desarrollo, calidad o entrega del sistema. Cada riesgo incluye probabilidad, impacto y estrategia de mitigación.
|
||||
|
||||
---
|
||||
|
||||
## 2. Matriz de Evaluación
|
||||
|
||||
| Probabilidad / Impacto | Bajo (1) | Medio (2) | Alto (3) |
|
||||
|------------------------|----------|-----------|----------|
|
||||
| **Alta (3)** | 3 | 6 | **9** |
|
||||
| **Media (2)** | 2 | 4 | 6 |
|
||||
| **Baja (1)** | 1 | 2 | 3 |
|
||||
|
||||
**Clasificación:**
|
||||
- **Crítico:** 6-9 (acción inmediata)
|
||||
- **Moderado:** 3-5 (plan de mitigación)
|
||||
- **Bajo:** 1-2 (monitorear)
|
||||
|
||||
---
|
||||
|
||||
## 3. Riesgos Identificados
|
||||
|
||||
### RT-001: Complejidad de Validaciones Cruzadas
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-001 |
|
||||
| **Categoría** | Desarrollo |
|
||||
| **Probabilidad** | Alta (3) |
|
||||
| **Impacto** | Alto (3) |
|
||||
| **Score** | **9 - Crítico** |
|
||||
|
||||
**Descripción:**
|
||||
Las validaciones de negocio (máximo 3 materias + no repetir profesor) requieren consultas cruzadas entre entidades. Una implementación incorrecta puede generar condiciones de carrera o validaciones inconsistentes.
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Dos inscripciones concurrentes del mismo estudiante
|
||||
2. Validación en frontend que no se replica en backend
|
||||
3. Race condition al verificar profesor duplicado
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Implementar validaciones en Domain Service (única fuente de verdad) | Dev Senior | Sprint 1 |
|
||||
| Usar transacciones con nivel de aislamiento Serializable | Dev Senior | Sprint 1 |
|
||||
| Tests de concurrencia con múltiples threads | QA | Sprint 1 |
|
||||
| Lock optimista con RowVersion en Enrollment | Dev | Sprint 1 |
|
||||
|
||||
**Código de Mitigación:**
|
||||
```csharp
|
||||
// Transacción con locking
|
||||
await using var transaction = await _context.Database
|
||||
.BeginTransactionAsync(IsolationLevel.Serializable);
|
||||
|
||||
var student = await _context.Students
|
||||
.Include(s => s.Enrollments)
|
||||
.ThenInclude(e => e.Subject)
|
||||
.FirstOrDefaultAsync(s => s.Id == command.StudentId);
|
||||
|
||||
// Validaciones en dominio
|
||||
_enrollmentService.ValidateEnrollment(student, subject);
|
||||
|
||||
await _context.SaveChangesAsync();
|
||||
await transaction.CommitAsync();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RT-002: Integración Frontend-Backend (GraphQL)
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-002 |
|
||||
| **Categoría** | Integración |
|
||||
| **Probabilidad** | Media (2) |
|
||||
| **Impacto** | Alto (3) |
|
||||
| **Score** | **6 - Crítico** |
|
||||
|
||||
**Descripción:**
|
||||
GraphQL introduce complejidad adicional en la integración. Errores en el esquema, types incorrectos o problemas de N+1 queries pueden afectar rendimiento y desarrollo.
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Mismatch entre schema GraphQL y DTOs
|
||||
2. N+1 queries sin DataLoaders
|
||||
3. Errores de tipos en Apollo Angular
|
||||
4. Over-fetching o under-fetching de datos
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Generar tipos TypeScript desde schema (codegen) | Dev Frontend | Sprint 1 |
|
||||
| Implementar DataLoaders para todas las relaciones | Dev Backend | Sprint 1 |
|
||||
| Configurar GraphQL Voyager para visualizar schema | Dev | Sprint 1 |
|
||||
| Tests de integración GraphQL con Banana Cake Pop | QA | Sprint 1 |
|
||||
|
||||
**Configuración DataLoader:**
|
||||
```csharp
|
||||
// DataLoader para evitar N+1
|
||||
public class SubjectByIdDataLoader : BatchDataLoader<int, Subject>
|
||||
{
|
||||
protected override async Task<IReadOnlyDictionary<int, Subject>> LoadBatchAsync(
|
||||
IReadOnlyList<int> keys, CancellationToken ct)
|
||||
{
|
||||
return await _context.Subjects
|
||||
.Where(s => keys.Contains(s.Id))
|
||||
.ToDictionaryAsync(s => s.Id, ct);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RT-003: Manejo de Concurrencia
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-003 |
|
||||
| **Categoría** | Arquitectura |
|
||||
| **Probabilidad** | Media (2) |
|
||||
| **Impacto** | Alto (3) |
|
||||
| **Score** | **6 - Crítico** |
|
||||
|
||||
**Descripción:**
|
||||
Múltiples usuarios podrían intentar inscribirse en la misma materia simultáneamente, generando conflictos o violaciones de reglas de negocio.
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Dos estudiantes inscriben la última plaza disponible
|
||||
2. Estudiante inscribe 4ta materia por request concurrente
|
||||
3. Datos obsoletos en UI mientras otro usuario modifica
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Implementar Optimistic Concurrency (RowVersion) | Dev Backend | Sprint 1 |
|
||||
| Revalidar en backend siempre (no confiar en frontend) | Dev Backend | Sprint 1 |
|
||||
| Mostrar toast de "datos actualizados" en conflictos | Dev Frontend | Sprint 2 |
|
||||
| Tests de stress con k6 | QA | Sprint 2 |
|
||||
|
||||
**Implementación:**
|
||||
```csharp
|
||||
// Entidad con concurrencia optimista
|
||||
public class Student
|
||||
{
|
||||
[Timestamp]
|
||||
public byte[] RowVersion { get; set; }
|
||||
}
|
||||
|
||||
// Manejo de conflicto
|
||||
catch (DbUpdateConcurrencyException)
|
||||
{
|
||||
return Result.Failure("CONCURRENT_MODIFICATION");
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RT-004: Rendimiento de Consultas Anidadas
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-004 |
|
||||
| **Categoría** | Rendimiento |
|
||||
| **Probabilidad** | Media (2) |
|
||||
| **Impacto** | Medio (2) |
|
||||
| **Score** | **4 - Moderado** |
|
||||
|
||||
**Descripción:**
|
||||
Consultas GraphQL anidadas (estudiantes → inscripciones → materias → profesores) pueden generar queries pesadas si no se optimizan.
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Query de todos los estudiantes con todas sus relaciones
|
||||
2. Timeouts en consultas sin límite de profundidad
|
||||
3. Consumo excesivo de memoria en serialización
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Configurar límite de profundidad en HotChocolate (max 5) | Dev Backend | Sprint 1 |
|
||||
| Implementar paginación en queries de listas | Dev Backend | Sprint 1 |
|
||||
| Indexar campos de búsqueda (Email, ProfessorId) | DBA | Sprint 1 |
|
||||
| Query complexity analyzer | Dev Backend | Sprint 2 |
|
||||
|
||||
**Configuración:**
|
||||
```csharp
|
||||
services.AddGraphQLServer()
|
||||
.SetMaxAllowedExecutionDepth(5)
|
||||
.SetPagingOptions(new PagingOptions
|
||||
{
|
||||
MaxPageSize = 50,
|
||||
DefaultPageSize = 20
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RT-005: Curva de Aprendizaje del Stack
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-005 |
|
||||
| **Categoría** | Equipo |
|
||||
| **Probabilidad** | Alta (3) |
|
||||
| **Impacto** | Bajo (1) |
|
||||
| **Score** | **3 - Moderado** |
|
||||
|
||||
**Descripción:**
|
||||
El stack incluye tecnologías relativamente nuevas (HotChocolate, Angular Signals, Apollo Angular) que pueden requerir tiempo de aprendizaje.
|
||||
|
||||
**Tecnologías con Curva:**
|
||||
- HotChocolate (GraphQL .NET)
|
||||
- Mapster (alternativa a AutoMapper)
|
||||
- Angular Signals
|
||||
- Apollo Angular
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Documentar patrones y ejemplos en wiki | Tech Lead | Sprint 1 |
|
||||
| Code reviews detallados en PRs | Senior Dev | Continuo |
|
||||
| Spike técnico para DataLoaders | Dev Backend | Sprint 1 |
|
||||
| Usar generador de código Apollo | Dev Frontend | Sprint 1 |
|
||||
|
||||
---
|
||||
|
||||
### RT-006: Seguridad en GraphQL
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-006 |
|
||||
| **Categoría** | Seguridad |
|
||||
| **Probabilidad** | Baja (1) |
|
||||
| **Impacto** | Alto (3) |
|
||||
| **Score** | **3 - Moderado** |
|
||||
|
||||
**Descripción:**
|
||||
GraphQL expone un endpoint flexible que puede ser abusado con queries maliciosas (deeply nested, introspection en prod, DoS).
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Query extremadamente anidada consume recursos
|
||||
2. Introspection expone schema sensible
|
||||
3. Mutation masiva sin rate limiting
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Deshabilitar introspection en producción | DevOps | Deploy |
|
||||
| Configurar query complexity limits | Dev Backend | Sprint 1 |
|
||||
| Rate limiting por IP (10 req/s) | DevOps | Sprint 2 |
|
||||
| Persisted queries en producción | Dev Backend | Sprint 3 |
|
||||
|
||||
**Configuración:**
|
||||
```csharp
|
||||
services.AddGraphQLServer()
|
||||
.AddMaxComplexityRule(100) // Límite de complejidad
|
||||
.AddMaxExecutionDepthRule(5)
|
||||
.ModifyOptions(o =>
|
||||
{
|
||||
// Deshabilitar introspection en prod
|
||||
if (!env.IsDevelopment())
|
||||
o.EnableSchemaIntrospection = false;
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### RT-007: Migración y Seeding de Datos
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-007 |
|
||||
| **Categoría** | Base de Datos |
|
||||
| **Probabilidad** | Baja (1) |
|
||||
| **Impacto** | Medio (2) |
|
||||
| **Score** | **2 - Bajo** |
|
||||
|
||||
**Descripción:**
|
||||
Los datos iniciales (5 profesores, 10 materias) deben estar correctamente relacionados. Errores en seeding pueden romper reglas de negocio.
|
||||
|
||||
**Escenarios de Riesgo:**
|
||||
1. Profesor asignado a más de 2 materias
|
||||
2. IDs inconsistentes entre migraciones
|
||||
3. Datos duplicados en re-ejecución de seed
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Seeding idempotente (verificar existencia) | Dev Backend | Sprint 1 |
|
||||
| Validación post-seed en tests | QA | Sprint 1 |
|
||||
| Script de verificación de integridad | DBA | Sprint 1 |
|
||||
|
||||
---
|
||||
|
||||
### RT-008: Testing de Reglas de Negocio
|
||||
|
||||
| Atributo | Valor |
|
||||
|----------|-------|
|
||||
| **ID** | RT-008 |
|
||||
| **Categoría** | Calidad |
|
||||
| **Probabilidad** | Media (2) |
|
||||
| **Impacto** | Medio (2) |
|
||||
| **Score** | **4 - Moderado** |
|
||||
|
||||
**Descripción:**
|
||||
Las reglas de negocio complejas requieren cobertura exhaustiva de tests. Casos edge pueden quedar sin probar.
|
||||
|
||||
**Casos Edge Críticos:**
|
||||
1. Inscribir materia 3 cuando ya tiene 2 del mismo "tipo"
|
||||
2. Cancelar inscripción y re-inscribir rápidamente
|
||||
3. Estudiante con 3 materias intenta cambiar una
|
||||
|
||||
**Estrategia de Mitigación:**
|
||||
|
||||
| Acción | Responsable | Plazo |
|
||||
|--------|-------------|-------|
|
||||
| Property-based testing para combinaciones | QA | Sprint 1 |
|
||||
| Matriz de casos de prueba exhaustiva | QA | Sprint 1 |
|
||||
| Mutation testing (Stryker) | QA | Sprint 2 |
|
||||
|
||||
---
|
||||
|
||||
## 4. Matriz de Riesgos Consolidada
|
||||
|
||||
| ID | Riesgo | Prob | Impacto | Score | Prioridad |
|
||||
|----|--------|------|---------|-------|-----------|
|
||||
| RT-001 | Validaciones cruzadas | 3 | 3 | **9** | 1 |
|
||||
| RT-002 | Integración GraphQL | 2 | 3 | **6** | 2 |
|
||||
| RT-003 | Concurrencia | 2 | 3 | **6** | 3 |
|
||||
| RT-004 | Rendimiento queries | 2 | 2 | 4 | 4 |
|
||||
| RT-005 | Curva aprendizaje | 3 | 1 | 3 | 5 |
|
||||
| RT-006 | Seguridad GraphQL | 1 | 3 | 3 | 6 |
|
||||
| RT-008 | Testing reglas | 2 | 2 | 4 | 7 |
|
||||
| RT-007 | Seeding datos | 1 | 2 | 2 | 8 |
|
||||
|
||||
---
|
||||
|
||||
## 5. Plan de Contingencia
|
||||
|
||||
### Si RT-001 se materializa (validaciones fallan):
|
||||
1. Rollback a versión anterior
|
||||
2. Fix inmediato en Domain Service
|
||||
3. Agregar tests de regresión
|
||||
4. Re-deploy con verificación manual
|
||||
|
||||
### Si RT-002 se materializa (integración falla):
|
||||
1. Fallback a REST API simple
|
||||
2. Schema manual sin codegen
|
||||
3. Simplificar queries GraphQL
|
||||
|
||||
### Si RT-003 se materializa (race conditions):
|
||||
1. Lock pesimista temporal
|
||||
2. Queue de inscripciones
|
||||
3. Revisión manual de conflictos
|
||||
|
||||
---
|
||||
|
||||
## 6. Indicadores de Monitoreo
|
||||
|
||||
| Riesgo | Indicador | Umbral de Alerta |
|
||||
|--------|-----------|------------------|
|
||||
| RT-001 | Inscripciones fallidas por validación | > 5% |
|
||||
| RT-002 | Errores GraphQL 500 | > 1% |
|
||||
| RT-003 | DbUpdateConcurrencyException | > 10/hora |
|
||||
| RT-004 | Query time P95 | > 500ms |
|
||||
| RT-006 | Requests bloqueados por rate limit | > 100/hora |
|
||||
|
||||
---
|
||||
|
||||
## 7. Revisión de Riesgos
|
||||
|
||||
| Fecha | Revisor | Acción |
|
||||
|-------|---------|--------|
|
||||
| Sprint 1 Review | Tech Lead | Evaluar RT-001, RT-002 |
|
||||
| Sprint 2 Review | Tech Lead | Evaluar RT-003, RT-004 |
|
||||
| Pre-deploy | QA Lead | Validar mitigaciones |
|
||||
|
||||
---
|
||||
|
||||
## 8. Aprobación
|
||||
|
||||
| Rol | Nombre | Fecha | Firma |
|
||||
|-----|--------|-------|-------|
|
||||
| Líder Técnico | Sistema | 2026-01-07 | ✓ |
|
||||
| Arquitecto | Pendiente | - | - |
|
||||
| Project Manager | Pendiente | - | - |
|
||||
|
|
@ -0,0 +1,129 @@
|
|||
# DI-001: Arquitectura Backend
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Patrón: Clean Architecture + CQRS
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────────────────┐
|
||||
│ HOST │
|
||||
│ (Program.cs, DI, Configuration) │
|
||||
└─────────────────────────┬──────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────▼──────────────────────────────────┐
|
||||
│ ADAPTERS │
|
||||
│ ┌──────────────────────┬─────────────────────────────┐ │
|
||||
│ │ DRIVING (Primary) │ DRIVEN (Secondary) │ │
|
||||
│ │ ────────────────── │ ───────────────────── │ │
|
||||
│ │ GraphQL API │ Persistence (EF Core) │ │
|
||||
│ │ (HotChocolate) │ DataLoaders │ │
|
||||
│ └──────────────────────┴─────────────────────────────┘ │
|
||||
└─────────────────────────┬──────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────▼──────────────────────────────────┐
|
||||
│ APPLICATION │
|
||||
│ Commands / Queries / Handlers / Validators │
|
||||
└─────────────────────────┬──────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────▼──────────────────────────────────┐
|
||||
│ DOMAIN │
|
||||
│ Entities / Value Objects / Services / Ports │
|
||||
└────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Regla de Dependencia
|
||||
|
||||
```
|
||||
Host → Adapters → Application → Domain
|
||||
↑
|
||||
Adapters implementa Ports
|
||||
```
|
||||
|
||||
**INVIOLABLE:** Domain NO depende de nada externo.
|
||||
|
||||
---
|
||||
|
||||
## 3. Responsabilidades por Capa
|
||||
|
||||
| Capa | Responsabilidad | Tecnología |
|
||||
|------|-----------------|------------|
|
||||
| **Domain** | Entidades, Value Objects, reglas de negocio puras, Ports (interfaces) | C# puro |
|
||||
| **Application** | Casos de uso (Commands/Queries), DTOs, Validators, orquestación | MediatR, FluentValidation, Mapster |
|
||||
| **Adapters/Driving** | GraphQL API (Types, Resolvers, Mutations) | HotChocolate |
|
||||
| **Adapters/Driven** | Repositorios, DbContext, DataLoaders | EF Core, SQL Server |
|
||||
| **Host** | Composition Root, DI, Middleware | ASP.NET Core |
|
||||
|
||||
---
|
||||
|
||||
## 4. Estructura de Proyectos
|
||||
|
||||
```
|
||||
src/backend/
|
||||
├── Domain/
|
||||
│ ├── Entities/ # Student, Subject, Professor, Enrollment
|
||||
│ ├── ValueObjects/ # Email, Credits
|
||||
│ ├── Services/ # EnrollmentDomainService
|
||||
│ ├── Ports/
|
||||
│ │ └── Repositories/ # IStudentRepository, ISubjectRepository
|
||||
│ └── Exceptions/ # MaxEnrollmentsException, SameProfessorException
|
||||
│
|
||||
├── Application/
|
||||
│ ├── Students/
|
||||
│ │ ├── Commands/ # CreateStudentCommand, UpdateStudentCommand
|
||||
│ │ ├── Queries/ # GetStudentsQuery, GetStudentByIdQuery
|
||||
│ │ └── DTOs/ # StudentDto, CreateStudentInput
|
||||
│ ├── Enrollments/
|
||||
│ │ ├── Commands/ # EnrollCommand, UnenrollCommand
|
||||
│ │ ├── Queries/ # GetClassmatesQuery
|
||||
│ │ └── DTOs/ # EnrollmentDto, EnrollInput
|
||||
│ └── Common/
|
||||
│ ├── Behaviors/ # ValidationBehavior
|
||||
│ └── Mappings/ # MapsterConfig
|
||||
│
|
||||
├── Adapters/
|
||||
│ ├── Driving/
|
||||
│ │ └── Api/
|
||||
│ │ ├── Types/ # StudentType, SubjectType
|
||||
│ │ ├── Queries/ # QueryResolvers
|
||||
│ │ └── Mutations/ # MutationResolvers
|
||||
│ └── Driven/
|
||||
│ └── Persistence/
|
||||
│ ├── Context/ # AppDbContext
|
||||
│ ├── Configs/ # StudentConfiguration
|
||||
│ ├── Repos/ # StudentRepository
|
||||
│ └── Seeding/ # DataSeeder
|
||||
│
|
||||
└── Host/
|
||||
└── Program.cs # Entry point + DI
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Flujo de una Request
|
||||
|
||||
```
|
||||
1. GraphQL Request → HotChocolate Resolver
|
||||
2. Resolver → Application Handler (via MediatR)
|
||||
3. Handler → Validator (FluentValidation)
|
||||
4. Handler → Domain Service (reglas de negocio)
|
||||
5. Handler → Repository (persistencia)
|
||||
6. Repository → DbContext → SQL Server
|
||||
7. Response ← DTO ← Mapper ← Entity
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Decisiones de Arquitectura
|
||||
|
||||
| Decisión | Razón |
|
||||
|----------|-------|
|
||||
| GraphQL vs REST | Flexibilidad en queries, evita over/under-fetching |
|
||||
| HotChocolate | Mejor soporte .NET, Code-First, DataLoaders |
|
||||
| MediatR | Desacopla handlers, facilita CQRS |
|
||||
| Mapster | Más rápido que AutoMapper |
|
||||
| FluentValidation | Validaciones declarativas y testeables |
|
||||
|
|
@ -0,0 +1,208 @@
|
|||
# DI-005: Arquitectura Frontend
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Stack Tecnológico
|
||||
|
||||
| Tecnología | Propósito |
|
||||
|------------|-----------|
|
||||
| Angular 21 | Framework SPA |
|
||||
| Angular Material | UI Components |
|
||||
| Apollo Angular | Cliente GraphQL |
|
||||
| Signals | Estado reactivo |
|
||||
| TypeScript | Tipado estático |
|
||||
|
||||
---
|
||||
|
||||
## 2. Estructura de Carpetas
|
||||
|
||||
```
|
||||
src/frontend/src/app/
|
||||
├── core/ # Singleton services
|
||||
│ ├── services/
|
||||
│ │ ├── student.service.ts
|
||||
│ │ └── enrollment.service.ts
|
||||
│ ├── graphql/
|
||||
│ │ ├── generated/ # Tipos generados
|
||||
│ │ ├── queries/
|
||||
│ │ │ ├── students.graphql
|
||||
│ │ │ └── subjects.graphql
|
||||
│ │ └── mutations/
|
||||
│ │ ├── student.graphql
|
||||
│ │ └── enrollment.graphql
|
||||
│ └── interceptors/
|
||||
│ └── error.interceptor.ts
|
||||
│
|
||||
├── shared/ # Reutilizables
|
||||
│ ├── components/
|
||||
│ │ ├── confirm-dialog/
|
||||
│ │ └── loading-spinner/
|
||||
│ └── pipes/
|
||||
│ └── credits.pipe.ts
|
||||
│
|
||||
└── features/ # Módulos por funcionalidad
|
||||
├── students/
|
||||
│ ├── pages/
|
||||
│ │ ├── student-list/
|
||||
│ │ └── student-form/
|
||||
│ └── components/
|
||||
│ └── student-card/
|
||||
│
|
||||
├── enrollment/
|
||||
│ ├── pages/
|
||||
│ │ └── enrollment-page/
|
||||
│ └── components/
|
||||
│ ├── subject-selector/
|
||||
│ └── enrolled-subjects/
|
||||
│
|
||||
└── classmates/
|
||||
└── pages/
|
||||
└── classmates-page/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Configuración Apollo
|
||||
|
||||
```typescript
|
||||
// app.config.ts
|
||||
export const appConfig: ApplicationConfig = {
|
||||
providers: [
|
||||
provideHttpClient(),
|
||||
provideApollo(() => ({
|
||||
link: httpLink.create({ uri: environment.graphqlUrl }),
|
||||
cache: new InMemoryCache(),
|
||||
defaultOptions: {
|
||||
watchQuery: { fetchPolicy: 'cache-and-network' },
|
||||
mutate: { errorPolicy: 'all' }
|
||||
}
|
||||
}))
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Gestión de Estado
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Apollo Cache │
|
||||
│ (Estado del servidor: students, subjects) │
|
||||
└─────────────────────────────────────────────┘
|
||||
▲
|
||||
│ watchQuery / mutate
|
||||
▼
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Services │
|
||||
│ (Encapsulan operaciones GraphQL) │
|
||||
└─────────────────────────────────────────────┘
|
||||
▲
|
||||
│ inject()
|
||||
▼
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ Components │
|
||||
│ (Signals para estado local/UI) │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Ejemplo de Service
|
||||
|
||||
```typescript
|
||||
@Injectable({ providedIn: 'root' })
|
||||
export class StudentService {
|
||||
private apollo = inject(Apollo);
|
||||
|
||||
getStudents() {
|
||||
return this.apollo.watchQuery<{ students: Student[] }>({
|
||||
query: GET_STUDENTS,
|
||||
fetchPolicy: 'cache-and-network'
|
||||
}).valueChanges;
|
||||
}
|
||||
|
||||
createStudent(input: CreateStudentInput) {
|
||||
return this.apollo.mutate<{ createStudent: StudentPayload }>({
|
||||
mutation: CREATE_STUDENT,
|
||||
variables: { input },
|
||||
refetchQueries: [{ query: GET_STUDENTS }]
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Ejemplo de Componente (Signals)
|
||||
|
||||
```typescript
|
||||
@Component({
|
||||
selector: 'app-student-list',
|
||||
standalone: true,
|
||||
changeDetection: ChangeDetectionStrategy.OnPush,
|
||||
template: `
|
||||
@if (loading()) {
|
||||
<mat-spinner />
|
||||
} @else {
|
||||
<mat-table [dataSource]="students()">
|
||||
<!-- columns -->
|
||||
</mat-table>
|
||||
}
|
||||
`
|
||||
})
|
||||
export class StudentListComponent {
|
||||
private studentService = inject(StudentService);
|
||||
|
||||
students = signal<Student[]>([]);
|
||||
loading = signal(true);
|
||||
|
||||
constructor() {
|
||||
this.studentService.getStudents().subscribe(({ data, loading }) => {
|
||||
this.students.set(data?.students ?? []);
|
||||
this.loading.set(loading);
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Rutas (Lazy Loading)
|
||||
|
||||
```typescript
|
||||
export const routes: Routes = [
|
||||
{ path: '', redirectTo: 'students', pathMatch: 'full' },
|
||||
{
|
||||
path: 'students',
|
||||
loadComponent: () => import('./features/students/pages/student-list/student-list.component')
|
||||
},
|
||||
{
|
||||
path: 'students/new',
|
||||
loadComponent: () => import('./features/students/pages/student-form/student-form.component')
|
||||
},
|
||||
{
|
||||
path: 'enrollment/:studentId',
|
||||
loadComponent: () => import('./features/enrollment/pages/enrollment-page/enrollment-page.component')
|
||||
},
|
||||
{
|
||||
path: 'classmates/:studentId',
|
||||
loadComponent: () => import('./features/classmates/pages/classmates-page/classmates-page.component')
|
||||
}
|
||||
];
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Decisiones de Diseño
|
||||
|
||||
| Decisión | Razón |
|
||||
|----------|-------|
|
||||
| Standalone Components | Angular moderno, tree-shakeable |
|
||||
| Signals vs RxJS | Más simple para estado local, menos boilerplate |
|
||||
| Apollo Cache | Single source of truth para datos del servidor |
|
||||
| OnPush | Mejor rendimiento, menos re-renders |
|
||||
| Lazy Loading | Bundle inicial pequeño |
|
||||
|
|
@ -0,0 +1,241 @@
|
|||
# DI-008: Estrategia de Manejo de Errores
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Clasificación de Errores
|
||||
|
||||
| Tipo | Origen | Manejo | HTTP Code (equiv) |
|
||||
|------|--------|--------|-------------------|
|
||||
| **Validación** | FluentValidation | Payload.errors | 400 |
|
||||
| **Dominio** | Domain Exceptions | Payload.errors | 422 |
|
||||
| **Not Found** | Repository | Payload.errors | 404 |
|
||||
| **Conflicto** | Concurrencia | Payload.errors | 409 |
|
||||
| **Sistema** | Excepciones no manejadas | Error GraphQL | 500 |
|
||||
|
||||
---
|
||||
|
||||
## 2. Excepciones de Dominio
|
||||
|
||||
```csharp
|
||||
// Base
|
||||
public abstract class DomainException : Exception
|
||||
{
|
||||
public string Code { get; }
|
||||
protected DomainException(string code, string message) : base(message)
|
||||
=> Code = code;
|
||||
}
|
||||
|
||||
// Específicas
|
||||
public class MaxEnrollmentsExceededException : DomainException
|
||||
{
|
||||
public MaxEnrollmentsExceededException()
|
||||
: base("MAX_ENROLLMENTS", "Máximo 3 materias permitidas") { }
|
||||
}
|
||||
|
||||
public class SameProfessorConstraintException : DomainException
|
||||
{
|
||||
public SameProfessorConstraintException(string professorName)
|
||||
: base("SAME_PROFESSOR", $"Ya tienes una materia con {professorName}") { }
|
||||
}
|
||||
|
||||
public class DuplicateEmailException : DomainException
|
||||
{
|
||||
public DuplicateEmailException()
|
||||
: base("DUPLICATE_EMAIL", "Este email ya está registrado") { }
|
||||
}
|
||||
|
||||
public class StudentNotFoundException : DomainException
|
||||
{
|
||||
public StudentNotFoundException(int id)
|
||||
: base("NOT_FOUND", $"Estudiante {id} no encontrado") { }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Patrón Result
|
||||
|
||||
```csharp
|
||||
public class Result
|
||||
{
|
||||
public bool IsSuccess { get; }
|
||||
public IEnumerable<string> Errors { get; }
|
||||
|
||||
protected Result(bool success, IEnumerable<string>? errors = null)
|
||||
{
|
||||
IsSuccess = success;
|
||||
Errors = errors ?? Array.Empty<string>();
|
||||
}
|
||||
|
||||
public static Result Success() => new(true);
|
||||
public static Result Failure(params string[] errors) => new(false, errors);
|
||||
}
|
||||
|
||||
public class Result<T> : Result
|
||||
{
|
||||
public T? Value { get; }
|
||||
|
||||
private Result(T value) : base(true) => Value = value;
|
||||
private Result(IEnumerable<string> errors) : base(false, errors) { }
|
||||
|
||||
public static Result<T> Success(T value) => new(value);
|
||||
public static new Result<T> Failure(params string[] errors) => new(errors);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Handler con Manejo de Errores
|
||||
|
||||
```csharp
|
||||
public class EnrollStudentHandler
|
||||
{
|
||||
public async Task<EnrollmentPayload> Handle(EnrollInput input)
|
||||
{
|
||||
try
|
||||
{
|
||||
var student = await _studentRepo.GetByIdWithEnrollmentsAsync(input.StudentId);
|
||||
if (student is null)
|
||||
return new EnrollmentPayload(null, ["Estudiante no encontrado"]);
|
||||
|
||||
var subject = await _subjectRepo.GetByIdAsync(input.SubjectId);
|
||||
if (subject is null)
|
||||
return new EnrollmentPayload(null, ["Materia no encontrada"]);
|
||||
|
||||
// Validación de dominio
|
||||
student.Enroll(subject, _enrollmentPolicy);
|
||||
|
||||
await _unitOfWork.SaveChangesAsync();
|
||||
|
||||
var dto = student.Enrollments.Last().Adapt<EnrollmentDto>();
|
||||
return new EnrollmentPayload(dto, null);
|
||||
}
|
||||
catch (DomainException ex)
|
||||
{
|
||||
return new EnrollmentPayload(null, [ex.Message]);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Error Filter GraphQL (HotChocolate)
|
||||
|
||||
```csharp
|
||||
public class ErrorFilter : IErrorFilter
|
||||
{
|
||||
public IError OnError(IError error)
|
||||
{
|
||||
return error.Exception switch
|
||||
{
|
||||
DomainException ex => error
|
||||
.WithMessage(ex.Message)
|
||||
.WithCode(ex.Code),
|
||||
|
||||
ValidationException ex => error
|
||||
.WithMessage("Errores de validación")
|
||||
.WithCode("VALIDATION_ERROR")
|
||||
.SetExtension("errors", ex.Errors.Select(e => e.ErrorMessage)),
|
||||
|
||||
DbUpdateConcurrencyException => error
|
||||
.WithMessage("Los datos fueron modificados por otro usuario")
|
||||
.WithCode("CONCURRENCY_ERROR"),
|
||||
|
||||
_ => error
|
||||
.WithMessage("Error interno del servidor")
|
||||
.WithCode("INTERNAL_ERROR")
|
||||
};
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Manejo en Frontend
|
||||
|
||||
### Service
|
||||
|
||||
```typescript
|
||||
@Injectable({ providedIn: 'root' })
|
||||
export class ErrorHandlerService {
|
||||
private snackBar = inject(MatSnackBar);
|
||||
|
||||
handleGraphQLErrors(errors: string[] | undefined): void {
|
||||
if (errors?.length) {
|
||||
this.snackBar.open(errors[0], 'Cerrar', {
|
||||
duration: 5000,
|
||||
panelClass: 'error-snackbar'
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
handleApolloError(error: ApolloError): void {
|
||||
const message = error.graphQLErrors[0]?.message ?? 'Error de conexión';
|
||||
this.snackBar.open(message, 'Cerrar', { duration: 5000 });
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Componente
|
||||
|
||||
```typescript
|
||||
enrollStudent(subjectId: number) {
|
||||
this.enrollmentService.enroll({
|
||||
studentId: this.studentId(),
|
||||
subjectId
|
||||
}).subscribe({
|
||||
next: ({ data }) => {
|
||||
if (data?.enrollStudent.errors?.length) {
|
||||
this.errorHandler.handleGraphQLErrors(data.enrollStudent.errors);
|
||||
} else {
|
||||
this.snackBar.open('Inscripción exitosa', 'OK');
|
||||
}
|
||||
},
|
||||
error: (err) => this.errorHandler.handleApolloError(err)
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Códigos de Error Estándar
|
||||
|
||||
| Código | Mensaje | Acción UI |
|
||||
|--------|---------|-----------|
|
||||
| `VALIDATION_ERROR` | Errores de validación | Mostrar en campos |
|
||||
| `MAX_ENROLLMENTS` | Máximo 3 materias | Toast + deshabilitar |
|
||||
| `SAME_PROFESSOR` | Ya tienes materia con X | Toast + deshabilitar |
|
||||
| `DUPLICATE_EMAIL` | Email ya registrado | Error en campo |
|
||||
| `NOT_FOUND` | Recurso no encontrado | Redirect + toast |
|
||||
| `CONCURRENCY_ERROR` | Datos modificados | Refetch + toast |
|
||||
| `INTERNAL_ERROR` | Error del servidor | Toast genérico |
|
||||
|
||||
---
|
||||
|
||||
## 8. Logging de Errores
|
||||
|
||||
```csharp
|
||||
public class LoggingBehavior<TRequest, TResponse> : IPipelineBehavior<TRequest, TResponse>
|
||||
{
|
||||
private readonly ILogger<LoggingBehavior<TRequest, TResponse>> _logger;
|
||||
|
||||
public async Task<TResponse> Handle(TRequest request, ...)
|
||||
{
|
||||
try
|
||||
{
|
||||
return await next();
|
||||
}
|
||||
catch (Exception ex) when (ex is not DomainException)
|
||||
{
|
||||
_logger.LogError(ex, "Error procesando {Request}", typeof(TRequest).Name);
|
||||
throw;
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Regla:** NO loguear datos sensibles (email, contraseñas).
|
||||
|
|
@ -0,0 +1,198 @@
|
|||
# DI-003: Diseño de Base de Datos
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Modelo Entidad-Relación
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ PROFESSORS │
|
||||
├──────────────┬────────────────┬─────────────────────────────────┤
|
||||
│ Id │ INT │ PK, IDENTITY │
|
||||
│ Name │ NVARCHAR(100) │ NOT NULL │
|
||||
└──────────────┴────────────────┴─────────────────────────────────┘
|
||||
│
|
||||
│ 1:N (cada profesor → 2 materias)
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ SUBJECTS │
|
||||
├──────────────┬────────────────┬─────────────────────────────────┤
|
||||
│ Id │ INT │ PK, IDENTITY │
|
||||
│ Name │ NVARCHAR(100) │ NOT NULL │
|
||||
│ Credits │ INT │ DEFAULT 3, CHECK (Credits = 3) │
|
||||
│ ProfessorId │ INT │ FK → Professors.Id │
|
||||
└──────────────┴────────────────┴─────────────────────────────────┘
|
||||
│
|
||||
│ 1:N
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ ENROLLMENTS │
|
||||
├──────────────┬────────────────┬─────────────────────────────────┤
|
||||
│ Id │ INT │ PK, IDENTITY │
|
||||
│ StudentId │ INT │ FK → Students.Id │
|
||||
│ SubjectId │ INT │ FK → Subjects.Id │
|
||||
│ EnrolledAt │ DATETIME2 │ DEFAULT GETUTCDATE() │
|
||||
└──────────────┴────────────────┴─────────────────────────────────┘
|
||||
▲
|
||||
│ 0..3:N
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ STUDENTS │
|
||||
├──────────────┬────────────────┬─────────────────────────────────┤
|
||||
│ Id │ INT │ PK, IDENTITY │
|
||||
│ Name │ NVARCHAR(100) │ NOT NULL │
|
||||
│ Email │ NVARCHAR(255) │ NOT NULL, UNIQUE │
|
||||
│ RowVersion │ ROWVERSION │ Concurrency control │
|
||||
└──────────────┴────────────────┴─────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Script DDL
|
||||
|
||||
```sql
|
||||
-- Crear base de datos
|
||||
CREATE DATABASE StudentEnrollment;
|
||||
GO
|
||||
|
||||
USE StudentEnrollment;
|
||||
GO
|
||||
|
||||
-- Tabla: Professors
|
||||
CREATE TABLE Professors (
|
||||
Id INT IDENTITY(1,1) PRIMARY KEY,
|
||||
Name NVARCHAR(100) NOT NULL
|
||||
);
|
||||
|
||||
-- Tabla: Subjects
|
||||
CREATE TABLE Subjects (
|
||||
Id INT IDENTITY(1,1) PRIMARY KEY,
|
||||
Name NVARCHAR(100) NOT NULL,
|
||||
Credits INT NOT NULL DEFAULT 3 CHECK (Credits = 3),
|
||||
ProfessorId INT NOT NULL,
|
||||
CONSTRAINT FK_Subjects_Professors
|
||||
FOREIGN KEY (ProfessorId) REFERENCES Professors(Id)
|
||||
);
|
||||
|
||||
-- Tabla: Students
|
||||
CREATE TABLE Students (
|
||||
Id INT IDENTITY(1,1) PRIMARY KEY,
|
||||
Name NVARCHAR(100) NOT NULL,
|
||||
Email NVARCHAR(255) NOT NULL,
|
||||
RowVersion ROWVERSION,
|
||||
CONSTRAINT UQ_Students_Email UNIQUE (Email)
|
||||
);
|
||||
|
||||
-- Tabla: Enrollments
|
||||
CREATE TABLE Enrollments (
|
||||
Id INT IDENTITY(1,1) PRIMARY KEY,
|
||||
StudentId INT NOT NULL,
|
||||
SubjectId INT NOT NULL,
|
||||
EnrolledAt DATETIME2 NOT NULL DEFAULT GETUTCDATE(),
|
||||
CONSTRAINT FK_Enrollments_Students
|
||||
FOREIGN KEY (StudentId) REFERENCES Students(Id) ON DELETE CASCADE,
|
||||
CONSTRAINT FK_Enrollments_Subjects
|
||||
FOREIGN KEY (SubjectId) REFERENCES Subjects(Id),
|
||||
CONSTRAINT UQ_Enrollments_Student_Subject
|
||||
UNIQUE (StudentId, SubjectId)
|
||||
);
|
||||
|
||||
-- Índices
|
||||
CREATE INDEX IX_Subjects_ProfessorId ON Subjects(ProfessorId);
|
||||
CREATE INDEX IX_Enrollments_StudentId ON Enrollments(StudentId);
|
||||
CREATE INDEX IX_Enrollments_SubjectId ON Enrollments(SubjectId);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Datos Iniciales (Seed)
|
||||
|
||||
```sql
|
||||
-- 5 Profesores
|
||||
INSERT INTO Professors (Name) VALUES
|
||||
('Dr. García'), -- Id: 1
|
||||
('Dra. Martínez'), -- Id: 2
|
||||
('Dr. López'), -- Id: 3
|
||||
('Dra. Rodríguez'), -- Id: 4
|
||||
('Dr. Hernández'); -- Id: 5
|
||||
|
||||
-- 10 Materias (2 por profesor)
|
||||
INSERT INTO Subjects (Name, Credits, ProfessorId) VALUES
|
||||
('Matemáticas I', 3, 1),
|
||||
('Matemáticas II', 3, 1),
|
||||
('Física I', 3, 2),
|
||||
('Física II', 3, 2),
|
||||
('Programación I', 3, 3),
|
||||
('Programación II', 3, 3),
|
||||
('Base de Datos I', 3, 4),
|
||||
('Base de Datos II', 3, 4),
|
||||
('Redes I', 3, 5),
|
||||
('Redes II', 3, 5);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Constraints de Negocio
|
||||
|
||||
| Constraint | Tipo | Descripción |
|
||||
|------------|------|-------------|
|
||||
| `UQ_Students_Email` | UNIQUE | Email único por estudiante |
|
||||
| `UQ_Enrollments_Student_Subject` | UNIQUE | No duplicar inscripción |
|
||||
| `CHECK (Credits = 3)` | CHECK | Créditos siempre = 3 |
|
||||
| `ON DELETE CASCADE` | FK | Eliminar inscripciones al eliminar estudiante |
|
||||
|
||||
---
|
||||
|
||||
## 5. Vistas Útiles
|
||||
|
||||
```sql
|
||||
-- Vista: Compañeros de clase
|
||||
CREATE VIEW vw_Classmates AS
|
||||
SELECT
|
||||
e1.StudentId,
|
||||
s.Name AS SubjectName,
|
||||
st.Name AS ClassmateName
|
||||
FROM Enrollments e1
|
||||
INNER JOIN Enrollments e2 ON e1.SubjectId = e2.SubjectId
|
||||
AND e1.StudentId != e2.StudentId
|
||||
INNER JOIN Subjects s ON e1.SubjectId = s.Id
|
||||
INNER JOIN Students st ON e2.StudentId = st.Id;
|
||||
|
||||
-- Vista: Materias disponibles por estudiante
|
||||
CREATE VIEW vw_AvailableSubjects AS
|
||||
SELECT
|
||||
st.Id AS StudentId,
|
||||
su.Id AS SubjectId,
|
||||
su.Name AS SubjectName,
|
||||
p.Name AS ProfessorName,
|
||||
CASE
|
||||
WHEN e.Id IS NOT NULL THEN 0 -- Ya inscrito
|
||||
WHEN ep.ProfessorId IS NOT NULL THEN 0 -- Mismo profesor
|
||||
ELSE 1
|
||||
END AS IsAvailable
|
||||
FROM Students st
|
||||
CROSS JOIN Subjects su
|
||||
INNER JOIN Professors p ON su.ProfessorId = p.Id
|
||||
LEFT JOIN Enrollments e ON st.Id = e.StudentId AND su.Id = e.SubjectId
|
||||
LEFT JOIN (
|
||||
SELECT DISTINCT e.StudentId, s.ProfessorId
|
||||
FROM Enrollments e
|
||||
INNER JOIN Subjects s ON e.SubjectId = s.Id
|
||||
) ep ON st.Id = ep.StudentId AND su.ProfessorId = ep.ProfessorId;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Diccionario de Datos
|
||||
|
||||
| Tabla | Campo | Tipo | Descripción |
|
||||
|-------|-------|------|-------------|
|
||||
| Students | Id | INT | Identificador único |
|
||||
| Students | Name | NVARCHAR(100) | Nombre completo |
|
||||
| Students | Email | NVARCHAR(255) | Correo (único) |
|
||||
| Students | RowVersion | ROWVERSION | Control de concurrencia |
|
||||
| Subjects | Credits | INT | Siempre 3 |
|
||||
| Enrollments | EnrolledAt | DATETIME2 | Fecha de inscripción UTC |
|
||||
|
|
@ -0,0 +1,166 @@
|
|||
# DI-006: Diseño de Componentes UI
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Mapa de Pantallas
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────┐
|
||||
│ APP LAYOUT │
|
||||
├──────────────────────────────────────────────────────────────┤
|
||||
│ [Logo] Sistema de Estudiantes [Estudiantes] [Mat] │
|
||||
├──────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ <router-outlet> │
|
||||
│ │
|
||||
└──────────────────────────────────────────────────────────────┘
|
||||
|
||||
Rutas:
|
||||
├── /students → Lista de estudiantes
|
||||
├── /students/new → Formulario crear
|
||||
├── /students/:id/edit → Formulario editar
|
||||
├── /enrollment/:id → Inscripción de materias
|
||||
└── /classmates/:id → Compañeros de clase
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Wireframes
|
||||
|
||||
### 2.1 Lista de Estudiantes (`/students`)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ESTUDIANTES [+ Nuevo Estudiante] │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 🔍 Buscar estudiante... │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ NOMBRE │ EMAIL │ CRÉDITOS │ ACCIONES│ │
|
||||
│ ├───────────────────────────────────────────────────────┤ │
|
||||
│ │ Juan Pérez │ juan@email.com │ 6/9 │ ✏️ 🗑️ 📚 │ │
|
||||
│ │ María García │ maria@email.com │ 9/9 │ ✏️ 🗑️ 📚 │ │
|
||||
│ │ Carlos López │ carlos@mail.com │ 3/9 │ ✏️ 🗑️ 📚 │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [← Anterior] [Siguiente →] │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
|
||||
Leyenda: ✏️ Editar 🗑️ Eliminar 📚 Inscripción
|
||||
```
|
||||
|
||||
### 2.2 Formulario Estudiante (`/students/new`)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ← Volver NUEVO ESTUDIANTE │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ Nombre * │ │
|
||||
│ │ ┌─────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ Juan Pérez │ │ │
|
||||
│ │ └─────────────────────────────────────────────────┘ │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ Email * │ │
|
||||
│ │ ┌─────────────────────────────────────────────────┐ │ │
|
||||
│ │ │ juan@email.com │ │ │
|
||||
│ │ └─────────────────────────────────────────────────┘ │ │
|
||||
│ │ ⚠️ Este email ya está registrado (error ejemplo) │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [Cancelar] [Guardar] │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2.3 Inscripción de Materias (`/enrollment/:id`)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ← Volver INSCRIPCIÓN: Juan Pérez │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ Créditos: ████████░░ 6/9 Materias: 2/3 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ MIS MATERIAS INSCRITAS │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ ✓ Física I │ Dra. Martínez │ [Cancelar] │ │
|
||||
│ │ ✓ Programación I │ Dr. López │ [Cancelar] │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ MATERIAS DISPONIBLES │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ ○ Matemáticas I │ Dr. García │ [Inscribir] │ │
|
||||
│ │ ○ Matemáticas II │ Dr. García │ [Inscribir] │ │
|
||||
│ │ ○ Física II │ Dra. Martínez │ ⚠️ Mismo prof │ │
|
||||
│ │ ○ Programación II │ Dr. López │ ⚠️ Mismo prof │ │
|
||||
│ │ ○ Base de Datos I │ Dra. Rodríguez │ [Inscribir] │ │
|
||||
│ │ ... │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ [Ver Compañeros de Clase] │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2.4 Compañeros de Clase (`/classmates/:id`)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ← Volver MIS COMPAÑEROS: Juan Pérez │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 📚 FÍSICA I (Dra. Martínez) │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ • María García │ │
|
||||
│ │ • Carlos López │ │
|
||||
│ │ • Ana Rodríguez │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ 💻 PROGRAMACIÓN I (Dr. López) │
|
||||
│ ┌───────────────────────────────────────────────────────┐ │
|
||||
│ │ • Pedro Sánchez │ │
|
||||
│ │ • Laura Torres │ │
|
||||
│ └───────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Componentes Reutilizables
|
||||
|
||||
| Componente | Descripción | Props |
|
||||
|------------|-------------|-------|
|
||||
| `ConfirmDialog` | Modal de confirmación | title, message, onConfirm |
|
||||
| `LoadingSpinner` | Indicador de carga | size, color |
|
||||
| `ErrorAlert` | Mensaje de error | message, dismissible |
|
||||
| `CreditsBadge` | Badge de créditos | current, max |
|
||||
| `SubjectCard` | Card de materia | subject, actions |
|
||||
|
||||
---
|
||||
|
||||
## 4. Estados de UI
|
||||
|
||||
| Estado | Visual |
|
||||
|--------|--------|
|
||||
| Loading | Skeleton / Spinner |
|
||||
| Empty | Ilustración + mensaje |
|
||||
| Error | Alert rojo + retry |
|
||||
| Success | Toast verde |
|
||||
|
||||
---
|
||||
|
||||
## 5. Responsive Breakpoints
|
||||
|
||||
| Breakpoint | Comportamiento |
|
||||
|------------|----------------|
|
||||
| Mobile (<600px) | Cards apiladas, menú hamburguesa |
|
||||
| Tablet (600-960px) | Grid 2 columnas |
|
||||
| Desktop (>960px) | Tabla completa, sidebar |
|
||||
|
|
@ -0,0 +1,226 @@
|
|||
# DI-004: Esquema GraphQL
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Schema Completo
|
||||
|
||||
```graphql
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# TYPES
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
type Student {
|
||||
id: Int!
|
||||
name: String!
|
||||
email: String!
|
||||
totalCredits: Int!
|
||||
enrollments: [Enrollment!]!
|
||||
}
|
||||
|
||||
type Subject {
|
||||
id: Int!
|
||||
name: String!
|
||||
credits: Int!
|
||||
professor: Professor!
|
||||
enrolledStudents: [Student!]!
|
||||
}
|
||||
|
||||
type Professor {
|
||||
id: Int!
|
||||
name: String!
|
||||
subjects: [Subject!]!
|
||||
}
|
||||
|
||||
type Enrollment {
|
||||
id: Int!
|
||||
student: Student!
|
||||
subject: Subject!
|
||||
enrolledAt: DateTime!
|
||||
}
|
||||
|
||||
type AvailableSubject {
|
||||
subject: Subject!
|
||||
isAvailable: Boolean!
|
||||
unavailableReason: String
|
||||
}
|
||||
|
||||
type Classmate {
|
||||
subjectName: String!
|
||||
students: [String!]!
|
||||
}
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# QUERIES
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
type Query {
|
||||
# Estudiantes
|
||||
students: [Student!]!
|
||||
student(id: Int!): Student
|
||||
|
||||
# Materias
|
||||
subjects: [Subject!]!
|
||||
subject(id: Int!): Subject
|
||||
availableSubjects(studentId: Int!): [AvailableSubject!]!
|
||||
|
||||
# Profesores
|
||||
professors: [Professor!]!
|
||||
professor(id: Int!): Professor
|
||||
|
||||
# Compañeros de clase
|
||||
classmates(studentId: Int!): [Classmate!]!
|
||||
}
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# MUTATIONS
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
type Mutation {
|
||||
# Estudiantes
|
||||
createStudent(input: CreateStudentInput!): StudentPayload!
|
||||
updateStudent(id: Int!, input: UpdateStudentInput!): StudentPayload!
|
||||
deleteStudent(id: Int!): DeletePayload!
|
||||
|
||||
# Inscripciones
|
||||
enrollStudent(input: EnrollInput!): EnrollmentPayload!
|
||||
unenrollStudent(enrollmentId: Int!): DeletePayload!
|
||||
}
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# INPUTS
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
input CreateStudentInput {
|
||||
name: String!
|
||||
email: String!
|
||||
}
|
||||
|
||||
input UpdateStudentInput {
|
||||
name: String
|
||||
email: String
|
||||
}
|
||||
|
||||
input EnrollInput {
|
||||
studentId: Int!
|
||||
subjectId: Int!
|
||||
}
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# PAYLOADS (Union para errores)
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
type StudentPayload {
|
||||
student: Student
|
||||
errors: [String!]
|
||||
}
|
||||
|
||||
type EnrollmentPayload {
|
||||
enrollment: Enrollment
|
||||
errors: [String!]
|
||||
}
|
||||
|
||||
type DeletePayload {
|
||||
success: Boolean!
|
||||
errors: [String!]
|
||||
}
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
# SCALARS
|
||||
# ═══════════════════════════════════════════════════════════════
|
||||
|
||||
scalar DateTime
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Ejemplos de Queries
|
||||
|
||||
### Listar estudiantes con inscripciones
|
||||
```graphql
|
||||
query GetStudents {
|
||||
students {
|
||||
id
|
||||
name
|
||||
email
|
||||
totalCredits
|
||||
enrollments {
|
||||
subject { name professor { name } }
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Materias disponibles para inscripción
|
||||
```graphql
|
||||
query GetAvailableSubjects($studentId: Int!) {
|
||||
availableSubjects(studentId: $studentId) {
|
||||
subject { id name credits professor { name } }
|
||||
isAvailable
|
||||
unavailableReason
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Compañeros de clase
|
||||
```graphql
|
||||
query GetClassmates($studentId: Int!) {
|
||||
classmates(studentId: $studentId) {
|
||||
subjectName
|
||||
students
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Ejemplos de Mutations
|
||||
|
||||
### Crear estudiante
|
||||
```graphql
|
||||
mutation CreateStudent {
|
||||
createStudent(input: { name: "Juan Pérez", email: "juan@email.com" }) {
|
||||
student { id name email }
|
||||
errors
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Inscribir en materia
|
||||
```graphql
|
||||
mutation Enroll {
|
||||
enrollStudent(input: { studentId: 1, subjectId: 3 }) {
|
||||
enrollment {
|
||||
id
|
||||
subject { name }
|
||||
enrolledAt
|
||||
}
|
||||
errors
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. DataLoaders (Evitar N+1)
|
||||
|
||||
| DataLoader | Carga Batch |
|
||||
|------------|-------------|
|
||||
| `StudentByIdDataLoader` | Estudiantes por IDs |
|
||||
| `SubjectByIdDataLoader` | Materias por IDs |
|
||||
| `ProfessorByIdDataLoader` | Profesores por IDs |
|
||||
| `EnrollmentsByStudentDataLoader` | Inscripciones por estudiante |
|
||||
| `SubjectsByProfessorDataLoader` | Materias por profesor |
|
||||
|
||||
---
|
||||
|
||||
## 5. Errores de Negocio
|
||||
|
||||
| Código | Mensaje | Contexto |
|
||||
|--------|---------|----------|
|
||||
| `MAX_ENROLLMENTS` | "Máximo 3 materias permitidas" | enrollStudent |
|
||||
| `SAME_PROFESSOR` | "Ya tienes materia con este profesor" | enrollStudent |
|
||||
| `DUPLICATE_EMAIL` | "Email ya registrado" | createStudent |
|
||||
| `NOT_FOUND` | "Estudiante no encontrado" | updateStudent |
|
||||
|
|
@ -0,0 +1,257 @@
|
|||
# DI-007: Contratos y DTOs
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. DTOs Backend (C#)
|
||||
|
||||
### Request DTOs (Inputs)
|
||||
|
||||
```csharp
|
||||
// Students
|
||||
public record CreateStudentInput(string Name, string Email);
|
||||
public record UpdateStudentInput(string? Name, string? Email);
|
||||
|
||||
// Enrollments
|
||||
public record EnrollInput(int StudentId, int SubjectId);
|
||||
```
|
||||
|
||||
### Response DTOs
|
||||
|
||||
```csharp
|
||||
// Student
|
||||
public record StudentDto(
|
||||
int Id,
|
||||
string Name,
|
||||
string Email,
|
||||
int TotalCredits,
|
||||
IEnumerable<EnrollmentDto> Enrollments);
|
||||
|
||||
// Subject
|
||||
public record SubjectDto(
|
||||
int Id,
|
||||
string Name,
|
||||
int Credits,
|
||||
ProfessorDto Professor);
|
||||
|
||||
// Professor
|
||||
public record ProfessorDto(
|
||||
int Id,
|
||||
string Name);
|
||||
|
||||
// Enrollment
|
||||
public record EnrollmentDto(
|
||||
int Id,
|
||||
SubjectDto Subject,
|
||||
DateTime EnrolledAt);
|
||||
|
||||
// Available Subject (con disponibilidad)
|
||||
public record AvailableSubjectDto(
|
||||
SubjectDto Subject,
|
||||
bool IsAvailable,
|
||||
string? UnavailableReason);
|
||||
|
||||
// Classmates
|
||||
public record ClassmateDto(
|
||||
string SubjectName,
|
||||
IEnumerable<string> StudentNames);
|
||||
```
|
||||
|
||||
### Payloads (Respuestas con errores)
|
||||
|
||||
```csharp
|
||||
public record StudentPayload(StudentDto? Student, IEnumerable<string>? Errors);
|
||||
public record EnrollmentPayload(EnrollmentDto? Enrollment, IEnumerable<string>? Errors);
|
||||
public record DeletePayload(bool Success, IEnumerable<string>? Errors);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. DTOs Frontend (TypeScript)
|
||||
|
||||
### Tipos Generados (graphql-codegen)
|
||||
|
||||
```typescript
|
||||
// Student
|
||||
export interface Student {
|
||||
id: number;
|
||||
name: string;
|
||||
email: string;
|
||||
totalCredits: number;
|
||||
enrollments: Enrollment[];
|
||||
}
|
||||
|
||||
// Subject
|
||||
export interface Subject {
|
||||
id: number;
|
||||
name: string;
|
||||
credits: number;
|
||||
professor: Professor;
|
||||
}
|
||||
|
||||
// Professor
|
||||
export interface Professor {
|
||||
id: number;
|
||||
name: string;
|
||||
subjects?: Subject[];
|
||||
}
|
||||
|
||||
// Enrollment
|
||||
export interface Enrollment {
|
||||
id: number;
|
||||
subject: Subject;
|
||||
enrolledAt: string;
|
||||
}
|
||||
|
||||
// Available Subject
|
||||
export interface AvailableSubject {
|
||||
subject: Subject;
|
||||
isAvailable: boolean;
|
||||
unavailableReason?: string;
|
||||
}
|
||||
|
||||
// Classmate
|
||||
export interface Classmate {
|
||||
subjectName: string;
|
||||
students: string[];
|
||||
}
|
||||
```
|
||||
|
||||
### Inputs
|
||||
|
||||
```typescript
|
||||
export interface CreateStudentInput {
|
||||
name: string;
|
||||
email: string;
|
||||
}
|
||||
|
||||
export interface UpdateStudentInput {
|
||||
name?: string;
|
||||
email?: string;
|
||||
}
|
||||
|
||||
export interface EnrollInput {
|
||||
studentId: number;
|
||||
subjectId: number;
|
||||
}
|
||||
```
|
||||
|
||||
### Payloads
|
||||
|
||||
```typescript
|
||||
export interface StudentPayload {
|
||||
student?: Student;
|
||||
errors?: string[];
|
||||
}
|
||||
|
||||
export interface EnrollmentPayload {
|
||||
enrollment?: Enrollment;
|
||||
errors?: string[];
|
||||
}
|
||||
|
||||
export interface DeletePayload {
|
||||
success: boolean;
|
||||
errors?: string[];
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Mapeos (Mapster)
|
||||
|
||||
```csharp
|
||||
public class MappingConfig : IRegister
|
||||
{
|
||||
public void Register(TypeAdapterConfig config)
|
||||
{
|
||||
config.NewConfig<Student, StudentDto>()
|
||||
.Map(dest => dest.TotalCredits, src => src.Enrollments.Count * 3);
|
||||
|
||||
config.NewConfig<Subject, SubjectDto>();
|
||||
config.NewConfig<Professor, ProfessorDto>();
|
||||
config.NewConfig<Enrollment, EnrollmentDto>();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Validadores (FluentValidation)
|
||||
|
||||
```csharp
|
||||
public class CreateStudentInputValidator : AbstractValidator<CreateStudentInput>
|
||||
{
|
||||
public CreateStudentInputValidator()
|
||||
{
|
||||
RuleFor(x => x.Name)
|
||||
.NotEmpty().WithMessage("Nombre requerido")
|
||||
.MaximumLength(100).WithMessage("Máximo 100 caracteres");
|
||||
|
||||
RuleFor(x => x.Email)
|
||||
.NotEmpty().WithMessage("Email requerido")
|
||||
.EmailAddress().WithMessage("Formato de email inválido")
|
||||
.MaximumLength(255).WithMessage("Máximo 255 caracteres");
|
||||
}
|
||||
}
|
||||
|
||||
public class EnrollInputValidator : AbstractValidator<EnrollInput>
|
||||
{
|
||||
public EnrollInputValidator()
|
||||
{
|
||||
RuleFor(x => x.StudentId)
|
||||
.GreaterThan(0).WithMessage("StudentId inválido");
|
||||
|
||||
RuleFor(x => x.SubjectId)
|
||||
.GreaterThan(0).WithMessage("SubjectId inválido");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Contratos de Repositorio (Ports)
|
||||
|
||||
```csharp
|
||||
public interface IStudentRepository
|
||||
{
|
||||
Task<Student?> GetByIdAsync(int id, CancellationToken ct = default);
|
||||
Task<Student?> GetByIdWithEnrollmentsAsync(int id, CancellationToken ct = default);
|
||||
Task<IEnumerable<Student>> GetAllAsync(CancellationToken ct = default);
|
||||
Task<bool> EmailExistsAsync(string email, int? excludeId = null, CancellationToken ct = default);
|
||||
Task AddAsync(Student student, CancellationToken ct = default);
|
||||
void Update(Student student);
|
||||
void Delete(Student student);
|
||||
}
|
||||
|
||||
public interface ISubjectRepository
|
||||
{
|
||||
Task<Subject?> GetByIdAsync(int id, CancellationToken ct = default);
|
||||
Task<IEnumerable<Subject>> GetAllAsync(CancellationToken ct = default);
|
||||
Task<IEnumerable<Subject>> GetByProfessorIdAsync(int professorId, CancellationToken ct = default);
|
||||
}
|
||||
|
||||
public interface IEnrollmentRepository
|
||||
{
|
||||
Task<IEnumerable<Enrollment>> GetByStudentIdAsync(int studentId, CancellationToken ct = default);
|
||||
Task<IEnumerable<Student>> GetClassmatesAsync(int studentId, int subjectId, CancellationToken ct = default);
|
||||
}
|
||||
|
||||
public interface IUnitOfWork
|
||||
{
|
||||
Task<int> SaveChangesAsync(CancellationToken ct = default);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Resumen de Contratos por Operación
|
||||
|
||||
| Operación | Input | Output | Errores Posibles |
|
||||
|-----------|-------|--------|------------------|
|
||||
| createStudent | CreateStudentInput | StudentPayload | DUPLICATE_EMAIL, VALIDATION |
|
||||
| updateStudent | UpdateStudentInput | StudentPayload | NOT_FOUND, DUPLICATE_EMAIL |
|
||||
| deleteStudent | id: Int | DeletePayload | NOT_FOUND |
|
||||
| enrollStudent | EnrollInput | EnrollmentPayload | MAX_ENROLLMENTS, SAME_PROFESSOR |
|
||||
| unenrollStudent | enrollmentId: Int | DeletePayload | NOT_FOUND |
|
||||
|
|
@ -0,0 +1,189 @@
|
|||
# DI-002: Modelo de Dominio
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Diagrama de Entidades
|
||||
|
||||
```
|
||||
┌─────────────────┐ ┌─────────────────┐
|
||||
│ PROFESSOR │ │ STUDENT │
|
||||
├─────────────────┤ ├─────────────────┤
|
||||
│ Id: int (PK) │ │ Id: int (PK) │
|
||||
│ Name: string │ │ Name: string │
|
||||
└────────┬────────┘ │ Email: Email │
|
||||
│ │ RowVersion │
|
||||
│ 1:2 └────────┬────────┘
|
||||
▼ │
|
||||
┌─────────────────┐ │ 0..3
|
||||
│ SUBJECT │ ▼
|
||||
├─────────────────┤ ┌─────────────────┐
|
||||
│ Id: int (PK) │◄──────│ ENROLLMENT │
|
||||
│ Name: string │ 1:N ├─────────────────┤
|
||||
│ Credits: 3 │ │ Id: int (PK) │
|
||||
│ ProfessorId: FK │ │ StudentId: FK │
|
||||
└─────────────────┘ │ SubjectId: FK │
|
||||
│ EnrolledAt │
|
||||
└─────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Entidades
|
||||
|
||||
### Student (Aggregate Root)
|
||||
|
||||
```csharp
|
||||
public class Student
|
||||
{
|
||||
public int Id { get; private set; }
|
||||
public string Name { get; private set; }
|
||||
public Email Email { get; private set; }
|
||||
public byte[] RowVersion { get; private set; }
|
||||
|
||||
private readonly List<Enrollment> _enrollments = new();
|
||||
public IReadOnlyCollection<Enrollment> Enrollments => _enrollments;
|
||||
|
||||
public int TotalCredits => _enrollments.Count * 3;
|
||||
|
||||
public void Enroll(Subject subject, IEnrollmentPolicy policy)
|
||||
{
|
||||
policy.Validate(this, subject);
|
||||
_enrollments.Add(new Enrollment(this, subject));
|
||||
}
|
||||
|
||||
public void Unenroll(int subjectId)
|
||||
{
|
||||
var enrollment = _enrollments.FirstOrDefault(e => e.SubjectId == subjectId);
|
||||
if (enrollment != null) _enrollments.Remove(enrollment);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Subject
|
||||
|
||||
```csharp
|
||||
public class Subject
|
||||
{
|
||||
public int Id { get; private set; }
|
||||
public string Name { get; private set; }
|
||||
public int Credits { get; } = 3; // Constante: RN-002
|
||||
public int ProfessorId { get; private set; }
|
||||
public Professor Professor { get; private set; }
|
||||
}
|
||||
```
|
||||
|
||||
### Professor
|
||||
|
||||
```csharp
|
||||
public class Professor
|
||||
{
|
||||
public int Id { get; private set; }
|
||||
public string Name { get; private set; }
|
||||
|
||||
private readonly List<Subject> _subjects = new();
|
||||
public IReadOnlyCollection<Subject> Subjects => _subjects;
|
||||
}
|
||||
```
|
||||
|
||||
### Enrollment
|
||||
|
||||
```csharp
|
||||
public class Enrollment
|
||||
{
|
||||
public int Id { get; private set; }
|
||||
public int StudentId { get; private set; }
|
||||
public int SubjectId { get; private set; }
|
||||
public DateTime EnrolledAt { get; private set; }
|
||||
|
||||
public Student Student { get; private set; }
|
||||
public Subject Subject { get; private set; }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Value Objects
|
||||
|
||||
### Email
|
||||
|
||||
```csharp
|
||||
public record Email
|
||||
{
|
||||
public string Value { get; }
|
||||
|
||||
private Email(string value) => Value = value;
|
||||
|
||||
public static Result<Email> Create(string email)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(email))
|
||||
return Result.Failure<Email>("Email requerido");
|
||||
|
||||
if (!Regex.IsMatch(email, @"^[^@\s]+@[^@\s]+\.[^@\s]+$"))
|
||||
return Result.Failure<Email>("Formato de email inválido");
|
||||
|
||||
return Result.Success(new Email(email.ToLowerInvariant()));
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Domain Service
|
||||
|
||||
### EnrollmentDomainService (Implementa RN-003 y RN-005)
|
||||
|
||||
```csharp
|
||||
public class EnrollmentDomainService : IEnrollmentPolicy
|
||||
{
|
||||
public void Validate(Student student, Subject newSubject)
|
||||
{
|
||||
// RN-003: Máximo 3 materias
|
||||
if (student.Enrollments.Count >= 3)
|
||||
throw new MaxEnrollmentsExceededException(student.Id);
|
||||
|
||||
// RN-005: No repetir profesor
|
||||
var professorIds = student.Enrollments
|
||||
.Select(e => e.Subject.ProfessorId)
|
||||
.ToHashSet();
|
||||
|
||||
if (professorIds.Contains(newSubject.ProfessorId))
|
||||
throw new SameProfessorConstraintException(
|
||||
student.Id,
|
||||
newSubject.ProfessorId);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Excepciones de Dominio
|
||||
|
||||
```csharp
|
||||
public class MaxEnrollmentsExceededException : DomainException
|
||||
{
|
||||
public MaxEnrollmentsExceededException(int studentId)
|
||||
: base($"Estudiante {studentId} ya tiene 3 materias inscritas") { }
|
||||
}
|
||||
|
||||
public class SameProfessorConstraintException : DomainException
|
||||
{
|
||||
public SameProfessorConstraintException(int studentId, int professorId)
|
||||
: base($"Estudiante {studentId} ya tiene materia con profesor {professorId}") { }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Invariantes del Dominio
|
||||
|
||||
| Invariante | Entidad | Validación |
|
||||
|------------|---------|------------|
|
||||
| Email único | Student | DB Constraint + Validator |
|
||||
| Email válido | Student | Value Object |
|
||||
| Max 3 inscripciones | Student | Domain Service |
|
||||
| No repetir profesor | Student | Domain Service |
|
||||
| 3 créditos/materia | Subject | Constante |
|
||||
| 2 materias/profesor | Professor | Seed Data |
|
||||
|
|
@ -0,0 +1,133 @@
|
|||
# DV-001: Configuración del Repositorio
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Estructura de Carpetas
|
||||
|
||||
```
|
||||
/
|
||||
├── src/
|
||||
│ ├── backend/
|
||||
│ │ ├── Domain/
|
||||
│ │ ├── Application/
|
||||
│ │ ├── Adapters/
|
||||
│ │ │ ├── Driving/Api/
|
||||
│ │ │ └── Driven/Persistence/
|
||||
│ │ └── Host/
|
||||
│ └── frontend/
|
||||
│ └── src/app/
|
||||
│ ├── core/
|
||||
│ ├── shared/
|
||||
│ └── features/
|
||||
├── tests/
|
||||
│ ├── Domain.Tests/
|
||||
│ ├── Application.Tests/
|
||||
│ ├── Adapters.Tests/
|
||||
│ └── e2e/
|
||||
├── docs/
|
||||
│ └── entregables/
|
||||
├── database/
|
||||
│ ├── scripts/
|
||||
│ └── migrations/
|
||||
├── deploy/
|
||||
│ └── docker/
|
||||
├── CLAUDE.md
|
||||
├── README.md
|
||||
└── .gitignore
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. .gitignore
|
||||
|
||||
```gitignore
|
||||
# .NET
|
||||
bin/
|
||||
obj/
|
||||
*.user
|
||||
*.suo
|
||||
.vs/
|
||||
*.csproj.user
|
||||
|
||||
# Angular
|
||||
node_modules/
|
||||
dist/
|
||||
.angular/
|
||||
.nx/
|
||||
|
||||
# IDE
|
||||
.idea/
|
||||
.vscode/
|
||||
*.swp
|
||||
|
||||
# Logs
|
||||
*.log
|
||||
logs/
|
||||
|
||||
# Environment
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
appsettings.*.json
|
||||
!appsettings.json
|
||||
!appsettings.Development.json.example
|
||||
|
||||
# Database
|
||||
*.mdf
|
||||
*.ldf
|
||||
|
||||
# OS
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Test
|
||||
coverage/
|
||||
TestResults/
|
||||
|
||||
# Build
|
||||
publish/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Comandos de Inicialización
|
||||
|
||||
```bash
|
||||
# Crear repositorio
|
||||
git init
|
||||
git add .
|
||||
git commit -m "chore: initial project structure"
|
||||
|
||||
# Crear rama de desarrollo
|
||||
git checkout -b develop
|
||||
|
||||
# Estructura de ramas
|
||||
# main → producción
|
||||
# develop → integración
|
||||
# feature/ → nuevas funcionalidades
|
||||
# fix/ → correcciones
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Convenciones de Commits
|
||||
|
||||
```
|
||||
<tipo>(<alcance>): <descripción>
|
||||
|
||||
Tipos:
|
||||
- feat: Nueva funcionalidad
|
||||
- fix: Corrección de bug
|
||||
- refactor: Refactorización
|
||||
- test: Tests
|
||||
- docs: Documentación
|
||||
- chore: Tareas de mantenimiento
|
||||
|
||||
Ejemplos:
|
||||
feat(students): add create student mutation
|
||||
fix(enrollment): validate professor constraint
|
||||
test(domain): add enrollment policy tests
|
||||
```
|
||||
|
|
@ -0,0 +1,159 @@
|
|||
# DV-002: Configuración Solución .NET 10
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Crear Solución y Proyectos
|
||||
|
||||
```bash
|
||||
cd src/backend
|
||||
|
||||
# Crear solución
|
||||
dotnet new sln -n StudentEnrollment
|
||||
|
||||
# Crear proyectos
|
||||
dotnet new classlib -n Domain -f net10.0
|
||||
dotnet new classlib -n Application -f net10.0
|
||||
dotnet new classlib -n Adapters.Driving.Api -f net10.0
|
||||
dotnet new classlib -n Adapters.Driven.Persistence -f net10.0
|
||||
dotnet new web -n Host -f net10.0
|
||||
|
||||
# Agregar a solución
|
||||
dotnet sln add Domain/Domain.csproj
|
||||
dotnet sln add Application/Application.csproj
|
||||
dotnet sln add Adapters.Driving.Api/Adapters.Driving.Api.csproj
|
||||
dotnet sln add Adapters.Driven.Persistence/Adapters.Driven.Persistence.csproj
|
||||
dotnet sln add Host/Host.csproj
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Referencias entre Proyectos
|
||||
|
||||
```bash
|
||||
# Application → Domain
|
||||
dotnet add Application reference Domain
|
||||
|
||||
# Adapters.Driving.Api → Application
|
||||
dotnet add Adapters.Driving.Api reference Application
|
||||
|
||||
# Adapters.Driven.Persistence → Domain
|
||||
dotnet add Adapters.Driven.Persistence reference Domain
|
||||
|
||||
# Host → Todos
|
||||
dotnet add Host reference Application
|
||||
dotnet add Host reference Adapters.Driving.Api
|
||||
dotnet add Host reference Adapters.Driven.Persistence
|
||||
```
|
||||
|
||||
```
|
||||
Host
|
||||
├── Adapters.Driving.Api → Application → Domain
|
||||
└── Adapters.Driven.Persistence ────────→ Domain
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Paquetes NuGet por Proyecto
|
||||
|
||||
### Domain (sin dependencias externas)
|
||||
```xml
|
||||
<!-- Solo C# puro -->
|
||||
```
|
||||
|
||||
### Application
|
||||
```xml
|
||||
<PackageReference Include="FluentValidation" />
|
||||
<PackageReference Include="Mapster" />
|
||||
<PackageReference Include="MediatR" />
|
||||
```
|
||||
|
||||
### Adapters.Driven.Persistence
|
||||
```xml
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore" />
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" />
|
||||
<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" />
|
||||
```
|
||||
|
||||
### Adapters.Driving.Api
|
||||
```xml
|
||||
<PackageReference Include="HotChocolate.AspNetCore" />
|
||||
<PackageReference Include="HotChocolate.Data" />
|
||||
<PackageReference Include="HotChocolate.Data.EntityFramework" />
|
||||
```
|
||||
|
||||
### Host
|
||||
```xml
|
||||
<PackageReference Include="Serilog.AspNetCore" />
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Directory.Build.props (Raíz backend)
|
||||
|
||||
```xml
|
||||
<Project>
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<Nullable>enable</Nullable>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
||||
</PropertyGroup>
|
||||
</Project>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Program.cs (Host)
|
||||
|
||||
```csharp
|
||||
var builder = WebApplication.CreateBuilder(args);
|
||||
|
||||
// Services
|
||||
builder.Services.AddApplication();
|
||||
builder.Services.AddPersistence(builder.Configuration);
|
||||
builder.Services.AddGraphQLApi();
|
||||
|
||||
// CORS
|
||||
builder.Services.AddCors(options =>
|
||||
{
|
||||
options.AddDefaultPolicy(policy =>
|
||||
policy.WithOrigins("http://localhost:4200")
|
||||
.AllowAnyHeader()
|
||||
.AllowAnyMethod());
|
||||
});
|
||||
|
||||
var app = builder.Build();
|
||||
|
||||
app.UseCors();
|
||||
app.MapGraphQL();
|
||||
|
||||
app.Run();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Comandos de Desarrollo
|
||||
|
||||
```bash
|
||||
# Restaurar dependencias
|
||||
dotnet restore
|
||||
|
||||
# Build
|
||||
dotnet build
|
||||
|
||||
# Ejecutar
|
||||
dotnet run --project Host
|
||||
|
||||
# Watch mode
|
||||
dotnet watch run --project Host
|
||||
|
||||
# Tests
|
||||
dotnet test
|
||||
|
||||
# Migraciones EF
|
||||
dotnet ef migrations add Initial -p Adapters.Driven.Persistence -s Host
|
||||
dotnet ef database update -p Adapters.Driven.Persistence -s Host
|
||||
```
|
||||
|
|
@ -0,0 +1,173 @@
|
|||
# DV-003: Configuración Proyecto Angular 21
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Crear Proyecto
|
||||
|
||||
```bash
|
||||
cd src/frontend
|
||||
|
||||
# Crear proyecto Angular 21
|
||||
ng new student-enrollment \
|
||||
--standalone \
|
||||
--style=scss \
|
||||
--routing \
|
||||
--ssr=false
|
||||
|
||||
cd student-enrollment
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Instalar Dependencias
|
||||
|
||||
```bash
|
||||
# Angular Material
|
||||
ng add @angular/material
|
||||
|
||||
# Apollo GraphQL
|
||||
npm install apollo-angular @apollo/client graphql
|
||||
|
||||
# GraphQL Code Generator
|
||||
npm install -D @graphql-codegen/cli \
|
||||
@graphql-codegen/typescript \
|
||||
@graphql-codegen/typescript-operations \
|
||||
@graphql-codegen/typescript-apollo-angular
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Estructura de Carpetas
|
||||
|
||||
```bash
|
||||
# Crear estructura
|
||||
mkdir -p src/app/core/{services,graphql/{queries,mutations},interceptors}
|
||||
mkdir -p src/app/shared/{components,pipes,directives}
|
||||
mkdir -p src/app/features/{students,enrollment,classmates}/{pages,components}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Configuración Apollo (app.config.ts)
|
||||
|
||||
```typescript
|
||||
import { ApplicationConfig } from '@angular/core';
|
||||
import { provideRouter } from '@angular/router';
|
||||
import { provideHttpClient } from '@angular/common/http';
|
||||
import { provideApollo } from 'apollo-angular';
|
||||
import { HttpLink } from 'apollo-angular/http';
|
||||
import { InMemoryCache } from '@apollo/client/core';
|
||||
import { inject } from '@angular/core';
|
||||
import { routes } from './app.routes';
|
||||
import { environment } from '../environments/environment';
|
||||
|
||||
export const appConfig: ApplicationConfig = {
|
||||
providers: [
|
||||
provideRouter(routes),
|
||||
provideHttpClient(),
|
||||
provideApollo(() => {
|
||||
const httpLink = inject(HttpLink);
|
||||
return {
|
||||
link: httpLink.create({ uri: environment.graphqlUrl }),
|
||||
cache: new InMemoryCache(),
|
||||
};
|
||||
}),
|
||||
],
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Environment Files
|
||||
|
||||
```typescript
|
||||
// environments/environment.ts
|
||||
export const environment = {
|
||||
production: false,
|
||||
graphqlUrl: 'https://localhost:5001/graphql',
|
||||
};
|
||||
|
||||
// environments/environment.prod.ts
|
||||
export const environment = {
|
||||
production: true,
|
||||
graphqlUrl: '/graphql',
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. GraphQL Codegen (codegen.ts)
|
||||
|
||||
```typescript
|
||||
import type { CodegenConfig } from '@graphql-codegen/cli';
|
||||
|
||||
const config: CodegenConfig = {
|
||||
schema: 'https://localhost:5001/graphql',
|
||||
documents: 'src/app/core/graphql/**/*.graphql',
|
||||
generates: {
|
||||
'src/app/core/graphql/generated/types.ts': {
|
||||
plugins: [
|
||||
'typescript',
|
||||
'typescript-operations',
|
||||
'typescript-apollo-angular',
|
||||
],
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
export default config;
|
||||
```
|
||||
|
||||
```json
|
||||
// package.json scripts
|
||||
{
|
||||
"scripts": {
|
||||
"codegen": "graphql-codegen --config codegen.ts"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Path Aliases (tsconfig.json)
|
||||
|
||||
```json
|
||||
{
|
||||
"compilerOptions": {
|
||||
"paths": {
|
||||
"@core/*": ["src/app/core/*"],
|
||||
"@shared/*": ["src/app/shared/*"],
|
||||
"@features/*": ["src/app/features/*"],
|
||||
"@env/*": ["src/environments/*"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Comandos de Desarrollo
|
||||
|
||||
```bash
|
||||
# Desarrollo
|
||||
ng serve
|
||||
|
||||
# Build producción
|
||||
ng build --configuration production
|
||||
|
||||
# Generar tipos GraphQL
|
||||
npm run codegen
|
||||
|
||||
# Lint
|
||||
ng lint
|
||||
|
||||
# Tests
|
||||
ng test
|
||||
ng test --watch=false --code-coverage
|
||||
|
||||
# Generar componente standalone
|
||||
ng g c features/students/pages/student-list --standalone
|
||||
```
|
||||
|
|
@ -0,0 +1,169 @@
|
|||
# DV-004: Configuración Base de Datos
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Docker Compose (SQL Server)
|
||||
|
||||
```yaml
|
||||
# deploy/docker/docker-compose.yml
|
||||
services:
|
||||
sqlserver:
|
||||
image: mcr.microsoft.com/mssql/server
|
||||
container_name: sqlserver-students
|
||||
environment:
|
||||
- ACCEPT_EULA=Y
|
||||
- SA_PASSWORD=${DB_PASSWORD:-YourStrong@Passw0rd}
|
||||
- MSSQL_PID=Developer
|
||||
ports:
|
||||
- "1433:1433"
|
||||
volumes:
|
||||
- sqlserver-data:/var/opt/mssql
|
||||
healthcheck:
|
||||
test: /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "$$SA_PASSWORD" -C -Q "SELECT 1"
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
|
||||
volumes:
|
||||
sqlserver-data:
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Comandos Docker
|
||||
|
||||
```bash
|
||||
# Iniciar SQL Server
|
||||
docker-compose -f deploy/docker/docker-compose.yml up -d sqlserver
|
||||
|
||||
# Ver logs
|
||||
docker logs sqlserver-students
|
||||
|
||||
# Conectar a SQL Server
|
||||
docker exec -it sqlserver-students /opt/mssql-tools18/bin/sqlcmd \
|
||||
-S localhost -U sa -P 'YourStrong@Passw0rd' -C
|
||||
|
||||
# Detener
|
||||
docker-compose -f deploy/docker/docker-compose.yml down
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Connection String
|
||||
|
||||
```json
|
||||
// appsettings.Development.json
|
||||
{
|
||||
"ConnectionStrings": {
|
||||
"DefaultConnection": "Server=localhost;Database=StudentEnrollment;User Id=sa;Password=YourStrong@Passw0rd;TrustServerCertificate=True"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. DbContext Configuration
|
||||
|
||||
```csharp
|
||||
// Adapters/Driven/Persistence/Context/AppDbContext.cs
|
||||
public class AppDbContext : DbContext
|
||||
{
|
||||
public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
|
||||
|
||||
public DbSet<Student> Students => Set<Student>();
|
||||
public DbSet<Subject> Subjects => Set<Subject>();
|
||||
public DbSet<Professor> Professors => Set<Professor>();
|
||||
public DbSet<Enrollment> Enrollments => Set<Enrollment>();
|
||||
|
||||
protected override void OnModelCreating(ModelBuilder modelBuilder)
|
||||
{
|
||||
modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Registrar DbContext
|
||||
|
||||
```csharp
|
||||
// Adapters/Driven/Persistence/DependencyInjection.cs
|
||||
public static class DependencyInjection
|
||||
{
|
||||
public static IServiceCollection AddPersistence(
|
||||
this IServiceCollection services,
|
||||
IConfiguration configuration)
|
||||
{
|
||||
services.AddDbContext<AppDbContext>(options =>
|
||||
options.UseSqlServer(
|
||||
configuration.GetConnectionString("DefaultConnection")));
|
||||
|
||||
services.AddScoped<IStudentRepository, StudentRepository>();
|
||||
services.AddScoped<ISubjectRepository, SubjectRepository>();
|
||||
services.AddScoped<IUnitOfWork, UnitOfWork>();
|
||||
|
||||
return services;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Migraciones
|
||||
|
||||
```bash
|
||||
# Crear migración inicial
|
||||
dotnet ef migrations add InitialCreate \
|
||||
-p src/backend/Adapters.Driven.Persistence \
|
||||
-s src/backend/Host
|
||||
|
||||
# Aplicar migración
|
||||
dotnet ef database update \
|
||||
-p src/backend/Adapters.Driven.Persistence \
|
||||
-s src/backend/Host
|
||||
|
||||
# Generar script SQL
|
||||
dotnet ef migrations script \
|
||||
-p src/backend/Adapters.Driven.Persistence \
|
||||
-s src/backend/Host \
|
||||
-o database/scripts/create.sql
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Seed Data
|
||||
|
||||
```csharp
|
||||
// Adapters/Driven/Persistence/Seeding/DataSeeder.cs
|
||||
public static class DataSeeder
|
||||
{
|
||||
public static void Seed(ModelBuilder modelBuilder)
|
||||
{
|
||||
// Profesores
|
||||
modelBuilder.Entity<Professor>().HasData(
|
||||
new { Id = 1, Name = "Dr. García" },
|
||||
new { Id = 2, Name = "Dra. Martínez" },
|
||||
new { Id = 3, Name = "Dr. López" },
|
||||
new { Id = 4, Name = "Dra. Rodríguez" },
|
||||
new { Id = 5, Name = "Dr. Hernández" }
|
||||
);
|
||||
|
||||
// Materias (2 por profesor)
|
||||
modelBuilder.Entity<Subject>().HasData(
|
||||
new { Id = 1, Name = "Matemáticas I", Credits = 3, ProfessorId = 1 },
|
||||
new { Id = 2, Name = "Matemáticas II", Credits = 3, ProfessorId = 1 },
|
||||
new { Id = 3, Name = "Física I", Credits = 3, ProfessorId = 2 },
|
||||
new { Id = 4, Name = "Física II", Credits = 3, ProfessorId = 2 },
|
||||
new { Id = 5, Name = "Programación I", Credits = 3, ProfessorId = 3 },
|
||||
new { Id = 6, Name = "Programación II", Credits = 3, ProfessorId = 3 },
|
||||
new { Id = 7, Name = "Base de Datos I", Credits = 3, ProfessorId = 4 },
|
||||
new { Id = 8, Name = "Base de Datos II", Credits = 3, ProfessorId = 4 },
|
||||
new { Id = 9, Name = "Redes I", Credits = 3, ProfessorId = 5 },
|
||||
new { Id = 10, Name = "Redes II", Credits = 3, ProfessorId = 5 }
|
||||
);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,161 @@
|
|||
# DV-005: Variables de Entorno
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Backend (.NET 10)
|
||||
|
||||
### appsettings.json (Base)
|
||||
|
||||
```json
|
||||
{
|
||||
"Logging": {
|
||||
"LogLevel": {
|
||||
"Default": "Information",
|
||||
"Microsoft.AspNetCore": "Warning",
|
||||
"HotChocolate": "Warning"
|
||||
}
|
||||
},
|
||||
"AllowedHosts": "*",
|
||||
"GraphQL": {
|
||||
"MaxExecutionDepth": 5,
|
||||
"MaxComplexity": 100
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### appsettings.Development.json
|
||||
|
||||
```json
|
||||
{
|
||||
"ConnectionStrings": {
|
||||
"DefaultConnection": "Server=localhost;Database=StudentEnrollment;User Id=sa;Password=YourStrong@Passw0rd;TrustServerCertificate=True"
|
||||
},
|
||||
"GraphQL": {
|
||||
"EnableIntrospection": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### appsettings.Production.json.example
|
||||
|
||||
```json
|
||||
{
|
||||
"ConnectionStrings": {
|
||||
"DefaultConnection": "Server=PROD_SERVER;Database=StudentEnrollment;User Id=app_user;Password=CHANGE_ME;Encrypt=True"
|
||||
},
|
||||
"GraphQL": {
|
||||
"EnableIntrospection": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. User Secrets (Desarrollo Local)
|
||||
|
||||
```bash
|
||||
# Inicializar secrets
|
||||
cd src/backend/Host
|
||||
dotnet user-secrets init
|
||||
|
||||
# Guardar connection string
|
||||
dotnet user-secrets set "ConnectionStrings:DefaultConnection" \
|
||||
"Server=localhost;Database=StudentEnrollment;User Id=sa;Password=YourStrong@Passw0rd;TrustServerCertificate=True"
|
||||
|
||||
# Listar secrets
|
||||
dotnet user-secrets list
|
||||
|
||||
# Remover
|
||||
dotnet user-secrets remove "ConnectionStrings:DefaultConnection"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Frontend (Angular 21)
|
||||
|
||||
### environment.ts (Desarrollo)
|
||||
|
||||
```typescript
|
||||
export const environment = {
|
||||
production: false,
|
||||
graphqlUrl: 'https://localhost:5001/graphql',
|
||||
apiTimeout: 30000,
|
||||
};
|
||||
```
|
||||
|
||||
### environment.prod.ts (Producción)
|
||||
|
||||
```typescript
|
||||
export const environment = {
|
||||
production: true,
|
||||
graphqlUrl: '/graphql',
|
||||
apiTimeout: 15000,
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Docker (.env)
|
||||
|
||||
### .env.example
|
||||
|
||||
```env
|
||||
# Database
|
||||
DB_PASSWORD=YourStrong@Passw0rd
|
||||
DB_NAME=StudentEnrollment
|
||||
|
||||
# API
|
||||
ASPNETCORE_ENVIRONMENT=Development
|
||||
ASPNETCORE_URLS=http://+:5000
|
||||
|
||||
# Frontend
|
||||
FRONTEND_URL=http://localhost:4200
|
||||
```
|
||||
|
||||
### docker-compose.yml (usando .env)
|
||||
|
||||
```yaml
|
||||
services:
|
||||
sqlserver:
|
||||
environment:
|
||||
- SA_PASSWORD=${DB_PASSWORD}
|
||||
|
||||
api:
|
||||
environment:
|
||||
- ASPNETCORE_ENVIRONMENT=${ASPNETCORE_ENVIRONMENT}
|
||||
- ConnectionStrings__DefaultConnection=Server=sqlserver;Database=${DB_NAME};User Id=sa;Password=${DB_PASSWORD};TrustServerCertificate=True
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Variables por Ambiente
|
||||
|
||||
| Variable | Desarrollo | Producción |
|
||||
|----------|------------|------------|
|
||||
| ConnectionString | localhost | Servidor prod |
|
||||
| EnableIntrospection | true | false |
|
||||
| LogLevel | Debug | Warning |
|
||||
| CORS Origins | localhost:4200 | dominio.com |
|
||||
| MaxExecutionDepth | 10 | 5 |
|
||||
|
||||
---
|
||||
|
||||
## 6. Cargar Configuración
|
||||
|
||||
```csharp
|
||||
// Program.cs
|
||||
var builder = WebApplication.CreateBuilder(args);
|
||||
|
||||
// Orden de carga (último gana):
|
||||
// 1. appsettings.json
|
||||
// 2. appsettings.{Environment}.json
|
||||
// 3. User Secrets (solo Development)
|
||||
// 4. Variables de entorno
|
||||
// 5. Command line args
|
||||
|
||||
var connectionString = builder.Configuration
|
||||
.GetConnectionString("DefaultConnection");
|
||||
```
|
||||
|
|
@ -0,0 +1,197 @@
|
|||
# DV-006: Herramientas de Calidad
|
||||
|
||||
**Proyecto:** Sistema de Registro de Estudiantes
|
||||
**Fecha:** 2026-01-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Backend (.NET 10)
|
||||
|
||||
### .editorconfig
|
||||
|
||||
```ini
|
||||
root = true
|
||||
|
||||
[*]
|
||||
indent_style = space
|
||||
indent_size = 4
|
||||
end_of_line = lf
|
||||
charset = utf-8
|
||||
trim_trailing_whitespace = true
|
||||
insert_final_newline = true
|
||||
|
||||
[*.{cs,csx}]
|
||||
csharp_style_var_when_type_is_apparent = true:suggestion
|
||||
csharp_prefer_braces = true:warning
|
||||
dotnet_sort_system_directives_first = true
|
||||
```
|
||||
|
||||
### Directory.Build.props (Analyzers)
|
||||
|
||||
```xml
|
||||
<Project>
|
||||
<PropertyGroup>
|
||||
<TargetFramework>net10.0</TargetFramework>
|
||||
<Nullable>enable</Nullable>
|
||||
<ImplicitUsings>enable</ImplicitUsings>
|
||||
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
||||
<EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
|
||||
<AnalysisLevel>latest</AnalysisLevel>
|
||||
</PropertyGroup>
|
||||
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" PrivateAssets="all" />
|
||||
</ItemGroup>
|
||||
</Project>
|
||||
```
|
||||
|
||||
### Comandos
|
||||
|
||||
```bash
|
||||
# Formatear código
|
||||
dotnet format
|
||||
|
||||
# Verificar sin cambiar
|
||||
dotnet format --verify-no-changes
|
||||
|
||||
# Build con warnings
|
||||
dotnet build -warnaserror
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Frontend (Angular 21)
|
||||
|
||||
### ESLint
|
||||
|
||||
```bash
|
||||
# Instalar
|
||||
ng add @angular-eslint/schematics
|
||||
```
|
||||
|
||||
```json
|
||||
// .eslintrc.json
|
||||
{
|
||||
"root": true,
|
||||
"overrides": [
|
||||
{
|
||||
"files": ["*.ts"],
|
||||
"extends": [
|
||||
"eslint:recommended",
|
||||
"plugin:@typescript-eslint/recommended",
|
||||
"plugin:@angular-eslint/recommended"
|
||||
],
|
||||
"rules": {
|
||||
"@angular-eslint/component-selector": ["error", {
|
||||
"prefix": "app",
|
||||
"style": "kebab-case",
|
||||
"type": "element"
|
||||
}],
|
||||
"@typescript-eslint/no-unused-vars": "error",
|
||||
"no-console": "warn"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Prettier
|
||||
|
||||
```json
|
||||
// .prettierrc
|
||||
{
|
||||
"singleQuote": true,
|
||||
"trailingComma": "es5",
|
||||
"tabWidth": 2,
|
||||
"semi": true,
|
||||
"printWidth": 100
|
||||
}
|
||||
```
|
||||
|
||||
```json
|
||||
// .prettierignore
|
||||
node_modules
|
||||
dist
|
||||
coverage
|
||||
.angular
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Pre-commit Hooks (Husky)
|
||||
|
||||
```bash
|
||||
# Instalar
|
||||
npm install -D husky lint-staged
|
||||
npx husky init
|
||||
```
|
||||
|
||||
```json
|
||||
// package.json
|
||||
{
|
||||
"lint-staged": {
|
||||
"*.ts": ["eslint --fix", "prettier --write"],
|
||||
"*.html": ["prettier --write"],
|
||||
"*.scss": ["prettier --write"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```bash
|
||||
# .husky/pre-commit
|
||||
npm run lint-staged
|
||||
cd ../backend && dotnet format --verify-no-changes
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Scripts package.json
|
||||
|
||||
```json
|
||||
{
|
||||
"scripts": {
|
||||
"start": "ng serve",
|
||||
"build": "ng build",
|
||||
"test": "ng test",
|
||||
"lint": "ng lint",
|
||||
"format": "prettier --write \"src/**/*.{ts,html,scss}\"",
|
||||
"format:check": "prettier --check \"src/**/*.{ts,html,scss}\"",
|
||||
"codegen": "graphql-codegen",
|
||||
"prepare": "husky"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. CI Checks
|
||||
|
||||
```yaml
|
||||
# .github/workflows/ci.yml (ejemplo)
|
||||
jobs:
|
||||
backend:
|
||||
steps:
|
||||
- run: dotnet format --verify-no-changes
|
||||
- run: dotnet build -warnaserror
|
||||
- run: dotnet test
|
||||
|
||||
frontend:
|
||||
steps:
|
||||
- run: npm ci
|
||||
- run: npm run lint
|
||||
- run: npm run format:check
|
||||
- run: npm run build
|
||||
- run: npm test -- --watch=false
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Checklist de Calidad
|
||||
|
||||
| Verificación | Backend | Frontend |
|
||||
|--------------|---------|----------|
|
||||
| Formato código | `dotnet format` | `prettier` |
|
||||
| Linting | Roslyn Analyzers | ESLint |
|
||||
| Tipos | Nullable enabled | TypeScript strict |
|
||||
| Tests | xUnit | Jasmine/Jest |
|
||||
| Pre-commit | dotnet format | lint-staged |
|
||||
Loading…
Reference in New Issue