# βοΈ AWS INFRASTRUCTURE SPECIFICATION β HAP ECOSYSTEM 3.0
*(World-Class Cloud-Native Architecture, BFF Microservices & Enterprise Database Standards)*
---
## π 1. VisiΓ³n Ejecutiva y Principios de DiseΓ±o
El ecosistema **HAP 3.0** estΓ‘ diseΓ±ado para operar a escala nacional en MΓ©xico, soportando decenas de miles de transacciones concurrentes con alta disponibilidad, resiliencia a fallos y velocidad extrema.
### Principios Rectores:
1. **PatrΓ³n BFF (Backend For Frontend)**: Cada aplicaciΓ³n frontend cuenta con su propia API backend especializada e independiente. No existe una API monolΓtica central compartida en el cΓ³digo.
2. **Fuente Γnica de Verdad (Central Data Layer)**: Todas las APIs se conectan a un cluster central de base de datos relacional (Amazon RDS) con rΓ©plica de lectura para consultas analΓticas.
3. **Desacople Absoluto y Aislamiento de Fallos (*Blast Radius Containment*)**: Un error o caΓda en el backend de Torre de Control o Franquicias es fΓsicamente incapaz de afectar a los conductores en calle (*HAP Drivers*).
4. **Regla de Oro de No DestrucciΓ³n (#21)**: La infraestructura actual en producciΓ³n (`95.111.214.233`) permanece 100% operativa e intacta mientras se despliega la nueva infraestructura en AWS. La transiciΓ³n final se realiza de manera transparente vΓa DNS (*Zero Downtime Cutover*).
---
## ποΈ 2. Mapa Global de Arquitectura en AWS
```
[ INTERNET / DISPOSITIVOS MΓVILES ]
β
ββββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββ
β β
(TrΓ‘fico Web SPA / PWA) (TrΓ‘fico APIs Backend)
β β
βΌ βΌ
βββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββ
β AWS AMPLIFY HOSTING β β AWS GLOBAL ACCELERATOR β
β (S3 + CloudFront Edge) β β (Anycast IPs EstΓ‘ticas) β
βββββββββββββββ¬ββββββββββββββ ββββββββββββββββ¬βββββββββββββββ
β β
ββββββββββββββΌβββββββββββββ¬βββββββββββββ βΌ
βΌ βΌ βΌ βΌ βββββββββββββββββββββββββββββββ
ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ β SHARED APPLICATION LOAD β
βHAP Users β βHAP Driverβ βHAP Fleet β βHAP Tower β β BALANCER (ALB) β
β PWA β β PWA β β WebApp β β WebApp β ββββββββββββββββ¬βββββββββββββββ
ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ β (Host-Based Routing)
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββ
βΌ βΌ βΌ βΌ
ββββββββββββββββββββββββββββββββ ββββββββββββββββββββββββββββββββ ββββββββββββββββββββββββββββββββ ββββββββββββββββββββββββββββββββ
β BEANSTALK ENV 1 β β BEANSTALK ENV 2 β β BEANSTALK ENV 3 β β BEANSTALK ENV 4 β
β HAP Users API β β HAP Drivers API β β HAP Fleet API β β HAP Control Tower API β
β (api.users.soyhap.com) β β (api.drivers.hap.mx) β β (api.fleet.hap.mx) β β (api.tower.hap.mx) β
ββββββββββββββββ¬ββββββββββββββββ ββββββββββββββββ¬ββββββββββββββββ ββββββββββββββββ¬ββββββββββββββββ ββββββββββββββββ¬ββββββββββββββββ
β β β β
ββββββββββββββββββββββββββββββββββ΄ββββββββ¬βββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
βΌ βΌ
ββββββββββββββββββββββββββββββββ ββββββββββββββββββββββββββββββββββββββββββββββββ
β AMAZON ELASTICACHE REDIS β β AMAZON RDS CLUSTER β
β (TelemetrΓa GPS en Vivo, β β (PostgreSQL + PostGIS o MySQL 8.0) β
β Radar 0 ms, Rate-Limiting) β ββββββββββββββββββββββββ¬ββββββββββββββββββββββββ€
ββββββββββββββββββββββββββββββββ β PRIMARY (WRITER) β READ REPLICA (READER) β
β Transacciones ACID, β Dashboards, Reportes, β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β Γrdenes, Pagos β AuditorΓa, Consultas β
β AMAZON S3 BUCKET β ββββββββββββββββββββββββ΄ββββββββββββββββββββββββ
β (Evidencias FotogrΓ‘ficas & Facturas CSF en PDF) β
β * Subida directa vΓa S3 Presigned URLs β
β * Reglas Lifecycle: Archivo a S3 Glacier a 90 dΓas β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
---
## π± 3. Los 4 Proyectos AutΓ³nomos (BFF Microservices)
Cada uno de los 4 proyectos es una soluciΓ³n completa y aislada que posee su propio repositorio (o carpeta raΓz en monorepo), su propio pipeline de CI/CD y sus propias variables de entorno:
| Proyecto | Dominio Frontend (Amplify) | Dominio Backend (Beanstalk) | PropΓ³sito & Capacidades Clave |
| :--- | :--- | :--- | :--- |
| **1. HAP Users** | `app.soyhap.com`
*(o user.hap.mx)* | `api.users.soyhap.com` | **PWA Clientes**: CatΓ‘logo de 3 tamaΓ±os de autos (Chico, Mediano, Grande), agendamiento programado, botΓ³n HAP Express, integraciΓ³n Stripe Elements, membresΓas (DΓas HAP) y facturaciΓ³n CSF. |
| **2. HAP Drivers** | `driver.hap.mx` | `api.drivers.hap.mx` | **PWA Conductores de Campo**: Ultraligera (<150 KB), cΓ‘mara nativa transparente, compresiΓ³n client-side en Canvas (1280px, ~150 KB), persistencia offline, HUD de misiΓ³n unidireccional y pings de telemetrΓa. |
| **3. HAP Fleet** | `fleet.hap.mx` | `api.fleet.hap.mx` | **WebApp Franquiciatarios / Flotillas**: Tablero financiero de territorio, monitoreo en vivo de lavadores asignados a la franquicia, cortes de caja de efectivo, comisiones y altas de personal. |
| **4. HAP Control Tower** | `tower.hap.mx`
*(o admin.hap.mx)* | `api.tower.hap.mx` | **Mission Control Matriz Corporativa**: Despacho logΓstico nacional, radar Leaflet geolocalizado en tiempo real, tablero Kanban reactivo, mΓ©tricas ejecutivas de negocio y administraciΓ³n global. |
---
## π 4. Red, Conectividad y Edge Acceleration
### 4.1 AWS Global Accelerator
- **Rol**: Puerta de entrada para todo el trΓ‘fico de las APIs backend.
- **Beneficio para Movilidad**:
- Asigna **dos direcciones IP Anycast estΓ‘ticas globales**.
- Los telΓ©fonos celulares de los conductores en ruta entran a la red privada de fibra de AWS en el punto de presencia (PoP) mΓ‘s cercano en MΓ©xico (CDMX, QuerΓ©taro), evitando la congestiΓ³n y saltos lentos del internet pΓΊblico.
- Elimina el problema de resoluciΓ³n lenta y cachΓ© de DNS en redes mΓ³viles (Telcel, AT&T, Movistar).
- Maneja automΓ‘ticamente chequeos de salud continuos y conmutaciΓ³n por error (*Failover*) a nivel de red.
### 4.2 Shared Application Load Balancer (ALB)
- Un ΓΊnico ALB configurado detrΓ‘s de Global Accelerator que distribuye el trΓ‘fico mediante **Host-Based Routing** hacia los Target Groups de cada entorno Beanstalk:
- `api.users.soyhap.com` $\rightarrow$ Target Group: `tg-hap-users-api`
- `api.drivers.hap.mx` $\rightarrow$ Target Group: `tg-hap-drivers-api`
- `api.fleet.hap.mx` $\rightarrow$ Target Group: `tg-hap-fleet-api`
- `api.tower.hap.mx` $\rightarrow$ Target Group: `tg-hap-tower-api`
- **ConfiguraciΓ³n Clave del ALB**:
- *Idle Timeout*: Aumentado a `300 segundos` para soportar conexiones persistentes de Server-Sent Events (SSE) o WebSockets en el radar.
- *SSL/TLS*: Certificado comodΓn ACM (*AWS Certificate Manager*) renovado automΓ‘ticamente para `*.hap.mx` y `*.soyhap.com`.
---
## π» 5. Capa de CΓ³mputo Backend (AWS Elastic Beanstalk)
Cada backend opera como un entorno independiente de Elastic Beanstalk:
- **TecnologΓa**: Contenedores Docker o runtime nativo (Node.js con TypeScript / Fastify o PHP 8.2+ con OPcache).
- **Auto-Scaling Group (ASG)**:
- Configurado con un mΓnimo de 2 instancias (distribuidas en 2 zonas de disponibilidad `us-east-1a` y `us-east-1b`) para garantizar tolerancia a fallos.
- PolΓticas de escalado basadas en consumo de CPU (>70%) o nΓΊmero de peticiones concurrentes.
- **Escalado AsimΓ©trico**: Durante promociones masivas, `HAP Users API` puede escalar a 10 instancias mientras `HAP Drivers API` se mantiene en 2 instancias, optimizando costos.
- **Ruta de EvoluciΓ³n Futura**: Los contenedores Docker de Beanstalk son 100% compatibles para migrarse a **AWS Fargate (Amazon ECS)** sin reescribir una sola lΓnea de cΓ³digo cuando se requiera despliegue en microsegundos y cero administraciΓ³n de EC2.
---
## ποΈ 6. Capa de Datos Enterprise (Amazon RDS Cluster)
### 6.1 ConfiguraciΓ³n de Alta Disponibilidad
- **Motor**: Amazon RDS para **PostgreSQL 16 (con extensiΓ³n PostGIS)** o **MySQL 8.0**.
- **TopologΓa**:
- **Instancia Primaria (Writer)**: Instancia dedicada de cΓ³mputo para escrituras atΓ³micas, transacciones de Stripe y control de estatus de servicios.
- **RΓ©plica de Lectura (Reader)**: Instancia dedicada para absorber el 100% de las consultas pesadas de dashboards, reportes mensuales, exportaciones CSV y mΓ©tricas de Torre de Control y Franquicias.
- **Multi-AZ Activado**: RΓ©plica sΓncrona en otra zona fΓsica de disponibilidad con conmutaciΓ³n automΓ‘tica en <60 segundos ante fallos de hardware.
### 6.2 Convenciones de Nomenclatura (Regla de Oro #19)
Todo el nuevo esquema de base de datos se rige estrictamente por el estΓ‘ndar internacional en **inglΓ©s**:
1. **Tablas**: `snake_case`, en **plural** (`franchises`, `franchise_users`, `happers`, `admin_users`, `customers`, `services`, `service_photos`).
2. **Claves Primarias**: `id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY`.
3. **Claves ForΓ‘neas**: `_id` con Γndice obligatorio (`franchise_id`, `happer_id`, `customer_id`, `service_id`).
4. **Timestamps**: Formato `_at` en UTC (`created_at`, `updated_at`, `started_at`, `completed_at`, `last_login_at`). Fechas sin hora en `_date` (`birth_date`).
5. **Booleanos**: Prefijados con `is_`, `has_` o `can_` (`is_active`, `is_default`, `has_damage`).
6. **Finanzas**: Sufijo `_amount` o `_balance` en `DECIMAL(10,2)` (`total_amount`, `cash_balance`).
7. **Estatus**: MayΓΊsculas semΓ‘nticas (`PENDING`, `ACCEPTED`, `EN_ROUTE`, `ARRIVED`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED`).
### 6.3 DefiniciΓ³n DDL Oficial de Tablas Principales
```sql
-- 1. Franquicias / Territorios Concesionados
CREATE TABLE `franchises` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`code` VARCHAR(50) NOT NULL UNIQUE,
`name` VARCHAR(150) NOT NULL,
`legal_name` VARCHAR(200) DEFAULT NULL,
`tax_id` VARCHAR(20) DEFAULT NULL,
`city` VARCHAR(100) NOT NULL,
`state` VARCHAR(100) NOT NULL,
`commission_rate` DECIMAL(5, 2) NOT NULL DEFAULT 15.00,
`bank_clabe` VARCHAR(18) DEFAULT NULL,
`coverage_polygon` JSON DEFAULT NULL,
`status` ENUM('ACTIVE', 'INACTIVE', 'SUSPENDED') NOT NULL DEFAULT 'ACTIVE',
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
INDEX `idx_franchises_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 2. Usuarios de Franquicia (WebApp HAP Fleet)
CREATE TABLE `franchise_users` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`franchise_id` BIGINT UNSIGNED NOT NULL,
`email` VARCHAR(191) NOT NULL UNIQUE,
`password_hash` VARCHAR(255) NOT NULL,
`full_name` VARCHAR(150) NOT NULL,
`phone` VARCHAR(20) DEFAULT NULL,
`role` ENUM('OWNER', 'FLEET_MANAGER', 'DISPATCHER') NOT NULL DEFAULT 'OWNER',
`is_active` TINYINT(1) NOT NULL DEFAULT 1,
`session_token` VARCHAR(64) DEFAULT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
CONSTRAINT `fk_fusers_franchise` FOREIGN KEY (`franchise_id`) REFERENCES `franchises` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 3. Happers / Lavadores de Campo (HAP Drivers)
CREATE TABLE `happers` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`franchise_id` BIGINT UNSIGNED NULL,
`email` VARCHAR(191) NOT NULL UNIQUE,
`phone` VARCHAR(20) NOT NULL UNIQUE,
`password_hash` VARCHAR(255) NOT NULL,
`full_name` VARCHAR(150) NOT NULL,
`avatar_url` VARCHAR(500) DEFAULT NULL,
`status` ENUM('ACTIVE', 'INACTIVE', 'SUSPENDED', 'BLOCKED') NOT NULL DEFAULT 'ACTIVE',
`shift_status` ENUM('OFFLINE', 'AVAILABLE', 'EN_ROUTE', 'WASHING') NOT NULL DEFAULT 'OFFLINE',
`bank_clabe` VARCHAR(18) DEFAULT NULL,
`cash_balance` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`session_token` VARCHAR(64) DEFAULT NULL,
`session_device_info` VARCHAR(255) DEFAULT NULL,
`session_created_at` DATETIME DEFAULT NULL,
`fcm_token` TEXT DEFAULT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
CONSTRAINT `fk_happers_franchise` FOREIGN KEY (`franchise_id`) REFERENCES `franchises` (`id`) ON DELETE SET NULL,
INDEX `idx_happers_auth` (`email`, `status`),
INDEX `idx_happers_shift` (`status`, `shift_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 4. Clientes (HAP Users)
CREATE TABLE `customers` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`email` VARCHAR(191) NOT NULL UNIQUE,
`phone` VARCHAR(20) NOT NULL UNIQUE,
`password_hash` VARCHAR(255) NOT NULL,
`full_name` VARCHAR(150) NOT NULL,
`stripe_customer_id` VARCHAR(100) DEFAULT NULL,
`referral_code` VARCHAR(20) NOT NULL UNIQUE,
`referred_by_id` BIGINT UNSIGNED NULL,
`referral_credit_balance` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`is_vip` TINYINT(1) NOT NULL DEFAULT 0,
`status` ENUM('ACTIVE', 'INACTIVE', 'BANNED') NOT NULL DEFAULT 'ACTIVE',
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
INDEX `idx_customers_auth` (`email`, `phone`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 5. Servicios / Γrdenes Transaccionales
CREATE TABLE `services` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`service_number` VARCHAR(50) NOT NULL UNIQUE,
`customer_id` BIGINT UNSIGNED NOT NULL,
`happer_id` BIGINT UNSIGNED NULL,
`franchise_id` BIGINT UNSIGNED NULL,
`vehicle_size` ENUM('CHICO', 'MEDIANO', 'GRANDE') NOT NULL,
`upholstery_type` ENUM('TELA', 'PIEL') NOT NULL DEFAULT 'TELA',
`vehicle_details` JSON DEFAULT NULL,
`service_type` ENUM('EXPRESS', 'SCHEDULED', 'MEMBERSHIP_DAY', 'VIP') NOT NULL,
`status` ENUM('PENDING', 'ACCEPTED', 'EN_ROUTE', 'ARRIVED', 'IN_PROGRESS', 'COMPLETED', 'CANCELLED') NOT NULL DEFAULT 'PENDING',
`validation_pin` VARCHAR(4) NOT NULL,
`address_street` VARCHAR(255) NOT NULL,
`address_postal_code` VARCHAR(10) NOT NULL,
`latitude` DECIMAL(10, 8) NOT NULL,
`longitude` DECIMAL(11, 8) NOT NULL,
`total_amount` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`happer_payout_amount` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`franchise_fee_amount` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`corporate_fee_amount` DECIMAL(10, 2) NOT NULL DEFAULT 0.00,
`payment_method` ENUM('STRIPE_CARD', 'CASH', 'MEMBERSHIP_CREDIT') NOT NULL,
`stripe_payment_intent_id` VARCHAR(100) DEFAULT NULL,
`scheduled_for` DATETIME DEFAULT NULL,
`started_at` DATETIME DEFAULT NULL,
`completed_at` DATETIME DEFAULT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
CONSTRAINT `fk_srv_customer` FOREIGN KEY (`customer_id`) REFERENCES `customers` (`id`),
CONSTRAINT `fk_srv_happer` FOREIGN KEY (`happer_id`) REFERENCES `happers` (`id`),
CONSTRAINT `fk_srv_franchise` FOREIGN KEY (`franchise_id`) REFERENCES `franchises` (`id`),
INDEX `idx_srv_happer_status` (`happer_id`, `status`),
INDEX `idx_srv_status_date` (`status`, `created_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 6. Evidencias FotogrΓ‘ficas
CREATE TABLE `service_photos` (
`id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`service_id` BIGINT UNSIGNED NOT NULL,
`happer_id` BIGINT UNSIGNED NOT NULL,
`slot_type` ENUM(
'INITIAL_FRONT', 'INITIAL_SIDE_LEFT', 'INITIAL_SIDE_RIGHT', 'INITIAL_REAR',
'PREVIOUS_DAMAGE',
'FINAL_FRONT', 'FINAL_SIDE_LEFT', 'FINAL_SIDE_RIGHT', 'FINAL_REAR'
) NOT NULL,
`file_url` VARCHAR(500) NOT NULL,
`description` VARCHAR(255) DEFAULT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT `fk_photos_service` FOREIGN KEY (`service_id`) REFERENCES `services` (`id`) ON DELETE CASCADE,
INDEX `idx_photos_service_slot` (`service_id`, `slot_type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
```
---
## β‘ 7. Capa de TelemetrΓa y CachΓ© en Tiempo Real (Amazon ElastiCache Redis)
- **PropΓ³sito**: Absorber los pings de GPS de los lavadores en campo sin estresar la base de datos relacional.
- **Estructura de Datos**:
- `GEOADD happers:locations `: Guarda la posiciΓ³n geogrΓ‘fica instantΓ‘nea.
- `HSET happer::telemetry battery 85 charging 1 speed 0.0 shift AVAILABLE`: Metadatos del dispositivo mΓ³vil.
- `GEORADIUSBYMEMBER` / `GEOSEARCH`: Localiza a los Happers en un radio de 5 km en <1 milisegundo para el despacho automΓ‘tico de Γ³rdenes.
- **Pub/Sub**: Distribuye el movimiento de los autos hacia Torre de Control y HAP Fleet en tiempo real.
---
## π¦ 8. Almacenamiento Multimedia (Amazon S3 + Presigned URLs)
- **PatrΓ³n de Carga Directa (Zero-Bandwidth Backend)**:
1. La app mΓ³vil comprime la foto en Canvas a 1280px (~150 KB).
2. Solicita una firma de subida: `POST /api/v1/photos/presign` a `HAP Drivers API`.
3. La API responde con una **S3 Presigned URL** firmada con expiraciΓ³n de 5 minutos.
4. La app mΓ³vil sube el archivo directamente al bucket `s3://hap-media-prod/evidence/...` mediante HTTP `PUT`.
5. **Ventaja**: NingΓΊn byte de imagen pasa por el Load Balancer ni por Beanstalk, protegiendo la memoria y CPU de los servidores.
- **Ciclo de Vida (S3 Lifecycle Rules)**:
- De 0 a 90 dΓas: **S3 Standard** (acceso instantΓ‘neo para auditorΓa y reclamos de clientes).
- DespuΓ©s de 90 dΓas: TransiciΓ³n automΓ‘tica a **S3 Glacier Flexible Retrieval** (ahorro del 85% en costos de almacenamiento histΓ³rico).
---
## π‘οΈ 9. Seguridad, Secretos y Cumplimiento
1. **AWS Secrets Manager**:
- Todas las credenciales sensibles (claves secretas de Stripe, claves de Firebase FCM, credenciales maestras de base de datos) se almacenan cifradas con **AWS KMS**.
- Queda estrictamente prohibido colocar contraseΓ±as o tokens hardcodeados en el cΓ³digo.
2. **Cumplimiento PCI-DSS**:
- Los nΓΊmeros de tarjeta bancaria nunca tocan los servidores de HAP; viajan directamente del navegador del cliente a los servidores certificados de Stripe mediante Stripe Elements.
3. **AWS WAF (Web Application Firewall)**:
- Configurado en el Load Balancer para mitigar ataques DDoS, inyecciones SQL y aplicar *rate-limiting* estricto por IP contra bots abusivos.
---
## π 10. Estrategia de MigraciΓ³n y TransiciΓ³n sin Riesgo (Regla #21)
```mermaid
sequenceDiagram
autonumber
participant LEG as ProducciΓ³n Actual (VPS 95.111.214.233)
participant AWS as Nuevo Entorno AWS (Cloud-Native)
participant DNS as Route 53 (DNS)
participant CLI as Clientes y Conductores
Note over LEG: OperaciΓ³n Normal en Vivo (100% Intacta)
Note over AWS: Fase 1: CreaciΓ³n de Infraestructura AWS
Note over AWS: Despliegue de Amplify, Beanstalk, RDS, Redis y S3
Note over AWS: Fase 2: Carga Inicial y Pruebas Staging
LEG->>AWS: MigraciΓ³n de CatΓ‘logos, HistΓ³rico de Clientes y VehΓculos
Note over AWS: Pruebas End-to-End con Cuentas de QA en AWS
Note over AWS: Fase 3: SincronizaciΓ³n Final Delta
LEG->>AWS: SincronizaciΓ³n de Γltimas Transacciones
Note over DNS: Fase 4: Corte Limpio de TrΓ‘fico (Zero Downtime)
DNS->>AWS: Apuntar dominios app.soyhap.com y driver.hap.mx a AWS
CLI->>AWS: TrΓ‘fico entra a Global Accelerator y Amplify
Note over LEG: El servidor viejo se conserva apagado como respaldo frΓo
```
Esta especificaciΓ³n garantiza que cualquier ingeniero, agente o arquitecto que ingrese al proyecto cuente con la guΓa definitiva para construir y operar **HAP 3.0** en AWS con los mΓ‘s altos estΓ‘ndares de la industria.