MedTracker

MedTracker is a Rails application for safe medication tracking across prescriptions and non-prescription medicines, with auditability and care-team support.

Key capabilities

• Prescription and person-medicine tracking
• Dose recording with timing and daily-limit safeguards
• Carer-to-dependent relationship support
• Role-based access control
• Audit trail for safety-critical changes

Stack

• Ruby on Rails
• PostgreSQL
• Hotwire (Turbo + Stimulus) + Phlex
• RSpec + Capybara/Playwright
• Docker Compose + Taskfile workflows

Quick start

git clone https://github.com/damacus/med-tracker.git
cd med-tracker
task dev:up
task dev:seed

Open http://localhost:3000.

Testing

task test

Client Tools

First-party Rust tools live under client-tools/:

• medtracker: CLI for /api/v1 workflows.
• medtracker-mcp: stdio MCP server for agent clients.

Run local tool gates with task client-tools:fmt, task client-tools:check, task client-tools:clippy, and task client-tools:test.

Documentation

Published docs: https://damacus.github.io/med-tracker/

Key pages:

• Quick Start
• Glossary
• LLM Context Index (llms.txt)
• Kubernetes User Seeding
• Carer Onboarding: First Dose
• Testing
• Client Tools
• Design
• User Management

Build docs locally

pip install -r requirements.txt
task docs:serve

Contributing

See CONTRIBUTING.md for setup instructions, development workflow, and coding standards.