Rocket Club

Platform documentation

Documentation for the Rocket Club monorepo — the web and admin apps, the shared UI library, the data platform and pipelines, and the AWS infrastructure that runs them.

7 sections · 56 pages

Section 1

Introduction

Welcome to the Rocket Club platform.

  1. Introduction

    Welcome to the Rocket Club platform.

  2. Repository Overview

    High-level map of this Nx monorepo (apps, data platform, and infrastructure).

  3. Architecture Diagrams

    Gallery of architecture diagrams and instructions for generating them.

Section 2

Web App

Engineering notes for the Next.js web app (images, layout, and UI).

  1. Web App (Overview)

    Local dev + debugging notes for the web app.

  2. Image Dimensions Standard

    Standardized image dimensions and aspect ratios used in the UI.

  3. Responsive Grid System

    Standardized responsive grid patterns for galleries and cards.

  4. LazyGallery Usage

    How to use the LazyGallery/BlogGallery/TagGallery components.

  5. Neo4j (Web Integration)

    How the web app connects to Neo4j and where to find schema docs.

Section 3

Admin App

Internal admin panel: infrastructure catalogue, health checks, logs, park/unpark and the service catalog.

  1. Admin App (Overview)

    What the admin app does and how its infrastructure and service catalogs are maintained.

Section 4

Data Platform & Pipelines

Data platform, graph model, and pipeline operations for Rocket Club.

  1. Data Platform Overview

    Where the data platform lives in this repo, how it is structured, and how to run it locally.

  2. Legacy Notes (Deprecated)

    Historical context and older naming that still appears in some scripts/docs.

  3. Data Model

    Neo4j graph database schema with node types and relationships.

  4. Data Organization

    How data is organized and structured in the system.

  5. Generated Schema

    Auto-generated schema documentation from the database.

  6. Data Flow Verification

    Verifying data integrity and flow through the system.

  7. Pipelines Architecture

    Overview of the data pipeline architecture and components.

  8. Flows Overview

    How Prefect flows are organized and how they relate.

  9. Main Pipeline Flow

    End-to-end orchestration: extract → clean → graph load.

  10. Data Extraction Flow

    Scrape sources into the raw layer in S3.

  11. Data Cleaning Flow

    Normalize raw data into clean, graph-ready CSVs.

  12. Graph Load Flow

    Load the clean layer into Neo4j with constraints and relationships.

  13. Data Sources Overview

    Supported extraction sources and how to add a new one.

  14. Source: ThrustCurve Motors

    Motor metadata/specs from ThrustCurve.org.

  15. Source: ThrustCurve Samples

    Thrust curve sample/test data from ThrustCurve.org.

  16. Source: ThrustCurve Metadata

    Supporting reference data used by ThrustCurve-derived ingests.

  17. Source: Estes Kits

    Current Estes kits catalog.

  18. Source: JimZ Estes

    Historical Estes kit information from the JimZ archive.

  19. Source: LOC/Precision Kits

    LOC/Precision kit catalog.

  20. Source: Rocketarium Kits

    Rocketarium kit catalog.

  21. Source: NAR Clubs

    National Association of Rocketry club listings.

  22. Source: Tripoli Clubs

    Tripoli Rocketry Association club listings.

  23. Source: Tripoli Vendors

    Tripoli vendor/manufacturer directory.

  24. Manufacturer Registry

    Canonical manufacturer ID mapping to prevent duplicates across sources.

  25. ORK Processor Lambda

    Process uploaded OpenRocket .ork files and write results to Neo4j.

  26. Pipelines Deployment

    How to deploy the data pipelines.

  27. Quick Start Deployment

    5-minute guide to deploying the pipelines.

  28. Deployment Checklist

    Pre-deployment checklist for the data pipelines.

  29. CircleCI Setup

    Setting up CircleCI for pipeline CI/CD.

  30. CircleCI Deployment

    CircleCI deployment workflows and jobs.

  31. Prefect Work Pool Setup

    Configuring Prefect work pools for pipeline execution.

  32. Error Handling

    Error handling strategies for the data pipelines.

  33. Image Processing

    Image processing pipeline and Cloudinary integration.

  34. Data Infrastructure

    Infrastructure components used by the data pipelines.

  35. Secrets Management

    Managing secrets for the data pipelines.

  36. S3 Setup

    S3 bucket configuration for data storage.

  37. S3 Lifecycle Policies

    S3 lifecycle policies for data retention.

  38. Cloudinary Configuration

    Cloudinary setup for image hosting and transformation.

Section 5

Infrastructure

AWS infrastructure architecture for the Rocket Club platform.

  1. Infra Overview & Ownership

    Scope of platform infrastructure, ownership boundaries, and related repositories.

  2. Terraform Bootstrap (Global)

    Global/shared Terraform root (state bucket, shared IAM/OIDC for Vercel).

  3. Terraform Modules (Catalog)

    Quick catalog of reusable Terraform modules in this repo.

  4. Networking & Entry Points

    DNS, CDN, ALB, and ECS routing for the pipelines hostname.

  5. Security, IAM & Secrets

    TLS termination, IAM roles/policies, and Secrets Manager configuration.

  6. AWS Secrets & Parameters (Cheat Sheet)

    Quick reference for key Secrets Manager and SSM Parameter Store entries used by this repo.

  7. Deployment & CI/CD

    Terraform workflows, CircleCI jobs, and park/unpark operations.

Section 6

Auth

Authentication across the apps via Kinde.

  1. Auth (Overview)

    How Kinde authentication is wired into the web, admin and docs apps.

Section 7

Design System

The shared shadcn/ui component library and design tokens (@rocket-club/ui).

  1. Design System (Overview)

    The single shadcn/ui stack in libs/ui, its tokens, and how apps consume it.