release: v0.1.0 static dispatching MVP

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,17 +1,19 @@
 ---
-name: Bug Report
+name: 🐛 Bug Report
 about: Create a report to help us improve
-title: "bug:"
+title: "[BUG]:"
 labels: bug
-assignees: ''
 ---
 
-### Describe the bug
+### 🚨Describe the bug 
 _A clear and concise description of what the bug is._
 
-### Steps to Reproduce
+### 🛠 Steps to Reproduce
 1. Send POST to `/api/v1/forklifts` with...
 2. See error...
 
+### Screenshots
+_If applicable, add screenshots to help explain your problem._
+
 ### Expected Behavior
 _What should have happened?_

.github/ISSUE_TEMPLATE/ci_cd.md

@@ -1,7 +1,7 @@
 ---
 name: "🚀 Infrastructure & CI/CD"
 about: Setup automation, Docker configurations, or deployment pipelines.
-title: "[DEVOPS]: "
+title: "[DEVOPS]:"
 labels: devops, automation
 ---
 
@@ -17,5 +17,4 @@ Describe why this infrastructure change is needed (e.g., "The build process is m
 - [ ] No secrets are exposed in the repository.
 - [ ] [Optional] Deployment to environment is successful.
 
-### 📚 Resources
-Link to documentation (e.g., GitHub Actions, Docker Hub).
+

.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,27 @@
+---
+name: 📚 Documentation
+about: Improve README, ARCHITECTURE, CONTRIBUTING, or code comments
+title: "[DOCS]:"
+labels: documentation
+---
+
+### 📍 What's Missing or Unclear?
+_Describe what documentation is outdated, missing, or confusing._
+
+Example:
+- The "Quick Start" guide doesn't explain how to run integration tests.
+- ARCHITECTURE.md lacks explanation of the planning domain.
+- Method `buildCurrentState()` needs better JavaDoc.
+
+### 📝 Suggested Content
+_What should the documentation explain or clarify?_
+
+### 📂 Location
+_Which file(s) need updating?_
+- [ ] README.md
+- [ ] ARCHITECTURE.md
+- [ ] CONTRIBUTING.md
+- [ ] JavaDoc / Code Comments
+- [ ] Other: _____
+
+

.github/ISSUE_TEMPLATE/feature.md

@@ -1,7 +1,7 @@
 ---
-name: Feature Request
+name: ✨ Feature
 about: Create a new feature or Epic for the warehouse engine
-title: "feat: "
+title: "[FEAT]:"
 labels: enhancement
 assignees: ''
 ---

.github/ISSUE_TEMPLATE/idea.md

@@ -8,7 +8,7 @@ labels: spike, enhancement
 ### 🌟 The "Big Picture"
 What is the core idea? (e.g., "Implement a 'What-If' mode to simulate warehouse layout changes").
 
-### 🚀 Business / User Value
+### 🚀 Added Value
 Why is this worth building? How does it make the Warehouse Dispatcher better or more "Senior"?
 
 ### 🛠 Potential Implementation

.github/ISSUE_TEMPLATE/logic_fix.md

@@ -1,7 +1,7 @@
 ---
-name: Logic or Optimization Refactor
+name: 🔨 Logic Fix
 about: Fix mathematical errors or improve solver efficiency
-title: "logic:"
+title: "[LOGIC]:"
 labels: solver, math
 assignees: ''
 ---

.github/ISSUE_TEMPLATE/research_spike.md

@@ -1,7 +1,7 @@
 ---
 name: "🔬 Research / Spike"
 about: Investigate a new technology or approach before implementation.
-title: "[SPIKE]: "
+title: "[SPIKE]:"
 labels: research, documentation
 ---
 

.github/ISSUE_TEMPLATE/tech_debt.md

@@ -1,7 +1,7 @@
 ---
-name: Technical Debt
+name: 🧹 Technical Debt
 about: Clean up code, improve performance, or update dependencies
-title: "refactor: "
+title: "[REFACTOR]:"
 labels: tech-debt
 ---
 ### The Debt

.github/workflows/ci.yml

@@ -0,0 +1,241 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches: [develop, main, 'devops/**', 'docs/**']
+  pull_request:
+    branches: [develop, main]
+
+permissions:
+  contents: write
+
+jobs:
+  quality:
+    name: Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Source Code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Execute Test Suite with Maven
+        run: |
+          # Checkstyle is intentionally disabled for the v0.1.0 release.
+          # It will be reintroduced as a proper quality gate in Milestone 2.
+          #
+          # Previous temporary setup:
+          # mvn clean package -Dspotless.check.skip=false -Dcheckstyle.failOnViolation=false
+
+          mvn clean package \
+            -Dspotless.check.skip=false
+        timeout-minutes: 15
+
+      - name: Evaluate Build Status
+        id: build-status
+        if: always()
+        run: |
+          if [ "${{ job.status }}" = "success" ]; then
+            echo "build_status=passing" >> $GITHUB_OUTPUT
+            echo "build_color=brightgreen" >> $GITHUB_OUTPUT
+          else
+            echo "build_status=failing" >> $GITHUB_OUTPUT
+            echo "build_color=red" >> $GITHUB_OUTPUT
+          fi
+
+      # deactivation the javadoc badge for v0.1.0
+      #- name: Calculate Service Javadoc Coverage
+       # id: calc-doc-coverage
+        #if: always()
+        #run: python scripts/ci/javadoc_coverage.py
+
+      - name: Calculate JaCoCo Test Coverage
+        id: jacoco-coverage
+        if: always()
+        run: python scripts/ci/jacoco_coverage.py
+
+      # - name: Generate Dynamic Doc Badge
+      #   uses: schneegans/dynamic-badges-action@v1.7.0
+      #   if: always()
+      #   with:
+      #     auth: ${{ secrets.GIST_SECRET }}
+      #     gistID: 27dc15f2c2aeef4b021fdff63d7ba722
+      #     filename: lift-nexus-docs.json
+      #     label: doc coverage
+      #     message: "${{ steps.calc-doc-coverage.outputs.doc_percentage || '0' }}%"
+      #     color: ${{ steps.calc-doc-coverage.outputs.doc_color || 'red' }}
+
+      - name: Generate Dynamic Test Coverage Badge
+        uses: schneegans/dynamic-badges-action@v1.7.0
+        if: always()
+        with:
+          auth: ${{ secrets.GIST_SECRET }}
+          gistID: 27dc15f2c2aeef4b021fdff63d7ba722
+          filename: lift-nexus-coverage.json
+          label: test coverage
+          message: "${{ steps.jacoco-coverage.outputs.test_percentage || '0' }}%"
+          color: ${{ steps.jacoco-coverage.outputs.test_color || 'red' }}
+
+      - name: Prepare Quality Artifacts
+        if: always()
+        run: |
+          mkdir -p ci-artifacts/quality/target/site
+
+
+          if [ -f target/openapi.json ]; then
+            cp target/openapi.json ci-artifacts/quality/target/openapi.json
+          fi
+
+          if [ -d target/site/jacoco ]; then
+            cp -r target/site/jacoco ci-artifacts/quality/target/site/jacoco
+          fi
+
+
+
+      - name: Upload Quality Artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: quality-artifacts
+          path: ci-artifacts/quality/
+          if-no-files-found: warn
+          retention-days: 7
+
+      - name: Upload Production Build Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: warehouse-dispatcher-build-assets
+          path: |
+            target/*.jar
+            target/openapi.json
+          retention-days: 7
+
+  documentation:
+    name: Documentation
+    runs-on: ubuntu-latest
+    needs: quality
+
+    steps:
+      - name: Checkout Source Code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          cache: 'maven'
+
+      - name: Set up Python for MkDocs
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+          cache-dependency-path: docs/requirements-docs.txt
+
+      - name: Install MkDocs Dependencies
+        run: pip install -r docs/requirements-docs.txt
+
+      - name: Build MkDocs Documentation
+        run: mkdocs build
+
+      - name: Generate Javadoc
+        run: |
+          mvn javadoc:javadoc \
+            -Dquiet=true \
+            -Ddoclint=none \
+            -Dcheckstyle.skip=true \
+            -Dmaven.checkstyle.skip=true \
+            -Dspotless.check.skip=true
+
+          test -f target/reports/apidocs/index.html
+
+      - name: Prepare Documentation Artifacts
+        run: |
+          mkdir -p ci-artifacts/docs/build
+          mkdir -p ci-artifacts/docs/target/reports
+
+          cp -r build/site ci-artifacts/docs/build/site
+          cp -r target/reports/apidocs ci-artifacts/docs/target/reports/apidocs
+
+      - name: Upload Documentation Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-artifacts
+          path: ci-artifacts/docs/
+          if-no-files-found: error
+          retention-days: 7
+
+  deploy:
+    name: Deploy GitHub Pages
+    runs-on: ubuntu-latest
+    needs: [quality, documentation]
+    if:  (
+      github.ref == 'refs/heads/main' ||
+      github.ref == 'refs/heads/develop' ||
+      startsWith(github.ref, 'refs/heads/devops/') ||
+      startsWith(github.ref, 'refs/heads/docs/') )
+
+    steps:
+      - name: Checkout Source Code
+        uses: actions/checkout@v4
+
+      - name: Download Quality Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: quality-artifacts
+          path: .
+
+      - name: Download Documentation Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: documentation-artifacts
+          path: .
+
+      - name: Debug Downloaded Artifacts
+        run: find . -maxdepth 5 -type d | sort
+
+      - name: Prepare GitHub Pages
+        run: bash scripts/ci/prepare_pages.sh
+
+      - name: Deploy main to root
+        if: github.ref == 'refs/heads/main'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./gh-pages
+          publish_branch: gh-pages
+          cname: lift-nexus.amine-bahij.dev
+          keep_files: true
+
+      - name: Deploy develop preview to /dev-branch
+        if: github.ref == 'refs/heads/develop'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./gh-pages
+          publish_branch: gh-pages
+          destination_dir: dev
+          keep_files: true
+
+      - name: Deploy devops preview to /preview
+        if: (startsWith(github.ref, 'refs/heads/devops/') || 
+                    startsWith(github.ref, 'refs/heads/docs/'))
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./gh-pages
+          publish_branch: gh-pages
+          destination_dir: preview
+          keep_files: true