Swagger json Automation

.github/workflows/swagger-json.yml

@@ -0,0 +1,107 @@
+name: Sync Swagger to AMRIT-Docs
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  swagger-sync:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Checkout API repo
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+          cache: maven
+
+      - name: Build API (skip tests)
+        run: mvn -B clean package -DskipTests
+
+      - name: Install jq
+        run: sudo apt-get update && sudo apt-get install -y jq
+
+      - name: Run API in swagger profile
+        run: |
+          nohup java -jar target/hwc-api-*.war \
+            --spring.profiles.active=swagger \
+            --server.port=9090 \
+            > app.log 2>&1 &
+          echo $! > api_pid.txt
+
+      - name: Wait for API & fetch Swagger
+        run: |
+          for i in {1..40}; do
+            CODE=$(curl --connect-timeout 2 --max-time 5 -s -o swagger_raw.json -w "%{http_code}" http://localhost:9090/v3/api-docs || true)
+
+            if [ "$CODE" = "200" ]; then
+              jq . swagger_raw.json > hwc-api.json || {
+                echo "Swagger JSON invalid"
+                cat swagger_raw.json
+                exit 1
+              }
+
+              if [ "$(jq '.paths | length' hwc-api.json)" -eq 0 ]; then
+                echo "Swagger paths empty – failing"
+                exit 1
+              fi
+
+              echo "Swagger generated successfully"
+              exit 0
+            fi
+
+            echo "Waiting for API... ($i)"
+            sleep 4
+          done
+
+          echo "Swagger not generated"
+          cat app.log || true
+          exit 1
+
+      - name: Stop API
+        if: always()
+        run: |
+          # Graceful shutdown of the process group
+          sleep 5
+          # Force kill the process group if still running
+          if [ -f api_pid.txt ]; then
+              PID=$(cat api_pid.txt)
+              kill -TERM -- -"$PID" 2>/dev/null || true
+              sleep 2
+              kill -9 -- -"$PID" 2>/dev/null || true
+            fi
+            # Fallback: kill any remaining java process on port 9090
+            fuser -k 9090/tcp 2>/dev/null || true
+
+      - name: Checkout AMRIT-Docs
+        uses: actions/checkout@v4
+        with:
+          repository: PSMRI/AMRIT-Docs
+          token: ${{ secrets.DOCS_REPO_TOKEN }}
+          path: amrit-docs
+          fetch-depth: 0
+
+      - name: Copy Swagger JSON
+        run: |
+          mkdir -p amrit-docs/docs/swagger
+          cp hwc-api.json amrit-docs/docs/swagger/hwc-api.json
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v8
+        with:
+          token: ${{ secrets.DOCS_REPO_TOKEN }}
+          path: amrit-docs
+          branch: auto/swagger-update-${{ github.run_id }}-${{ github.run_attempt }}
+          base: main
+          commit-message: "chore(docs): auto-update HWC-API swagger"
+          title: "chore(docs): auto-update HWC-API swagger"
+          delete-branch: true
+          body: |
+            This PR automatically updates HWC-API Swagger JSON
+            from the latest main branch build.

README.md

@@ -1,5 +1,6 @@
 # Health and Wellness Centre (HWC) API Module 
-[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)  ![branch parameter](https://github.com/PSMRI/HWC-API/actions/workflows/sast-and-package.yml/badge.svg)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)  [![DeepWiki](https://img.shields.io/badge/DeepWiki-PSMRI%2FHWC--API-blue)](https://deepwiki.com/PSMRI/HWC-API)
+
 
 Health and Wellness centre (HWC) is one of the comprehensive applications of AMRIT designed to capture details of 7 Service packages as per guidelines which should be available at Health and Wellness centre.
 

pom.xml

@@ -297,6 +297,11 @@
 			<version>0.12.6</version>
 			<scope>runtime</scope>
 		</dependency>
+		<dependency>
+			<groupId>com.h2database</groupId>
+			<artifactId>h2</artifactId>
+			<scope>runtime</scope>
+		</dependency>
 	</dependencies>
 
 

src/main/resources/application-swagger.properties

@@ -0,0 +1,61 @@
+registrationUrl=http://localhost:8080/registration
+syncSearchByLocation=http://localhost:8080/syncSearchByLocation
+getBenCountToSync=10
+snomedCTPageSize=100
+tcSpecialistSlotCancel=cancel
+sendSMSUrl=http://localhost:8080/sendSMS
+schedule=schedule
+prescription=prescription
+cancel=cancel
+reSchedule=reSchedule
+servicePointID=1
+parkingPlaceID=1
+providerServiceMapID=1
+vanID=1
+serviceID=1
+providerID=1
+appId=1
+authKey=${AUTH_KEY:default-auth-key}
+authSecret=${AUTH_SECRET:default-auth-secret}
+scheduling-slotsize=15
+registrarQuickSearchByIdUrl=http://localhost:8080/registrarQuickSearchById
+registrarQuickSearchByPhoneNoUrl=http://localhost:8080/registrarQuickSearchByPhoneNo
+beneficiaryEditUrl=http://localhost:8080/beneficiaryEdit
+registrarAdvanceSearchUrl=http://localhost:8080/registrarAdvanceSearch
+foetalMonitorFilePath=/tmp/foetalmonitor
+foetalMonitorAPIKey=${FOETAL_MONITOR_API_KEY:default-api-key}
+tcSpecialistSlotBook=book
+docWL=7
+tcSpeclistWL=7
+labWL=7
+radioWL=7
+oncoWL=7
+TMReferredWL=7
+dataSyncDownloadUrl=http://localhost:8080/dataSyncDownload
+dataSyncUploadUrl=http://localhost:8080/dataSyncUpload
+getBenImageFromIdentity=http://localhost:8080/getBenImageFromIdentity
+carestreamOrderCreateURL=http://localhost:8080/carestreamOrderCreate
+saveCovidVaccineDetailsURL=http://localhost:8080/saveCovidVaccineDetails
+# Default for pharmaWL to prevent bean creation errors in swagger profile
+pharmaWL=7
+# Default for nurseTCWL to prevent bean creation errors in swagger profile
+nurseTCWL=7
+# Default for openkmDocUrl to prevent bean creation errors in swagger profile
+openkmDocUrl=http://localhost:8080/openkm/mock
+# Default for nurseWL to prevent bean creation errors in swagger profile
+nurseWL=7
+spring.datasource.url=jdbc:h2:mem:swaggerdb
+spring.datasource.driver-class-name=org.h2.Driver
+spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
+spring.jpa.hibernate.ddl-auto=create-drop
+
+# Disable Redis if not needed for docs (optional)
+spring.redis.host=localhost
+spring.redis.port=6379
+# CORS for Swagger UI
+cors.allowed-origins=${CORS_ALLOWED_ORIGINS:http://localhost:9090,http://localhost:8080}
+
+jwt.secret=${JWT_SECRET_KEY:default-swagger-secret-change-me}
+# Logging
+logging.level.root=INFO
+