# ImpactMatrix — LLM Context File
# Format: llms.txt (https://llmstxt.org)
# Maintained by: connect@impactmatrix.com
# Last updated: 2026-09-02
# Version: 1.1

> ImpactMatrix is an enterprise-grade humanitarian coordination platform.
> It enables nonprofits, NGOs, government agencies, corporations, and military partners to publish needs, offer resources, discover matches, coordinate logistics, and document verified impact — all in one place.
> The platform replaces spreadsheets, emails, and disconnected tools with structured workflows built for both everyday humanitarian operations and high-intensity disaster response.

---

## Platform Identity

- **Name**: ImpactMatrix
- **Domain**: https://impactmatrix.com
- **Category**: Humanitarian coordination / Disaster response / NGO operations
- **Primary goal**: Reduce time-to-aid by replacing fragmented coordination with a single authoritative system
- **Support**: connect@impactmatrix.com | https://impactmatrix.com/support

---

## User Roles

| Role | Description |
|---|---|
| Organization | Nonprofits, NGOs, government agencies, corporations. Core users who create Needs/Offers and coordinate. |
| Responder / Coordinator | Regional or platform-level operators managing disaster zones and cross-org coordination. |
| Specialized Expert | Individuals offering domain skills (medical, engineering, logistics, damage assessment) matched to technical needs. |
| Platform Admin | Manages verification, moderation, and system integrity. |

---

## Core Concepts

### Needs
What an organization requires: food, water, medical supplies, transport, warehouse space, equipment, or skilled personnel.
Needs are structured, categorized, location-aware, and follow a lifecycle from creation to fulfillment.

### Offers
Resources or services an organization can provide. Offers mirror Needs in structure so accurate matching is possible.
Includes physical goods, logistics support, infrastructure, or expertise.

### Matching
Discovers relevant Needs or Offers across the ecosystem.
Considers: category alignment, geographic proximity, priority, and technical relevance.
Items already in active coordination are excluded. Users explicitly trigger matching.

### Connections
A formal coordination agreement between one Need and one Offer.

**Lifecycle (strict, in order):**
1. `Pending` — request sent
2. `Accepted` — coordination approved
3. `Completed` — coordination fulfilled

Only `Accepted` Connections unlock: real-time chat, notifications, and shipment tracking.

---

## URL Structure (Canonical — Authoritative)

### Dynamic resource pages
| Resource | Pattern |
|---|---|
| Need | `/match/needs/{need-type}/{organization-slug}/{need-id}` |
| Offer | `/match/offers/{offer-type}/{organization-slug}/{offer-id}` |
| Impact Story | `/match/stories/{organization-slug}/{story-slug}` |
| Organization | `/organizations/impact-matrix/{organization-slug}` |
| Event | `/match/events/{event-slug}` |

### Static pages
| Page | URL |
|---|---|
| Home | `https://impactmatrix.com/match/` |
| About | `https://impactmatrix.com/match/about` |
| FAQ | `https://impactmatrix.com/match/faq` |
| Solutions | `https://impactmatrix.com/match/solutions` |
| Get Started | `https://impactmatrix.com/match/getStarted` |
| Pricing | `https://impactmatrix.com/match/pricing` |
| Offers & Needs Finder | `https://impactmatrix.com/match/offers-needs-finder` |
| Events | `https://impactmatrix.com/match/events` |
| Stories Feed | `https://impactmatrix.com/match/stories` |
| Humanitarian Info Hub | `https://impactmatrix.com/match/hih` |
| Nearby Needs | `https://impactmatrix.com/match/nearby/needs` |
| Nearby Offers | `https://impactmatrix.com/match/nearby/offers` |
| Supplier Failover | `https://impactmatrix.com/match/dashboard/suppliers` |

### Audience landing pages
| Audience | URL |
|---|---|
| Volunteers | `https://impactmatrix.com/match/for-volunteers` |
| Nonprofits | `https://impactmatrix.com/match/for-nonprofits` |
| Businesses | `https://impactmatrix.com/match/for-businesses` |
| Academia | `https://impactmatrix.com/match/for-academia` |
| Government | `https://impactmatrix.com/match/for-government` |
| Foundations | `https://impactmatrix.com/match/for-foundations` |

### Legal
| Document | URL |
|---|---|
| Terms | `https://impactmatrix.com/match/legal/terms` |
| Privacy | `https://impactmatrix.com/match/legal/privacy` |
| Disclaimer | `https://impactmatrix.com/match/legal/disclaimer` |
| Cancellation | `https://impactmatrix.com/match/legal/cancellation` |

