Skip to content

carverauto/chaseapp

BranchesTags

Repository files navigation

ChaseApp

Real-time notification and community platform for live events.

Website: https://chaseapp.tv

Overview

ChaseApp delivers real-time alerts and enables community discussion around breaking events:

  • Police Chases - Live pursuit tracking with real-time location updates
  • Rocket Launches - Space launch notifications (SpaceX, NASA, etc.)
  • Weather Events - Severe weather alerts and storm tracking
  • Aircraft Tracking - Aviation monitoring with clustering detection

The platform consists of web, iOS, and Android applications backed by a self-hosted infrastructure designed for low-latency real-time updates.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Clients                                  │
├─────────────┬─────────────┬─────────────────────────────────────┤
│   Web App   │  iOS App    │  Android App                        │
│   (Nuxt.js) │  (Flutter)  │  (Flutter)                          │
└──────┬──────┴──────┬──────┴──────┬──────────────────────────────┘
       │             │             │
       └─────────────┼─────────────┘
                     │ HTTPS
                     ▼
              ┌──────────────┐
              │     Kong     │  API Gateway
              │   (Ingress)  │  Auth, Rate Limiting
              └──────┬───────┘
                     │
       ┌─────────────┼─────────────┐
       │             │             │
       ▼             ▼             ▼
┌──────────┐  ┌──────────┐  ┌──────────┐
│   API    │  │   Chat   │  │   Auth   │
│  (Go)    │  │   (Go)   │  │  (OAuth) │
└────┬─────┘  └────┬─────┘  └──────────┘
     │             │
     └──────┬──────┘
            │
     ┌──────┴──────┐
     │    NATS     │  Event Bus
     │ (JetStream) │  Real-time Messaging
     └──────┬──────┘
            │
┌───────────┼───────────┬───────────────┐
│           │           │               │
▼           ▼           ▼               ▼
┌────────┐ ┌─────────┐ ┌──────────┐ ┌───────┐
│PostgreSQL│ │Typesense│ │  MinIO   │ │ ntfy  │
│   (DB)   │ │ (Search)│ │(Storage) │ │(Push) │
└──────────┘ └─────────┘ └──────────┘ └───────┘

Project Structure

chaseapp/
├── api/                    # Go monolithic API server
│   ├── cmd/server/         # Application entry point
│   ├── internal/           # Private application code
│   │   ├── config/         # Configuration
│   │   ├── database/       # Database connection & migrations
│   │   ├── handler/        # HTTP handlers
│   │   ├── middleware/     # HTTP middleware
│   │   ├── model/          # Domain models
│   │   └── repository/     # Data access layer
│   ├── migrations/         # PostgreSQL migrations
│   └── pkg/                # Shared packages
├── web/                    # Nuxt.js web application
│   ├── components/         # Vue components
│   ├── pages/              # Route pages
│   ├── plugins/            # Nuxt plugins
│   └── store/              # Vuex store
├── mobile/                 # Flutter mobile app (iOS & Android)
│   ├── lib/                # Dart source code
│   ├── ios/                # iOS-specific code
│   └── android/            # Android-specific code
├── k8s/                    # Kubernetes manifests
│   ├── base/               # Base manifests
│   ├── staging/            # Staging overlay
│   └── prod/               # Production overlay
├── shared/                 # Shared code/configs
├── openspec/               # API specifications & change proposals
└── tools/                  # Build tools & scripts

Tech Stack

Backend (api/)

Component Technology
Language Go 1.21+
HTTP Router Gorilla Mux
Database PostgreSQL 15+ (pgx driver)
Migrations golang-migrate
Messaging NATS JetStream
Search Typesense
Object Storage MinIO (S3-compatible)
Push Notifications ntfy/Gotify + APNs + FCM

Web (web/)

Component Technology
Framework Nuxt.js 2 (Bridge) + Vue.js
Language TypeScript
Styling TailwindCSS (WindiCSS)
State Vuex
Maps Mapbox GL JS
Real-time NATS WebSocket

