# MarsOps - Mars Society Operations Dashboard
> Real-time visibility into Mars Society digital infrastructure, projects, and volunteer opportunities.

## About
MarsOps (ops.newmars.com) is the public-facing operations dashboard for The Mars Society's IT department. It provides monitoring of Mars Society web properties, tracks active digital projects, and connects volunteers with opportunities.

## Organization
The Mars Society is a nonprofit organization dedicated to promoting the exploration and settlement of Mars. Founded in 1998 by Dr. Robert Zubrin, it operates the Mars Desert Research Station (MDRS), conducts Mars analog research, and advocates for human missions to Mars.

## Key Pages
- / — Dashboard with system health metrics, active initiatives, and infrastructure status with gauge dials
- /projects — Full listing of all digital projects and their current status
- /monitoring — Detailed infrastructure monitoring for all Mars Society web properties
- /about — Information about the IT department, how to get involved, and contact details

## API — Public Endpoints (no auth required)

### GET /api/status
Returns live infrastructure status for all monitored sites.
Response fields: timestamp, source ("uptimerobot"|"fallback"), systems[] with name, status ("Operational"|"Degraded"|"Down"), uptime, load, url.
Cache: 60 seconds.

### GET /api/projects
Returns all active projects.
Response fields: timestamp, count, projects[] with name, description, tag, link.
Cache: 300 seconds.

## API — Management Endpoints (Bearer token required)
All management endpoints require: Authorization: Bearer <MARSOPS_ADMIN_KEY>

### GET /api/manage/dashboard
Returns all data in one call: sites, projects, and summary metrics (totalSites, totalProjects, activeProjects, seekingVolunteers).

### GET /api/manage/sites
Returns all monitored sites with id, name, url, category.

### PUT /api/manage/sites/{id}
Update a site. Body (all optional): name, url, category.
Site IDs: membership-db, mdrs-website, main-website, chapters-website, store, marspedia, volunteer-portal, branding-site, marsvr.

### GET /api/manage/projects
Returns all projects with id, name, description, tag, link.

### PUT /api/manage/projects/{id}
Update a project. Body (all optional): name, description, tag, link.
Project IDs: marsvr, mobile-apps, marspedia-editorial, convention-video, chapter-templates, mdrs-reports, membership-db, volunteer-portal, ops-dashboard, branding, education.

## Related Sites
- https://www.marssociety.org — Main Mars Society website
- https://volunteer.marssociety.org — Volunteer opportunities portal
- https://mdrs.marssociety.org — Mars Desert Research Station
- https://marspedia.org — Mars encyclopedia wiki
- https://marsvr.io — MarsVR virtual reality project
- https://branding.marssociety.org — Brand guidelines
- https://chapters.marssociety.org — Chapter websites
- https://store.marssociety.org — Mars Society store

## Contact
- Webmaster: webmaster@marssociety.org (email to open a support ticket)
- ITF Director: jamesburk@marssociety.org