Tutorial 10: Testing & Deployment¶

Pages: 2

📖 Page 1: Testing¶

Manual Testing Checklist¶

Test each module systematically:

Patient Module:¶

□ Create patient with all fields
□ View patient details
□ Edit patient information
□ Delete patient (with confirmation)
□ Search by name
□ Filter by gender
□ Filter by blood group
□ Filter by status (active/inactive)
□ Filter by age range
□ Sort by name (A-Z, Z-A)
□ Sort by age (youngest, oldest)
□ Pagination (10, 25, 50 per page)
□ Navigate pages (first, prev, next, last)

Practitioner Module:¶

□ CRUD operations
□ Filter by specialty
□ All filters and pagination working

Organization Module:¶

□ CRUD operations
□ Filter by type
□ All features working

Appointment Module:¶

□ Create with patient + practitioner selection
□ DateTime picker working
□ Status changes
□ View appointments
□ Filter by date range
□ Filter by status

Audit Trail:¶

□ All actions logged (C, R, U, D)
□ Filter by action type
□ Filter by resource type
□ Timestamps correct

End-to-End Test Scenario¶

Complete workflow:

Create 3 practitioners (different specialties)
Create 1 organization (Hospital)
Create 10 patients (varied ages, genders, blood groups)
Create 5 appointments (different patients/practitioners)
Update 2 patients
Delete 1 patient
Check audit trail (should show all actions)
Test all filters on each module
Test pagination with different page sizes
Test search functionality

Expected: Everything works smoothly!

📖 Page 2: Production Deployment¶

Build JAR File¶

# Clean and build
mvn clean package

# JAR file created in target/
ls -lh target/fhir-pms-1.0.0.jar

Run in Production¶

Option 1: Direct JAR

# Run with production settings
java -jar target/fhir-pms-1.0.0.jar \
  --server.port=80 \
  --spring.thymeleaf.cache=true \
  --logging.level.com.healthcare.pms=INFO

Option 2: With Environment Variables

# Set environment variables
export SERVER_PORT=80
export FHIR_SERVER_URL=https://hapi.fhir.org/baseR4
export THYMELEAF_CACHE=true

# Run
java -jar target/fhir-pms-1.0.0.jar

Option 3: Systemd Service (Linux)

Create /etc/systemd/system/fhir-pms.service:

[Unit]
Description=FHIR Patient Management System
After=network.target

[Service]
Type=simple
User=fhirapp
WorkingDirectory=/opt/fhir-pms
ExecStart=/usr/bin/java -jar /opt/fhir-pms/fhir-pms-1.0.0.jar
Restart=always
RestartSec=10
Environment="SERVER_PORT=80"
Environment="FHIR_SERVER_URL=https://hapi.fhir.org/baseR4"

[Install]
WantedBy=multi-user.target

Enable and start:

sudo systemctl enable fhir-pms
sudo systemctl start fhir-pms
sudo systemctl status fhir-pms

Docker Deployment¶

Create Dockerfile:

FROM eclipse-temurin:17-jre
WORKDIR /app
COPY target/fhir-pms-1.0.0.jar app.jar
EXPOSE 8081
ENTRYPOINT ["java", "-jar", "app.jar"]

Build and run:

# Build image
docker build -t fhir-pms:1.0 .

# Run container
docker run -d \
  -p 8081:8081 \
  -e FHIR_SERVER_URL=https://hapi.fhir.org/baseR4 \
  --name fhir-pms \
  fhir-pms:1.0

# Check logs
docker logs -f fhir-pms

Production Configuration¶

Create application-prod.properties:

# Server
server.port=80
server.compression.enabled=true

# FHIR
fhir.server.base-url=${FHIR_SERVER_URL:https://hapi.fhir.org/baseR4}

# Thymeleaf - ENABLE CACHE
spring.thymeleaf.cache=true

# Logging - PRODUCTION LEVEL
logging.level.root=WARN
logging.level.com.healthcare.pms=INFO

# Error handling
server.error.include-message=never
server.error.include-binding-errors=never
server.error.include-stacktrace=never

Run with profile:

java -jar fhir-pms-1.0.0.jar --spring.profiles.active=prod

Troubleshooting¶

Problem: Port 80 requires sudo

# Option 1: Use port 8081 and reverse proxy (nginx)
# Option 2: Give java permission
sudo setcap CAP_NET_BIND_SERVICE=+eip /usr/bin/java

Problem: Out of memory

# Increase heap size
java -Xmx512m -jar fhir-pms-1.0.0.jar

Problem: FHIR server timeout

# In application.properties, increase timeout
fhir.client.connection-timeout=30000
fhir.client.socket-timeout=30000

Problem: Logs filling disk

# Add log rotation in application-prod.properties
logging.file.name=/var/log/fhir-pms/application.log
logging.file.max-size=10MB
logging.file.max-history=30

Security Checklist¶

□ Change default ports
□ Enable HTTPS (use Let's Encrypt + nginx)
□ Add authentication (Spring Security)
□ Enable CORS only for trusted domains
□ Disable debug endpoints
□ Set secure headers
□ Regular dependency updates (mvn versions:display-dependency-updates)
□ Environment variables for secrets (not in code)
□ Firewall rules (allow only necessary ports)
□ Regular backups of FHIR data

Monitoring¶

Add health endpoint in Application.java:

@RestController
public class HealthController {

    @GetMapping("/health")
    public Map<String, String> health() {
        Map<String, String> response = new HashMap<>();
        response.put("status", "UP");
        response.put("timestamp", LocalDateTime.now().toString());
        return response;
    }
}

Check health:

curl http://localhost:8081/health

✅ Deployment Complete!¶

Tested all features manually
Built production JAR
Multiple deployment options (JAR, Docker, Systemd)
Production configuration ready
Security checklist reviewed
Health monitoring added
Troubleshooting guide complete

🎉 CONGRATULATIONS!¶

You built a complete FHIR Patient Management System!

What you created: - ✅ 4 FHIR modules (Patient, Practitioner, Organization, Appointment) - ✅ Complete CRUD operations - ✅ Advanced filters (6+ per module) - ✅ Sorting (name, age, etc.) - ✅ Pagination (with page size selector) - ✅ Professional UI (Bootstrap) - ✅ Audit trail (compliance ready) - ✅ Production ready deployment

Skills gained: - Spring Boot application development - FHIR R4 implementation - HAPI FHIR Client usage - REST API design - Thymeleaf templating - Production deployment - Healthcare IT basics