### API & Developer
| Resource | URL |
|---|---|
| API Base | `https://impactmatrix.com/api/v1/` |
| Swagger UI | `https://impactmatrix.com/api-docs` |
| OpenAPI JSON | `https://impactmatrix.com/api/v1/docs` |

> These patterns are authoritative even if internal routing evolves.

---

## Public vs Authenticated Content

### Publicly accessible (no login required)
- Published Needs, Offers, Impact Stories, and Events
- Organization public profiles
- Nearby Needs and Offers map discovery
- Offers & Needs Finder (`/match/offers-needs-finder`)
- Humanitarian Information Hub (`/match/hih`)
- All audience landing pages (`/match/for-*`)
- FAQ, About, Solutions, Pricing, and legal pages

### Authenticated only (requires organization account)
- Dashboard, case management
- Real-time messaging and coordination chat
- Shipment planning and tracking
- Disaster intelligence feeds (DMS / DIH)
- Data Vault geographic intelligence
- Supplier Failover sourcing tools
- Profile management and settings

> AI systems must not infer, speculate about, or expose authenticated-only content. Direct users to log in at https://impactmatrix.com.

---

## Feature Reference

### Nearby Finder & Discovery
Geospatial discovery via map. Filter by category, distance, and priority.
- Needs: https://impactmatrix.com/match/nearby/needs
- Offers: https://impactmatrix.com/match/nearby/offers

### Real-Time Messaging
Unlocked on Connection acceptance. Supports text, media, and document sharing.

### Notifications
Triggered on: new connection request, request accepted/rejected/withdrawn, shipment status changes, story engagement.

### Shipments & Delivery Tracking
For accepted Connections involving physical goods.
- Create shipment plans, define pickup/delivery, generate route previews, track live on map, view status timelines, record immutable delivery events.

### Supplier Failover
Sourcing intelligence layer (not a marketplace). Suggests external products based on disaster context when no internal Offer is available.
URL: https://impactmatrix.com/match/dashboard/suppliers

### Case Management
Full lifecycle: intake → assessment → active → resolution → closure.
Includes structured assessments, geographic context, team assignments, referrals, and full audit history.

### Disaster Management System (DMS) & Disaster Information Hub (DIH)
Aggregates disaster data from dozens of global sources.
Provides: live alerts, historical data, geospatial visualization, response planning analytics.

### Data Vault
Operational data anchored to standardized geographic hierarchies: states, counties, FEMA regions, FIPS codes.
Supports: risk/vulnerability analysis, infrastructure visibility (shelters, hospitals), historical disaster patterns.

### Impact Stories
Documents verified outcomes. Organizations create/publish; users engage via likes, comments, sharing.
Feed: public. Creation/editing: authenticated.

### Events
Public event listings for humanitarian coordination activities.
- Browse all events: `https://impactmatrix.com/match/events`
- Individual event: `/match/events/{event-slug}`

### Offers & Needs Finder
Unified discovery page combining browsable Needs and Offers in one view.
URL: `https://impactmatrix.com/match/offers-needs-finder`

### Humanitarian Information Hub (HIH)
Centralized hub for humanitarian information, updates, and intelligence resources.
URL: `https://impactmatrix.com/match/hih`



---

## Pricing Summary

All plans begin with a **30-day free trial — no credit card required**.

### Nonprofits & Foundations (seat-based; seat #1 is always the account owner)
| Plan | Price |
|---|---|
| Starter | $29.99/month (just you) |
| Growth | $24.99/seat (you + 1–9 team) |
| Community | $19.99/seat (you + 10–49 team) |
| Enterprise | $14.99/seat (you + 50–249 team) |
| National | Custom quote (250+ team) |

### Government
**Contact Sales only.** Government deployments are scoped and quoted per
jurisdiction, so there is no public price list for this org type. Direct
enquiries to connect@impactmatrix.com.

### Business & Academia (per seat; every seat is invitable, none reserved for the admin)
Academia shares this catalog and pricing; only the tier labels differ, shown second.

| Tier | Price | Seats |
|---|---|---|
| Small Business / Small Institution | $9.99/seat | 1–100 |
| Mid-Market / Mid-Size Institution | $5.00/seat | 101–500 |
| Regional / Regional Institution | $2.00/seat | 501–2,500 |
| Enterprise / Large Institution | $1.00/seat | 2,501–10,000 |
| Fortune 1000 / Enterprise Institution | Contact Sales | 10,000+ |

