Skip to content

User Guide

In-depth reference documentation for BigBrotr's architecture, services, configuration, database, and monitoring.

  • Architecture

    Diamond DAG layer structure, design patterns, concurrency model, and testing architecture.

  • Services

    Deep dive into the eight independent services: Seeder, Finder, Validator, Monitor, Synchronizer, Refresher, Api, Dvm.

  • Configuration

    Complete YAML configuration reference with Pydantic validation and examples.

  • Database

    PostgreSQL schema, stored functions, materialized views, and indexes.

  • Monitoring

    Prometheus metrics, alerting rules, Grafana dashboards, and structured logging.

Where to start

New to BigBrotr? Start with Architecture for the system overview, then Services to understand what each service does.