Skip to content

Architecture

This section is the architectural bible for Tomoda — the cross-cutting view of how the system is composed, how data flows, and which trade-offs were made and why. It is the place to start when you need to understand a feature end-to-end, onboard a new engineer, or evaluate a design change.

Each page below stands on its own and links into the deeper backend, frontend, and infrastructure docs.

  • System Overview

    Component map, request lifecycle, real-time lifecycle, deployment topology.

  • Data Model

    Core entities, relationships, and domain groupings — with an ER diagram.

  • Authentication

    Five auth methods, JWT + refresh tokens, sessions, API keys, end-to-end flow.

  • Real-time

    WebSocket Hub, per-event rooms, ping/pong, presence, and the road to multi-node.

  • Business Domains

    Catalog of bounded contexts mapped to backend services and frontend folders.

  • Technical Decisions

    ADR-lite — the choices that shape the codebase and why they were made.