# Quick Start Guide

## Access the Live System

Open your browser → [**iris.brainsait.org**](https://iris.brainsait.org/csp/sys/%25CSP.Portal.Home.zen?$NAMESPACE=BRAINSAIT)

| Field | Value |
|-------|-------|
| **Username** | `_SYSTEM` |
| **Password** | `sys` |
| **Namespace** | `BRAINSAIT` |

## Local Development

```bash
# Clone the repository
git clone https://github.com/Fadil369/brainsait-linc-fhir.git
cd brainsait-linc-fhir

# Start the Docker ecosystem
docker compose -f infra/deployment/docker-compose.yml up -d

# Run startup script (Python services)
bash scripts/startup.sh

# Quick health check
curl http://localhost:58080/health
curl http://localhost:58080/routes
```

## Verify All Services

```bash
# Docker containers (expect 13 all healthy)
docker ps --format "table {{.Names}}\t{{.Status}}"

# Python microservices on host ports
for p in 58773 58080 58081 58082 58083 3000; do
  n=$([ $p = 58773 ] && echo "Supervisor" || [ $p = 58080 ] && echo "Gateway" || [ $p = 58081 ] && echo "Dashboard" || [ $p = 58082 ] && echo "Webhook" || [ $p = 58083 ] && echo "Metrics" || echo "Grafana")
  ss -tlnp | grep -q ":$p " && echo "✅ $n :$p" || echo "❌ $n :$p"
done
```

## API Discovery

```bash
# List all available routes
curl http://localhost:58080/routes | jq .

# FHIR metadata (synthetic CapabilityStatement)
curl http://localhost:58080/fhir/metadata | jq .

# System health
curl http://localhost:58080/health | jq .

# Pulse AI Agents — 19 deployed
curl http://localhost:58080/linc/ | jq .
curl "http://localhost:58080/linc/summary?patient=P-5842&role=doctor" | jq .
curl "http://localhost:58080/linc/readmission-risk?patient=P-5842" | jq .

# Predictive Models — 5 deployed
curl "http://localhost:58080/linc/predict-readmission?patientId=P001" | jq .
curl "http://localhost:58080/linc/predict-interaction?patientId=P005&medications=metformin,lisinopril,warfarin,atorvastatin" | jq .

# HuggingFace Models
curl http://localhost:58080/hf/models | jq .

# Chat AI
curl "http://localhost:58080/hf/chat?q=what+is+normal+blood+sugar" | jq .

# Security Health
curl http://localhost:58080/security/health | jq .
```

## Pulse Agents Quick Test

```bash
# Test all 19 agents
for agent in summary prior-auth gaps-in-care medication-safety care-plan clinical-trials readmission-risk triage imaging-followup lab-explainer nl-query sdoh-referral chat hf-models predict-readmission predict-pa-denial predict-ed-util predict-interaction predict-no-show; do
  STATUS=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:58080/linc/$agent?patientId=P001" 2>/dev/null || echo "FAIL")
  echo "$agent → HTTP $STATUS"
done
```

## NPHIES Pipeline

```bash
# Diagnose the submission pipeline
python3 pipeline/submission_pipeline.py --diagnose

# Dry-run a claim submission
python3 pipeline/submission_pipeline.py --dry-run

# Full submission
python3 pipeline/submission_pipeline.py --phase 1
```

## Local Access Points

| Service | Local URL |
|---------|-----------|
| API Gateway | `http://localhost:58080/` |
| Live Dashboard | `http://localhost:58081/` |
| IRIS Portal | `http://localhost:52773/csp/sys/UtilHome.csp` |
| Grafana | `http://localhost:3000/` |
| Ecosystem Supervisor | `http://localhost:58773/` |
| Webhook Receiver | `http://localhost:58082/` |
| Metrics Exporter | `http://localhost:58083/metrics` |