chore: sync repo structure, CI, and docs with modular platform design

Author: bsayli

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,50 +1,68 @@
 name: "🐞 Bug report"
-description: "Report a bug or unexpected behavior in generated clients or schema registration"
+description: "Report a bug or unexpected behavior in the OpenAPI Generics platform"
 title: "bugfix: <short summary>"
 labels: ["bug"]
 assignees: []
+
 body:
   - type: markdown
     attributes:
       value: |
-        Thank you for taking the time to improve **spring-boot-openapi-generics-clients**!  
-        Please provide details so we can reproduce and fix the issue quickly.
+        Thank you for taking the time to improve **openapi-generics**!
+        Please provide enough detail so the issue can be reproduced deterministically.
+
   - type: textarea
     id: description
     attributes:
       label: "Describe the bug"
-      description: "A clear and concise description of what the bug is and how it affects the output."
-      placeholder: "Example: Generated client omits x-data-item when using nested Page<T> response."
+      description: "What is the incorrect behavior? Focus on observable output (OpenAPI, generated code, or runtime behavior)."
+      placeholder: "Example: Generated client omits wrapper binding when using nested generic responses (ServiceResponse<Page<T>>)."
     validations:
       required: true
+
   - type: textarea
     id: reproduction
     attributes:
       label: "Steps to reproduce"
-      description: "List the minimal steps to reproduce the issue."
+      description: "Provide minimal, deterministic steps to reproduce the issue. Prefer a clean build from repository root."
       placeholder: |
-        1. Run `mvn clean install` on customer-service-client
-        2. Inspect generated model under src/gen/java
-        3. Observe missing type or mismatch
+        1. Run `mvn clean verify` from repository root
+        2. Inspect generated sources under target/generated-sources
+        3. Observe missing/incorrect type or schema
+
   - type: textarea
     id: expected
     attributes:
       label: "Expected behavior"
-      description: "What did you expect instead?"
-      placeholder: "The generator should create ServiceResponsePageCustomerDto extending ServiceClientResponse<Page<CustomerDto>>."
+      description: "What should happen instead?"
+      placeholder: "The generator should produce a wrapper type correctly binding generic parameters and preserving contract semantics."
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: "Affected area"
+      description: "Which part of the platform is affected? (write one or more)"
+      placeholder: |
+        - contract (ServiceResponse<T>, Page, Meta)
+        - server (contract → OpenAPI projection)
+        - generator (OpenAPI → code)
+        - templates / vendor extensions
+
   - type: textarea
     id: environment
     attributes:
       label: "Environment"
-      description: "Tool versions or environment details."
+      description: "Tooling and runtime details"
       placeholder: |
         - Java: 21
-        - OpenAPI Generator: 7.21.0
+        - Maven: 3.9+
+        - OpenAPI Generator: 7.x
         - Spring Boot: 3.5.x
         - OS: macOS / Windows / Linux
+
   - type: textarea
     id: additional
     attributes:
       label: "Additional context"
-      description: "Any logs, screenshots, or related discussions."
-      placeholder: "Link to related discussion or stack trace."
+      description: "Logs, snippets, spec fragments, or links to discussions"
+      placeholder: "Include stack traces, generated code excerpts, or OpenAPI fragments if relevant."

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -7,26 +7,30 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for helping evolve **spring-boot-openapi-generics-clients**!  
+        Thanks for helping evolve **openapi-generics**!  
         Please share your idea and reasoning below.
+
   - type: textarea
     id: problem
     attributes:
       label: "Is your feature request related to a problem?"
       description: "Describe what limitation or gap you're facing."
       placeholder: "I'm always frustrated when I have to manually mark generic containers for registration..."
+
   - type: textarea
     id: solution
     attributes:
       label: "Describe the solution you'd like"
       description: "Describe the change or new capability you'd like to see."
       placeholder: "Automatically detect Page<T> and Slice<T> containers without configuration."
+
   - type: textarea
     id: alternatives
     attributes:
       label: "Describe alternatives you've considered"
       description: "Mention any workarounds or similar ideas."
       placeholder: "I've tried extending AutoWrapperSchemaCustomizer manually, but it’s verbose."
+
   - type: textarea
     id: additional
     attributes:

.github/workflows/build.yml

@@ -32,9 +32,18 @@ jobs:
           distribution: "temurin"
           cache: maven
 
-      - name: Build all modules (tests + coverage)
+      # -----------------------------
+      # 🔧 Core modules (publishable)
+      # -----------------------------
+      - name: Build core modules
         run: mvn -B -q -ntp clean verify
 
+      # -----------------------------
+      # 🧪 Samples (tests + coverage)
+      # -----------------------------
+      - name: Build samples (tests + coverage)
+        run: mvn -B -q -ntp -f samples/pom.xml clean verify
+
       # -----------------------------
       # 📦 Generated Client Sources
       # -----------------------------
@@ -58,27 +67,14 @@ jobs:
           retention-days: 7
 
       # -----------------------------
-      # 📊 Coverage - customer-service
-      # -----------------------------
-      - name: Upload coverage (customer-service)
-        uses: codecov/codecov-action@v4
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: |
-            samples/customer-service/target/site/jacoco*/jacoco.xml
-          flags: customer-service
-          name: customer-service
-          fail_ci_if_error: false
-
-      # -----------------------------
-      # 📊 Coverage - customer-service-client
+      # 📊 Coverage (samples only)
       # -----------------------------
-      - name: Upload coverage (customer-service-client)
+      - name: Upload coverage (samples)
         uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: |
-            samples/customer-service-client/target/site/jacoco*/jacoco.xml
-          flags: customer-service-client
-          name: customer-service-client
+            samples/**/target/site/jacoco*/jacoco.xml
+          flags: samples
+          name: samples
           fail_ci_if_error: false

.github/workflows/codeql.yml

@@ -28,11 +28,17 @@ jobs:
         language: [java-kotlin]
 
     steps:
+      # -----------------------------
+      # 📥 Checkout
+      # -----------------------------
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
+      # -----------------------------
+      # ☕ JDK
+      # -----------------------------
       - name: Set up JDK 21
         uses: actions/setup-java@v4
         with:
@@ -49,11 +55,17 @@ jobs:
           languages: ${{ matrix.language }}
 
       # -----------------------------
-      # 🏗 Build (full reactor incl. samples)
+      # 🏗 Build core (publishable modules)
       # -----------------------------
-      - name: Build (Maven reactor)
+      - name: Build core modules
         run: mvn -B -ntp -DskipTests clean package
 
+      # -----------------------------
+      # 🧪 Build samples (runtime coverage)
+      # -----------------------------
+      - name: Build samples
+        run: mvn -B -ntp -DskipTests -f samples/pom.xml clean package
+
       # -----------------------------
       # 🔎 Analyze
       # -----------------------------