diff --git a/.github/workflows/swagger-json.yml b/.github/workflows/swagger-json.yml
new file mode 100644
index 00000000..e185562c
--- /dev/null
+++ b/.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.
diff --git a/README.md b/README.md
index 131ec045..c134d8d9 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
# Health and Wellness Centre (HWC) API Module
-[](https://www.gnu.org/licenses/gpl-3.0) 
+[](https://www.gnu.org/licenses/gpl-3.0) [](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.
diff --git a/pom.xml b/pom.xml
index 1bdf705e..8a0ed27b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -297,6 +297,11 @@
0.12.6
runtime
+
+ com.h2database
+ h2
+ runtime
+
diff --git a/src/main/resources/application-swagger.properties b/src/main/resources/application-swagger.properties
new file mode 100644
index 00000000..7c5c61de
--- /dev/null
+++ b/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
+