Skip to main content

🚀 Quick Reference Card - Databricks App

Development Commands​

# Backend only (hot reload)
make dev

# Frontend only (hot reload)
make dev-frontend

# Both together
make dev-full

# Production build + run
make run

# Deploy to Databricks
make deploy-databricks

URLs​

EnvironmentBackendFrontendType
Development:8000:3000Separate
Production:8000:8000Combined
Databricks[your-workspace]/apps/oral-health-policy-pulseSameCombined

File Structure​

frontend/src/
  pages/
    Dashboard.tsx      # /
    Heatmap.tsx        # /heatmap
    Documents.tsx      # /documents
    Opportunities.tsx  # /opportunities
    Settings.tsx       # /settings
  components/
    Layout.tsx         # Sidebar + nav

api/
  app.py              # FastAPI (NEW)
  main.py             # Legacy CLI
  static/             # Built React

scripts/
  deploy-databricks-app.sh
  setup-local.sh
  test-app.py

API Endpoints​

GET  /api/health
GET  /api/dashboard
GET  /api/opportunities?state=CA&topic=fluoride
GET  /api/documents?search=dental&page=1
POST /api/workflow/start
POST /api/advocacy/email/{id}
GET  /api/settings
PUT  /api/settings
GET  /api/agents/status

Common Tasks​

Add New Page​

  1. Create frontend/src/pages/NewPage.tsx
  2. Add route in frontend/src/App.tsx
  3. Add nav item in frontend/src/components/Layout.tsx

Add API Endpoint​

  1. Add route in api/app.py
  2. Add query in pipeline/delta_lake_queries.py
  3. Call from frontend with axios.get('/api/...')

Deploy Changes​

cd frontend && npm run build && cd ..
./scripts/deploy-databricks-app.sh

Troubleshooting​

IssueSolution
"Frontend not built"cd frontend && npm run build
"Module not found"source venv/bin/activate
Backend not respondingCheck port 8000 is free
Frontend proxy errorEnsure backend running on :8000

Environment Variables​

export DATABRICKS_HOST=https://...
export DATABRICKS_TOKEN=dapi...
export OPENAI_API_KEY=sk-...

Cost Estimate​

ComponentCost/hourCost/month
Databricks App$0.10-0.30$75-225
Model Serving$0.10-0.50$75-375
Delta Lake-$25-100
Total$0.20-0.80$150-700

With scale-to-zero, costs drop to near $0 when idle

Keep this card handy! 📌