# Calendar App

> A production-grade calendar application for scheduling, events, and team collaboration.

## Overview
Calendar App is a production-grade calendar and scheduling application.
It provides week, day, and month views, event management, and a full REST API.
It integrates with the Platphorm News ecosystem: Kanban, Jobs, and MCP.

## API
- Base URL: https://calendar.platphormnews.com/api
- Version: v1
- Auth: API Key via X-API-Key header (frontend uses localStorage key `platphormnews_api_key`)
- Rate Limit: 100 requests per minute
- Documentation: https://calendar.platphormnews.com/api/docs

## Key Endpoints
- GET /api/health - Health check
- GET /api/docs - OpenAPI specification
- GET /api/v1/events - List events (paginated)
- POST /api/v1/events - Create event
- GET /api/v1/events/:id - Get event
- PUT /api/v1/events/:id - Update event
- DELETE /api/v1/events/:id - Soft delete event
- POST /api/v1/webhooks - Webhook receiver
- GET/POST/PUT /api/v1/integrations/kanban - Kanban board integration
- GET/POST/PUT /api/v1/integrations/jobs - Jobs board integration
- GET/POST /api/v1/mcp - MCP server (AI agent integration)

## Ecosystem
- Kanban: https://kanban.platphormnews.com
- Jobs: https://jobs.platphormnews.com
- Insights: https://insights.platphormnews.com
- Main: https://platphormnews.com
- Trace: https://trace.platphormnews.com
- Codex: https://codex.platphormnews.com
- Monitor: https://monitor.platphormnews.com
- Atlas: https://atlas.platphormnews.com
- Docs: https://docs.platphormnews.com
- Claws: https://claws.platphormnews.com
- MCP: https://mcp.platphormnews.com

## Features
- Multi-tenant architecture
- Week, day, month calendar views
- Event CRUD with soft deletes
- Webhook support with idempotency
- RSS and Atom feeds
- OpenAPI documentation
- JSON-LD structured data
- Kanban board sync
- Jobs listing sync and import
- Full markdown documentation via API
- SEO-enabled sharing with OpenGraph metadata

## Documentation
- Docs API: https://calendar.platphormnews.com/api/v1/docs
- Architecture: https://calendar.platphormnews.com/api/v1/docs?slug=architecture
- API Reference: https://calendar.platphormnews.com/api/v1/docs?slug=api
- MCP Guide: https://calendar.platphormnews.com/api/v1/docs?slug=mcp
- Integration: https://calendar.platphormnews.com/api/v1/docs?slug=integration
- Roadmap: https://calendar.platphormnews.com/api/v1/docs?slug=roadmap
- FAQ: https://calendar.platphormnews.com/api/v1/docs?slug=faq

## Schemas
- PlatPhorm Universal Schema Pack: https://calendar.platphormnews.com/schemas/platphorm-universal-schema-pack.json

## Contact
- Creator: Michael Barbine
- Email: Michael@Barbineworldwide.com
- GitHub: https://github.com/mbarbine
- Community: https://github.com/mbarbine