Reference Documentation

System-level documentation describing how BattleScore is structured, how its layers interact, and where key behaviours live.
Architecture Onboarding Cross-Component

Purpose of this section

The SQL, API, App, TO and Admin sections document individual parts of the solution. This Reference section sits above those areas and explains the platform as a coherent system.

It is intended to answer questions such as:

  • What are the main components of BattleScore?
  • How does data move between database, API, and user interface?
  • How do gameplay and scoring actually work end-to-end?
  • Which parts of the solution are affected when a specific feature changes?

Reference pages

Page Focus
System OverviewFull-stack architecture and domain layout
Solution ComponentsDetailed breakdown of each layer and responsibility
Component InteractionsHow SQL, API, App, TO and Admin work together
Data FlowHow reference, transactional and runtime data move through the platform
Gameplay & Scoring FlowEnd-to-end play model and scoring mechanics
Tournament & TO FlowHow tournaments, entrants, armies and standings fit together
Change Impact GuideWhere to change things and what else is affected

Related documentation

  • SQL – database schema and table-level documentation
  • API – endpoint-level server documentation
  • User Interface – user-facing frontend pages and scripts
  • TO – tournament organiser frontend workflows
  • Admin – internal maintenance and configuration layer