Architecture Reference

Reef.A.Matic System Docs

Rendered diagrams and workflow references generated from the architecture markdown in this repo.

docs/architecture.md Reef-A-Matic Architecture

This document maps the current Reef-A-Matic application from the UI to API Gateway, Lambda functions, SQS queues, S3 buckets, EventBridge, DynamoDB tables, Stripe, Cognito, and the GitHub Actions deployment path.

docs/architecture/README.md Reef-A-Matic Functional Architecture Diagrams

The main architecture reference remains in ../architecture.md. That file is the canonical full-system map.

docs/architecture/async-queues.md Asynchronous Queue Topology

This slice shows the queue-backed Lambda handoffs. Use this when debugging "what happens after the API call returns" or when tracing work that moves Lambda -> SQS -> Lambda, including the chained backfill path.

docs/architecture/deployment.md Deployment And Environment Isolation

This slice shows how dev and prod move from branch merges to environment-scoped AWS resources.

docs/architecture/dose-and-program.md Dose And Program History

This slice covers dose history, program history, correction application, active-program scheduling, draft programs, and backfill.

docs/architecture/realtime-errors-observability.md Realtime, Errors, And Observability

This slice covers WebSocket updates, support-reference errors, CloudWatch/Grafana observability, and cost visibility.

docs/architecture/templates-and-dashboards.md Templates And Dashboards

This slice covers reusable manual-entry templates and user-defined dashboards.

docs/architecture/test-and-icp.md Test And ICP Processing

This slice covers manual tests, ICP PDF upload, ICP extraction, corrections, element trends, Reef Review generation, and test-history storage.

docs/architecture/user-billing-admin.md User, Billing, And Admin

This slice covers Cognito registration, profile/tank data, tank-level target ranges, Stripe, free Pro grants, admin configuration, admin costs, and support tooling.