Science-Based Fitness App — Architecture Review

Architecture Review

Date: April 10, 2026

Attendance

Agenda

  1. Review system architecture diagram
  2. Decide on API design for the exercise database
  3. Finalize schema for exercises and research citations
  4. Discuss user authentication approach
  5. Assign tasks for next sprint

Unfinished Business

New Business

REST vs GraphQL for the Exercise Database API

The team chose REST for the initial release due to simpler caching and team familiarity. GraphQL will be reconsidered if query flexibility becomes a bottleneck.

Schema for Exercises and Citations

Andy proposed a schema with tables for exercises, muscle groups, research citations (with DOI and study quality rating), and user workout logs. Approved with minor revisions to the citations table.

User Authentication Approach

The team agreed on JWT-based auth with HTTP-only cookies for refresh tokens and short-lived access tokens.

Miscellaneous Comments / Questions / Concerns

Diagrams

High-level system architecture showing the React frontend, REST API, recommendation engine, and PostgreSQL database
Figure 1: Science-Based Fitness App system architecture overview

Recordings

Audio recording of the meeting
Video recording of the meeting