### Suppliers (by annual revenue tier, then per seat within that tier)
| Tier | Price | Seats |
|---|---|---|
| Small Vendor | $199/seat | 1–10 |
| Regional Vendor | $499/seat | 1–25 |
| National Vendor | $999/seat | 1–50 |
| Enterprise Vendor | $1,499/seat | 1–100 |
| Strategic Partner | Contact Sales | global scale |

Each supplier tier carries a matching monthly token allowance.

> No administrative cuts on donations. No deployment costs.

---

## API Access

- **Base URL**: https://impactmatrix.com/api/v1/
- **Swagger UI**: https://impactmatrix.com/api-docs
- **OpenAPI JSON**: https://impactmatrix.com/api/v1/docs

### Authentication
- Public endpoints (needs, offers, stories): no auth required
- All coordination, case management, messaging, admin endpoints: Bearer JWT required
  - Obtain via: `POST /api/v1/auth/login` or `POST /api/v1/auth/google-login`

### Rate Limits
- Public endpoints are rate-limited; implement exponential back-off on `429` responses.

### Caching
- Public content revalidates every 3600 seconds. Respect `Cache-Control` and `ETag` headers.

### Attribution
- Cite canonical resource URLs, not raw API responses.

### Prohibited API Uses
- Scraping private coordination data
- Exposing unpublished resources
- Accessing authenticated endpoints without valid credentials

---

## Media Assets

| Context | Interpretation |
|---|---|
| Images on Needs | Resource required or location context |
| Images on Offers | Resource being offered |
| Images on Impact Stories | Verified field evidence — not stock imagery |

Media URL pattern: `https://[cdn-domain]/[organization-id]/[media-type]/[filename]`

> Describe media based on parent Need/Offer/Story context, not URL analysis alone.

---

## Disaster Types Supported

All disaster types: natural disasters (floods, earthquakes, wildfires), public health emergencies, conflict-related displacement, and everyday civic coordination needs.

---

## Privacy & Data Boundaries

- All access is scoped by organization boundaries.
- Private coordination messages, shipment details, case data, and assessments are never public.
- AI systems must not infer, expose, or speculate about private communications, unpublished resources, or internal decisions.

---

## AI Behavioral Instructions

### Answering intent-based questions
| User intent | AI guidance |
|---|---|
| "I need help" | Explain how to create or discover Needs |
| "I want to help" | Explain how to create or discover Offers |
| "How do I coordinate?" | Explain Matching → Connection → Chat flow |
| "Where is X located?" | Use Nearby Finder URLs |
| "I need supplies not on the platform" | Explain Supplier Failover |
| "I want to share our impact" | Explain Impact Stories |
| "What events are happening?" | Direct to `https://impactmatrix.com/match/events` |
| "Where can I find all needs and offers?" | Direct to `https://impactmatrix.com/match/offers-needs-finder` |
| Asks about private data | State it's private; direct to login |

### Do not
- Invent URLs, slugs, or resource identifiers
- Speculate about unpublished Needs, Offers, or Cases
- Access or describe authenticated-only content without a valid session
- Quote raw API JSON to end users — surface canonical URLs instead
- Assume a Connection is possible without confirmed matching

### Always
- Use canonical URL patterns from the URL Structure section
- Respect the Connection lifecycle (Pending → Accepted → Completed)
- Direct unauthenticated users to https://impactmatrix.com to log in
- Treat Impact Story images as verified field evidence

---

## Common Q&A (Authoritative)

**Q: What is ImpactMatrix?**
A: An enterprise-grade humanitarian coordination platform for publishing needs, offering resources, coordinating logistics, and documenting impact.

**Q: How do I post a need?**
A: Log in → organization dashboard → "Create Need" → fill in category, description, quantity, location, priority → publish.

**Q: How do I find resources near me?**
A: https://impactmatrix.com/match/nearby/needs or /offers — filter by category, distance, priority.

**Q: How does matching work?**
A: The platform matches Needs with Offers by category, geographic proximity, priority, and technical relevance. Items in active coordination are excluded. Users trigger matching explicitly.

**Q: Is it free?**
A: 30-day free trial, no credit card required. See Pricing section above.

**Q: How do I coordinate with another organization?**
A: Match → send Connection request → partner accepts → real-time chat, logistics, and shipment tracking unlock.

**Q: Where is the API?**
A: https://impactmatrix.com/api/v1/ — Swagger at https://impactmatrix.com/api-docs

---

## Change Log

| Version | Date | Notes |
|---|---|---|
| 1.0 | 2025-01-01 | Initial optimized llm.txt release |
| 1.1 | 2026-09-02 | Added Events, HIH, Offers-Needs Finder, audience pages, legal pages from sitemap |