> ## Documentation Index
> Fetch the complete documentation index at: https://285e39fd5e337e58f16290.sightscreen.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sightscreen

> Internal architecture map for the Sightscreen cricket live-scoring platform

Real-time cricket scores delivered to iPhone lock screens via Live Activities. This is the internal reference for understanding how the system works — backend, iOS, and everything in between.

## System Map

Understand the architecture at a glance.

<Columns cols={2}>
  <Card title="System context" icon="diagram-project" href="/system-map/system-context">
    How backend, iOS, admin, and external services connect.
  </Card>

  <Card title="Layer architecture" icon="layer-group" href="/system-map/layers">
    Routes, services, repositories, and dependency injection.
  </Card>

  <Card title="Data model" icon="database" href="/system-map/data-model">
    DynamoDB tables, keys, GSIs, and access patterns.
  </Card>

  <Card title="Overview" icon="eye" href="/system-map/overview">
    Tech stack, project structure, and what this site covers.
  </Card>
</Columns>

## Business Flows

How data moves across the system for each user story.

<Columns cols={2}>
  <Card title="Live score → lock screen" icon="bolt" href="/business-flows/live-scores">
    Event-driven pipeline: Pollers → EventBus → Detectors → LACoordinator → APNs.
  </Card>

  <Card title="Live Activity lifecycle" icon="mobile" href="/business-flows/live-activity-lifecycle">
    Start, update, end — from user follow to lock screen dismissal.
  </Card>

  <Card title="Match following" icon="heart" href="/business-flows/match-following">
    User follows a match → push-to-start → Live Activity → updates → ends.
  </Card>

  <Card title="Authentication" icon="lock" href="/business-flows/auth-flow">
    Cognito signup, JWT validation, admin roles, follow sync.
  </Card>
</Columns>

## Quick links

<Columns cols={2}>
  <Card title="Backend API" icon="server" href="/backend/authentication">
    Endpoints, auth, background jobs, and config reference.
  </Card>

  <Card title="iOS App" icon="mobile" href="/ios/architecture">
    SwiftUI architecture, Live Activities, services, and build setup.
  </Card>
</Columns>