Mobile (mobile/)

Component Technology
Framework Flutter 2.17+
Language Dart
State Riverpod
Maps Mapbox GL
Push APNs/FCM direct
Payments RevenueCat

Infrastructure

Component Technology
Build System Bazel
Container Runtime Docker
Orchestration Kubernetes
Config Management Kustomize
API Gateway Kong
SSL Let's Encrypt (cert-manager)
Observability Prometheus + Grafana + Loki

Getting Started

Prerequisites

  • Go 1.21+
  • Node.js 18+ (via Volta)
  • Flutter SDK 2.17+
  • Docker & Docker Compose
  • Bazel (optional, for full builds)

Quick Start (API Development)

# Clone the repository
git clone https://github.com/carverauto/chaseapp.git
cd chaseapp

# Start infrastructure services
cd api
cp .env.example .env
docker-compose up -d postgres nats typesense

# Run database migrations
go install -tags 'postgres' github.com/golang-migrate/migrate/v4/cmd/migrate@latest
migrate -path migrations -database "postgres://chaseapp:chaseapp_dev@localhost:5432/chaseapp?sslmode=disable" up

# Start the API server
go run cmd/server/main.go

API available at http://localhost:8080

Web Development

cd web
npm install
npm run dev

Web app available at http://localhost:3000

Mobile Development

cd mobile
flutter pub get
flutter run

API Endpoints

Core Endpoints

Method Endpoint Description
GET /health Health check
GET /ready Readiness check
GET /metrics Prometheus metrics

Chases API

Method Endpoint Description
GET /api/v1/chases List chases (paginated)
POST /api/v1/chases Create chase
GET /api/v1/chases/{id} Get chase
PUT /api/v1/chases/{id} Update chase
DELETE /api/v1/chases/{id} Delete chase
GET /api/v1/chases/bundle Offline data bundle

Aircraft API

Method Endpoint Description
GET /api/v1/aircraft List aircraft
POST /api/v1/aircraft/cluster DBSCAN clustering

Push Notifications

Method Endpoint Description
POST /api/v1/push/subscribe Register device
POST /api/v1/push/unsubscribe Unregister device

External Data

Method Endpoint Description
GET /api/v1/quakes USGS earthquake data
GET /api/v1/launches Rocket launch data
GET /api/v1/weather/alerts NOAA weather alerts
GET /api/v1/boats AIS vessel data

Configuration

Environment Variables

See api/.env.example for full configuration options.

Key variables:

# Server
SERVER_PORT=8080

# Database
DB_HOST=localhost
DB_PORT=5432
DB_USER=chaseapp
DB_PASSWORD=secret
DB_NAME=chaseapp

# NATS
NATS_URL=nats://localhost:4222

# Typesense
TYPESENSE_HOST=localhost
TYPESENSE_API_KEY=your_key

Deployment

Docker

# Build API image
docker build -t chaseapp-api ./api

# Run with Docker Compose
docker-compose up

Kubernetes

# Deploy to staging
kubectl apply -k k8s/staging

# Deploy to production
kubectl apply -k k8s/prod

Development Workflow

Branch Naming

  • feature/<description> - New features
  • fix/<description> - Bug fixes
  • chore/<description> - Maintenance tasks

Code Style

  • Go: gofmt + golangci-lint
  • TypeScript: ESLint + Prettier
  • Dart: very_good_analysis

Testing

# Go tests
cd api && go test ./...

# Web tests
cd web && npm test

# Mobile tests
cd mobile && flutter test

Documentation

  • api/README.md - API-specific documentation
  • openspec/ - API specifications and change proposals
  • openspec/project.md - Detailed project context

Contributing

  1. Create a feature branch from main
  2. Make changes following code style guidelines
  3. Write/update tests as needed
  4. Submit a pull request

License

Proprietary - CarverAuto / ChaseApp

About

No description, website, or topics provided.

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages