Develop

.github/CODEOWNERS

@@ -10,10 +10,10 @@
 *  @jhosepmyr
 
 # ─── Cover page, Version History, and general structure ─────────────────────
-README.md                        @jhosepmyr @Eric396
+README.md                        @jhosepmyr @Eric396 @salimramirez @VarBus @Kyrubi
 
 # ─── Brand & logos ──────────────────────────────────────────────────────────
-assets/brand/                    @Eric396
+assets/brand/                    @jhosepmyr
 
 # ─── Team photos ────────────────────────────────────────────────────────────
 assets/team/                     @jhosepmyr
@@ -22,25 +22,28 @@ assets/team/                     @jhosepmyr
 assets/insights/                 @jhosepmyr
 
 # ─── Chapter I: Lean UX ─────────────────────────────────────────────────────
-assets/lean-ux/                  @Eric396
+assets/lean-ux/                  @jhosepmyr
 
 # ─── Chapter II: Interviews ─────────────────────────────────────────────────
-assets/interviews/               @salimramirez @VarBus
+assets/interviews/               @jhosepmyr
 
 # ─── Chapter II: User Research ──────────────────────────────────────────────
-assets/user-research/            @Kyrubi @jhosepmyr
+assets/user-research/            @jhosepmyr
 
 # ─── Chapter IV: EventStorming ──────────────────────────────────────────────
-assets/event-storming/           @Eric396 @jhosepmyr
+assets/event-storming/           @jhosepmyr
 
 # ─── Chapter IV: Domain-Driven Design ───────────────────────────────────────
-assets/ddd/                      @Eric396 @jhosepmyr
+assets/ddd/                      @jhosepmyr
 
 # ─── Chapter IV: Software Architecture (C4) ─────────────────────────────────
 assets/architecture/             @jhosepmyr
 
+# ─── Chapter VI: Solution UX Design (wireframes, wireflows, mockups, style) ─
+assets/ui/                       @jhosepmyr
+
 # ─── Annexes ────────────────────────────────────────────────────────────────
-assets/annexes/                  @VarBus @salimramirez
+assets/annexes/                  @jhosepmyr
 
 # ─── Repository governance files ────────────────────────────────────────────
 CHANGELOG.md                     @jhosepmyr

.github/workflows/generate-pdf.yml

@@ -42,12 +42,26 @@ jobs:
           mv README.pdf ReqsAI-Report.pdf
 
       - name: Upload artifact
+        id: upload
         uses: actions/upload-artifact@v7
         with:
           name: ReqsAI-Report-PDF
           path: ReqsAI-Report.pdf
           retention-days: 90
 
+      - name: Job summary
+        run: |
+          echo "## ReqsAI Report — PDF generado" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "| | |" >> $GITHUB_STEP_SUMMARY
+          echo "|---|---|" >> $GITHUB_STEP_SUMMARY
+          echo "| **Commit** | \`${{ github.sha }}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Branch** | \`${{ github.ref_name }}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Fecha** | $(date +'%Y-%m-%d %H:%M UTC') |" >> $GITHUB_STEP_SUMMARY
+          echo "| **Tamaño** | $(du -sh ReqsAI-Report.pdf | cut -f1) |" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### [Descargar PDF](${{ steps.upload.outputs.artifact-url }})" >> $GITHUB_STEP_SUMMARY
+
       - name: Attach to release (if tagged)
         if: startsWith(github.ref, 'refs/tags/')
         uses: softprops/action-gh-release@v3

assets/diagrams/architecture/container-diagram.puml

@@ -0,0 +1,90 @@
+@startuml container-diagram
+!include ../c4/C4_Container.puml
+!include ../c4/C4_Component.puml
+!include ../styles/reqsai-palette.puml
+
+HIDE_PERSON_SPRITE()
+
+skinparam defaultFontName "Segoe UI"
+skinparam shadowing false
+
+UpdateElementStyle(person,      $bgColor=$REQSAI_NAVY_800,  $fontColor="#FFFFFF", $borderColor="#1A3A5C")
+UpdateElementStyle(system_ext,  $bgColor="#455A64",          $fontColor="#FFFFFF", $borderColor="#263238")
+UpdateElementStyle(container,   $bgColor=$REQSAI_BLUE_700,   $fontColor="#FFFFFF", $borderColor=$REQSAI_BLUE_800)
+UpdateElementStyle(containerDb, $bgColor=$REQSAI_TEAL_800,   $fontColor="#FFFFFF", $borderColor=$REQSAI_TEAL_900)
+UpdateElementStyle(component,   $bgColor=$REQSAI_BLUE_600,   $fontColor="#FFFFFF", $borderColor=$REQSAI_BLUE_700)
+
+AddContainerTag("edge",     $bgColor="#37474F",        $fontColor="#FFFFFF", $borderColor="#263238", $legendText="Edge / Routing Layer (AWS)")
+AddContainerTag("frontend", $bgColor=$REQSAI_NAVY_800, $fontColor="#FFFFFF", $borderColor="#1A3A5C", $legendText="Frontend Application")
+
+title Container Diagram -- ReqsAI (C4 Level 2)
+
+' ── Actors ──────────────────────────────────────────────────────────
+Person(techLead, "Technical Lead", "Inicia grabaciones y\naprueba historias de usuario.")
+Person(analyst,  "Enterprise Analyst", "Administra la organizacion\ny el plan de suscripcion.")
+
+' ── Edge layer ──────────────────────────────────────────────────────
+Container(cdn,   "CDN & Reverse Proxy", "Amazon CloudFront", "Sirve los activos estaticos del SPA Angular\ndesde ubicaciones globales (Edge Locations),\ncachea respuestas, mitiga DDoS y enruta\nel trafico de API hacia el API Gateway.", $tags="edge")
+Container(apiGw, "API Gateway",         "AWS API Gateway",   "Punto de entrada unificado para peticiones\nREST y WebSocket desde web y mobile.\nGestiona throttling, metricas y SSL.", $tags="edge")
+
+' ── Frontends ────────────────────────────────────────────────────────
+Container(web,    "Web Application", "Angular",  "SPA web principal. Revision de historias,\nconfiguracion de proyectos y administracion\nde la organizacion. Servida por CloudFront.", $tags="frontend")
+Container(mobile, "Mobile App",      "Flutter",  "App movil multiplataforma (iOS/Android).\nGrabacion de reuniones y revision\nde requerimientos. Llama al API Gateway\ndirectamente (no pasa por CDN).", $tags="frontend")
+
+' ── Backend: Monolito Modular ─────────────────────────────────────────
+Container_Boundary(backend, "ReqsAI Backend Service  [Java 25 + Spring Boot 4 -- Monolito Modular / Spring Modulith]") {
+
+  Component(iam,       "IAM",                    "Spring Modulith Module", "Autenticacion JWT, registro de cuentas,\nverificacion de email, sesiones y\ngestion de perfil de usuario.")
+
+  Component(billing,   "Billing & Subscriptions", "Spring Modulith Module", "Ciclo de vida de suscripciones, control de\ncuotas de tokens e integracion con\nla pasarela de pagos externa.")
+
+  Component(workspace, "Workspace Management",    "Spring Modulith Module", "Organizaciones, proyectos, miembros, roles,\ndocumentos, glosarios y aplicacion de\nlimites de plan (Row Level Security).")
+
+  Component(discovery, "Requirement Discovery",   "Spring Modulith Module", "Captura de audio, transcripcion STT,\nmotor RAG con embeddings y generacion\nde historias Gherkin via LLM.")
+
+  Component(gateway,   "Integration Gateway",     "Spring Modulith Module", "Exportacion de historias de usuario\naprobadas a herramientas externas\nde gestion de proyectos.")
+}
+
+' ── Database ─────────────────────────────────────────────────────────
+ContainerDb(db, "Database", "PostgreSQL + pgvector\n[AWS RDS]", "Base de datos relacional administrada.\nLa extension pgvector habilita almacenamiento\nde embeddings vectoriales para el motor RAG.")
+
+' ── External Systems ─────────────────────────────────────────────────
+System_Ext(email,   "Email Service Provider", "Correos transaccionales:\nverificacion, recuperacion, invitaciones.")
+System_Ext(payment, "Payment Gateway",        "Procesamiento de pagos B2B.\nEj: Stripe, Culqi, Mercado Pago.")
+System_Ext(stt,      "STT API",               "Speech-to-Text: convierte audio\nen texto en tiempo real (< 2 seg).")
+System_Ext(embedApi, "Embedding API",         "Convierte texto en vectores para\nel indice RAG (pgvector). Ej: OpenAI\ntext-embedding-3-small, Cohere Embed.")
+System_Ext(llm,      "LLM API",               "Large Language Model generativo.\nEj: GPT-4o, Claude, Gemini.")
+System_Ext(pmtool,   "Project Management API", "Crea issues automaticamente\nen el backlog. Ej: Jira, Trello, Linear.")
+
+' ── Relations ────────────────────────────────────────────────────────
+' Web: pasa por CDN
+Rel(techLead, cdn,    "Accede via navegador", "HTTPS")
+Rel(analyst,  cdn,    "Accede via navegador", "HTTPS")
+Rel(cdn, web,         "Sirve SPA estatico",   "HTTPS")
+Rel(cdn, apiGw,       "Enruta llamadas API",  "HTTPS")
+Rel(web, apiGw,       "Llamadas API",         "HTTPS / REST")
+
+' Mobile: directo al API Gateway (app instalada desde App Store, no desde CDN)
+Rel(techLead, mobile, "Usa app movil",        "App Store / Play Store")
+Rel(mobile,   apiGw,  "Llamadas API directas","HTTPS / REST + WebSocket")
+
+Rel(apiGw, backend, "Enruta peticiones al monolito", "HTTPS / REST")
+
+Rel(iam,       db, "Lee y escribe", "JDBC / JPA")
+Rel(billing,   db, "Lee y escribe", "JDBC / JPA")
+Rel(workspace, db, "Lee y escribe", "JDBC / JPA")
+Rel(discovery, db, "Lee y escribe", "JDBC / JPA")
+Rel(gateway,   db, "Lee y escribe", "JDBC / JPA")
+
+Rel(iam,       email,    "Envia correos transaccionales via",       "REST API")
+Rel(billing,   payment,  "Procesa pagos de suscripcion via",        "REST API")
+Rel(workspace, embedApi, "Vectoriza docs + glosario para RAG via",  "REST API")
+Rel(workspace, llm,      "Procesa contenido de documentos via",     "REST API")
+Rel(discovery, stt,      "Envia audio para transcripcion via",      "REST / Streaming")
+Rel(discovery, embedApi, "Vectoriza user stories generadas via",    "REST API")
+Rel(discovery, llm,      "Infiere historias en Gherkin via",        "REST API")
+Rel(gateway,   pmtool,   "Exporta historias aprobadas via",         "REST API")
+
+SHOW_LEGEND()
+
+@enduml

