# Reference

## Evidence labels

| Label                | Definition                       |
| -------------------- | -------------------------------- |
| predicted            | Future-oriented forecast         |
| radar-derived        | Evidence derived from radar data |
| modeled              | Algorithm-produced conclusion    |
| report-observed      | External reported observation    |
| field-confirmed      | Authorized field observation     |
| human-reviewed       | Qualified human review completed |
| third-party-verified | Approved external verification   |

## Source catalog

Each source catalog record includes:

```txt
slug
name
owner
source type
URL
license
products
cadence
geography
expected latency
retention
parser version
enabled
health
```

Initial source categories include:

| Source            | Purpose                                                     |
| ----------------- | ----------------------------------------------------------- |
| NOAA MRMS         | Primary radar-derived hail intelligence                     |
| NWS Alerts        | Watches, warnings, advisories, and related products         |
| SPC               | Convective forecasts and preliminary severe-weather reports |
| NEXRAD            | Radar-level detail, research, and historical support        |
| NCEI Storm Events | Historical reconciliation                                   |
| Census TIGER/Line | Public geographic boundaries                                |
| Property provider | Licensed property intelligence; provider not selected       |
| Contact provider  | Licensed contact enrichment; provider not selected          |

## Algorithm catalog

Every production algorithm records:

```txt
id
name
version
status
input contract
output contract
released at
retired at
owner
change notes
fixture set
```

Potential algorithms include event detection and correlation, boundary derivation, confidence, property exposure, damage likelihood, opportunity, eligibility, action planning, and attribution.

## Permission catalog

Suggested permission groups include:

```txt
storm.*
weather.*
property.*
monitor.*
alert.*
field.*
crm.*
campaign.*
report.*
integration.*
admin.*
```

The product enumerates permissions instead of hiding them in ad hoc role checks.

## Event catalog

Each domain event defines its name, version, producer, consumer expectations, payload, ordering assumptions, idempotency, retention, and personally identifiable information classification.

## Limits

The reference eventually documents API rate, export, map result, file size, report, campaign, monitoring, retention, and provider-specific limits.

StormTrust does not publish a limit until implementation or an upstream dependency makes it real.

## Glossary

### CAP

Common Alerting Protocol.

### D1

Cloudflare serverless SQL database proposed for relational StormTrust state.

### Evidence

Normalized information that supports a conclusion.

### HCA

Hydrometeor Classification Algorithm.

### MRMS

Multi-Radar/Multi-Sensor System.

### MESH

Maximum Estimated Size of Hail.

### NCEI

National Centers for Environmental Information.

### NEXRAD

Next Generation Weather Radar.

### NOAA

National Oceanic and Atmospheric Administration.

### NWS

National Weather Service.

### POSH

Probability of Severe Hail.

### Provenance

Information describing data origin and transformation history.

### R2

Cloudflare object storage proposed for large unstructured StormTrust objects.

### RALA

Reflectivity at Lowest Altitude.

### Revision

A versioned representation of evolving StormTrust understanding.

### SHI

Severe Hail Index.

### SPC

Storm Prediction Center.

### Swath

A geographic accumulation of a weather signal through time.