# Lok Panchang Docs

## Docs

- [Admin portal](https://docs.lokpanchang.com/admin-portal.md): How the admin portal works: Flask API, Next.js frontend, test routes, and admin capabilities
- [Backend](https://docs.lokpanchang.com/backend.md): Flask app, WhatsApp webhook flow, main modules, and entrypoints for the Lok Panchang API
- [Database](https://docs.lokpanchang.com/database.md): Schema, models, connection, migrations, and backups for the Lok Panchang PostgreSQL database
- [Reverse geocoding](https://docs.lokpanchang.com/geocoding/reverse-geocoding.md): How coordinates are turned into timezone and city: OpenCage API, longitude-based fallback, and CityDetail caching
- [Testing Routes](https://docs.lokpanchang.com/guides/testing-routes.md): Generate and test panchangam messages without sending via WhatsApp
- [Introduction](https://docs.lokpanchang.com/index.md): Documentation for the Lok Panchang WhatsApp Panchangam notification service
- [Infrastructure overview](https://docs.lokpanchang.com/infrastructure.md): How the Lok Panchang stack is run: Docker, Meta/WhatsApp, AWS, Caddy, and Ngrok
- [AWS](https://docs.lokpanchang.com/infrastructure/aws.md): EC2 hosting and Elastic IP for the Lok Panchang stack
- [Caddy](https://docs.lokpanchang.com/infrastructure/caddy.md): What Caddy is, why we use it, and how subdomains map to api, admin, and docs
- [Docker](https://docs.lokpanchang.com/infrastructure/docker.md): Docker Compose services, ports, volumes, and dependencies for the Lok Panchang stack
- [Meta & WhatsApp](https://docs.lokpanchang.com/infrastructure/meta-whatsapp.md): Meta Webhooks, connection to WhatsApp Business API, and using WhatsApp template messages
- [Logging](https://docs.lokpanchang.com/logging.md): Where logs live, how to view and save them, daily backup to disk, and weekly S3 upload
- [Calculating Panchangam](https://docs.lokpanchang.com/panchangam/core-calculation.md): How panchangam is computed from coordinates: inputs, pipeline, and where the backend uses it
- [Quickstart](https://docs.lokpanchang.com/quickstart.md): Get the Lok Panchang project running from a fresh clone: prerequisites, environment, and first run
- [Scheduler](https://docs.lokpanchang.com/scheduling.md): Celery and Beat: JIT planner, send_for_timezone, Redis locks, and the flow from 6:30 AM local to WhatsApp

## OpenAPI Specs

- [openapi](https://docs.lokpanchang.com/api-reference/openapi.json)