# Crisis Monitor

Public-safe crisis monitoring system for incident response, CAP alerts, SitRep
workflows, analytics and operator dashboards.

## Primary machine entrypoints

- Manifest: https://crisis.qdev.run/ai.json
- Root OpenAPI schema: https://crisis.qdev.run/openapi.yaml
- OpenAPI schema: https://crisis.qdev.run/api/v1/schema
- API docs: https://crisis.qdev.run/api/v1/docs
- Public CAP summary: https://crisis.qdev.run/api/cap/summary
- Atom feed: https://crisis.qdev.run/api/cap/feed
- RSS feed: https://crisis.qdev.run/api/cap/rss
- Sitemap: https://crisis.qdev.run/sitemap.xml
- Evidence methodology: https://crisis.qdev.run/methodology.json

## Recommended AI access pattern

1. Read this file first.
2. Fetch https://crisis.qdev.run/ai.json for structured endpoint metadata.
3. Fetch https://crisis.qdev.run/api/cap/summary?limit=12 for the cheapest current-state view.
4. Fetch feeds only when item-level public alert data is required.
5. Use authenticated /api/v1/* endpoints only with an explicit API token.

## Platform integrations

- QazStack: portable operational primitives and shared contract boundary.
- QazPipe: normalized event intake before the Crisis relevance gate.
- QazLake: immutable evidence references; restricted raw evidence stays private.
- QazCompute: NLP, embeddings, translation and model provenance.
- QazGeo: GIS catalog, geocoding and operational layers.
- AV DS 4: compact operator interface design system.

## Public endpoints

- GET https://crisis.qdev.run/methodology.json (application/json, auth: public): Verification stages, trust principles and known coverage limitations.
- GET https://crisis.qdev.run/ai.json (application/json, auth: public): Machine-readable site manifest for AI crawlers and agents.
- GET https://crisis.qdev.run/llms.txt (text/plain, auth: public): Short LLM-oriented map of public data, API contracts and crawl rules.
- GET https://crisis.qdev.run/api/cap/summary (application/json, auth: public): Small public-safe incident aggregate. Prefer this before crawling feeds.
- GET https://crisis.qdev.run/api/cap/feed (application/atom+xml, auth: public): Atom feed of recent public CAP alerts.
- GET https://crisis.qdev.run/api/cap/rss (application/rss+xml, auth: public): RSS feed of recent public CAP alerts.
- GET https://crisis.qdev.run/openapi.yaml (application/yaml, auth: public): Root OpenAPI contract alias for crawlers, SDKs and documentation links.
- GET https://crisis.qdev.run/api/v1/schema (application/yaml, auth: public): OpenAPI contract for API clients.
- GET https://crisis.qdev.run/api/v1/docs (text/html, auth: public): Human-readable Swagger UI for the OpenAPI contract.

## Privacy and cost guidance

- Public CAP summary intentionally omits descriptions, coordinates and personal data.
- Respect Cache-Control headers.
- Prefer JSON summary over HTML pages.
- Do not scrape authenticated operator pages.