MOW Delivery Platform - Readme¶

A free and open-source delivery management system for Meals on Wheels organizations.
Built with modern tooling, strong defaults, and first-class observability.

Repos & major components¶

Area	Description	Readme
Project	Cross-cutting overview & coordination	`./readme.md`
Design	System design & architecture	`../design/readme.md`
Backend	Django/DRF, portals, reports	`../backend/readme.md`
iOS	Native iOS app	`../ios/readme.md`
Android	Native Android app	`../android/readme.md`
API	OpenAPI admin & volunteer specs	`../api/readme.md`

Status & timeline¶

In development — targeting December 2025 for an initial public release.
Open source — free to use, fork, and adapt.

Highlights¶

Modern backend: Python 3.13 / Django 5.2 LTS / DRF + JWT
Infra: AWS EC2 (ARM64), Docker Compose, Caddy
Data: PostgreSQL 17, Redis 8, nightly backups
Security: CSP, HSTS, least privilege; secrets in SSM Parameter Store
Observability: OTel → Prometheus, Loki, Tempo → Grafana
CI/CD: GitHub Actions → multi-arch images → ECR → EC2 via SSM
Docs: MkDocs + generated OpenAPI

See the detailed table → Master Technology Inventory

Key Project Documentation In This Repo¶

CHANGELOG: Tracks high-level, system-wide changes.
Partnership Details: Project history and context.
Master Technology Inventory: A complete list of all technologies used.
System Architecture: High-level system diagrams.
Project Roadmap: Planned features and future goals.

External Links¶

Project Website: https://mow.codejim.com
Developer Docs (MkDocs): https://developer.mow.codejim.com
API Reference (Swagger): https://api.developer.mow.codejim.com

Contributing¶

We welcome issues and PRs!
Standards:

Conventional Commits
Lint/tests must pass the PR Quality Gate
Keep docs in sync (MkDocs + README snippets)

License¶

Open-source (license file in repo). Contributions welcome.

Note: This file is the root README.md for the mow-project GitHub repository. The links below are for navigating the mkdocs developer site.

< Project Overview

Next: Changelog >