assets/diagrams/architecture/deployment-diagram.puml

@@ -0,0 +1,128 @@
+@startuml deployment-diagram
+!include ../styles/reqsai-palette.puml
+
+skinparam defaultFontName "Segoe UI"
+skinparam shadowing false
+skinparam backgroundColor #FFFFFF
+skinparam ArrowColor $REQSAI_ARROW
+skinparam ArrowFontColor $REQSAI_NEUTRAL_800
+skinparam ArrowFontSize 11
+
+skinparam node {
+  BackgroundColor $REQSAI_NEUTRAL_100
+  BorderColor     $REQSAI_NEUTRAL_600
+  FontColor       $REQSAI_NEUTRAL_800
+  FontSize        12
+  FontStyle       bold
+}
+
+skinparam artifact {
+  BackgroundColor $REQSAI_BLUE_700
+  BorderColor     $REQSAI_BLUE_900
+  FontColor       #FFFFFF
+  FontSize        11
+}
+
+skinparam database {
+  BackgroundColor $REQSAI_TEAL_800
+  BorderColor     $REQSAI_TEAL_900
+  FontColor       #FFFFFF
+  FontSize        11
+}
+
+skinparam component {
+  BackgroundColor $REQSAI_NAVY_800
+  BorderColor     "#1A3A5C"
+  FontColor       #FFFFFF
+  FontSize        11
+}
+
+
+title Deployment Diagram -- ReqsAI (C4 Level 4)
+
+' ────────────────────────────────────────────────────────────────────
+' CLIENT SIDE
+' ────────────────────────────────────────────────────────────────────
+node "Mobile Devices  [iOS / Android]" as mobileDevices {
+  node "User Smartphone" as smartphone {
+    artifact "Mobile App\n[Flutter Engine]" as mobileApp
+  }
+}
+
+node "User Workstations  [Windows / macOS / Linux]" as workstations {
+  node "Web Browser  [Browser Runtime]" as browser {
+    artifact "Web Application\n[Angular SPA]" as webApp
+  }
+}
+
+' ────────────────────────────────────────────────────────────────────
+' AWS EDGE LOCATION
+' ────────────────────────────────────────────────────────────────────
+node "AWS Edge Location  [Amazon CloudFront]" as edgeLayer {
+  artifact "CDN & Reverse Proxy\n[Amazon CloudFront]\nSirve SPA estatico + enruta API" as cdn
+}
+
+' ────────────────────────────────────────────────────────────────────
+' AWS NORTH AMERICA  (us-east-1 — Virginia)
+' ────────────────────────────────────────────────────────────────────
+node "AWS North America  [AWS Region us-east-1 (Virginia)]" as awsNorthAmerica {
+
+  node "API Gateway  [AWS API Gateway]" as apiGatewayNode {
+    artifact "API Gateway\n[AWS API Gateway]\nRouting REST + WebSocket" as apiGw
+  }
+
+  node "ECS Cluster  [AWS ECS + Fargate]" as ecsCluster {
+    component "ReqsAI Backend Service\n[Java 25 + Spring Boot 4 / Docker Container]\n\nModulos: IAM · Billing · Workspace\nRequirement Discovery · Integration Gateway" as backend
+    artifact "Grafana Alloy\n[Sidecar Container]\nColecta metricas, logs y trazas\ndel backend y los envia al\nservidor de observabilidad" as alloy
+  }
+
+  node "Observability Server  [AWS EC2 + Docker Compose]" as obsServer {
+    component "Prometheus\n[Metricas]" as prometheus
+    component "Loki\n[Logs]" as loki
+    component "Tempo\n[Trazas distribuidas]" as tempo
+    component "Grafana\n[Dashboards]" as grafana
+  }
+}
+
+' ────────────────────────────────────────────────────────────────────
+' AWS RDS
+' ────────────────────────────────────────────────────────────────────
+node "AWS RDS  [Managed Relational Database]" as dbNode {
+  database "PostgreSQL + pgvector\n[ReqsAI Main Database]" as db
+}
+
+' ────────────────────────────────────────────────────────────────────
+' RELATIONS
+' ────────────────────────────────────────────────────────────────────
+' Web: pasa por CloudFront
+webApp  --> cdn    : "HTTPS"
+cdn     --> webApp : "Sirve SPA estatico\n(Edge Locations)"
+cdn     --> apiGw  : "Enruta trafico API\nHTTPS"
+
+' Mobile: directo al API Gateway (app instalada, no servida por CDN)
+mobileApp --> apiGw : "Llamadas API directas\nHTTPS / REST + WebSocket"
+
+apiGw --> backend : "Route all requests\nHTTPS / REST"
+
+' Observabilidad: Alloy como sidecar recolecta del backend
+backend --> alloy      : "Metricas /actuator/prometheus\nLogs stdout · Trazas OTLP"
+alloy   --> prometheus : "Push metricas\nRemote Write"
+alloy   --> loki       : "Push logs"
+alloy   --> tempo      : "Push trazas\nOTLP"
+grafana --> prometheus : "Query metricas\nPromQL"
+grafana --> loki       : "Query logs\nLogQL"
+grafana --> tempo      : "Query trazas\nTraceQL"
+
+' Persistencia
+backend --> db : "Reads and writes\nJDBC / JPA"
+
+legend bottom right
+  |= Elemento                                                              |= Descripcion                              |
+  |<back:$REQSAI_NEUTRAL_100><color:$REQSAI_NEUTRAL_800><b> Nodo </b></color></back>        | Infraestructura / entorno de despliegue   |
+  |<back:$REQSAI_BLUE_700><color:#FFFFFF><b> Artefacto </b></color></back>                  | Aplicacion o servicio desplegado          |
+  |<back:$REQSAI_NAVY_800><color:#FFFFFF><b> Componente </b></color></back>                 | Modulo de aplicacion (Spring Modulith)    |
+  |<back:$REQSAI_TEAL_800><color:#FFFFFF><b> Base de datos </b></color></back>              | Almacenamiento relacional (PostgreSQL)    |
+  | ->                                                                     | Comunicacion entre nodos                  |
+endlegend
+
+@enduml