koala73 / koala73/worldmonitor

feat(weather): add official IMD district warnings and nowcasts

Open
#7,004 0 comments 0 reactions 0 assignees View on GitHub
agent-readiness area: feeds area:seeders feature
Dominant language
TypeScript
Stars
86.6k
Forks
13.1k
Avg merge
8h 4m
Merged PRs (30d)
825

Description

## What to build\n\nAdd an end-to-end India weather-alert slice from the official India Meteorological Department API reference at https://api.imd.gov.in/public/api_reference.html, starting with district warnings, district nowcasts, and station nowcasts.\n\nThe result must preserve issued-warning semantics. It must not convert ordinary forecast thresholds into alerts or present stale or unavailable IMD coverage as an all-clear state.\n\n## Acceptance criteria\n\n- [ ] The selected IMD endpoints, content types, access requirements, rate limits, update cadence, redirect behavior, response bounds, and stable identifiers are qualified before activation.\n- [ ] Redistribution, public-display, retention, and attribution rights are recorded. The integration remains disabled if those rights are not confirmed.\n- [ ] District warnings, district nowcasts, and station nowcasts normalize into the existing warning model without discarding issue time, validity, category, color or severity, message, district, state, and station provenance.\n- [ ] IMD-issued warnings remain distinguishable from derived forecasts and from NDMA SACHET relays.\n- [ ] Stable deduplication reconciles the same warning observed directly from IMD and through SACHET while retaining both provenance paths.\n- [ ] Source-specific failure or an empty response cannot erase other authorities or falsely report no warning.\n- [ ] The relevant dashboard surface provides India coverage, official attribution, original-source links, and an honest unavailable or stale state.\n- [ ] Health and seed metadata expose fetch freshness, content freshness, record count, coverage state, and last-known-good behavior.\n- [ ] Attribution, data-source documentation, generated catalog output, and focused endpoint, parsing, severity, deduplication, freshness, and degradation tests are included.\n\n## Blocked by\n\n- None — can start immediately.

Contributor guide

Open the contributing guide

Research direction

Start with the official IMD API reference, then inspect the existing warning model, NDMA SACHET integration, dashboard surface, health and seed metadata, and generated catalog output. Define the endpoint and rights qualification before activation, then cover normalization, provenance, deduplication, freshness, degradation, attribution, and focused endpoint and parsing tests; done means honest India coverage without treating unavailable data as an all-clear.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend-api-design, data, frontend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.