Playbook Board
Diagrams
Film-room views of the nbadb architecture, data flow, and API coverage
Diagrams
The diagrams section is the visual film room for nbadb: whiteboard views for schema shape, playbook views for pipeline movement, and shot-chart overlays for endpoint coverage.
Film room note: Pick the board that matches your question, then use the companion pages to zoom from fast orientation into generator-backed detail.
The curated pages in this section add reading cues around the visuals. The companion auto-generated ER diagram remains source-derived and should be regenerated, not hand-edited.
Quick navigation
Read the warehouse shape
Start with ER Diagram when your question is about join anchors, fact neighborhoods, or bridge-table placement.
Trace stage movement
Go to Pipeline Flow when you need the raw → staging → star route before you inspect any single table.
Map feeds to landing tables
Use Endpoint Map when you know the inbound endpoint family and need the fastest route to the warehouse target.
Open the full generated roster
Jump to Auto ER Diagram when curated emphasis is not enough and you need the exhaustive schema-derived board.
Use this section when…
| If you need to answer… | Start here |
|---|---|
| “What does the warehouse look like at a glance?” | ER Diagram |
| “How does data move from source to export?” | Pipeline Flow |
| “Which endpoint family feeds this table?” | Endpoint Map |
| “Where is the full schema-derived entity inventory?” | Auto ER Diagram |
Pick the Right Board
| Lens | Page | Best for |
|---|---|---|
| Whiteboard | ER Diagram | Understanding how the core dimensions, facts, and bridges fit together |
| Generator board | Auto ER Diagram | Inspecting the full schema-derived entity inventory without curation |
| Playbook | Pipeline Flow | Tracing how raw NBA API extracts become analytical outputs |
| Shot-chart overlay | Endpoint Map | Mapping endpoint families to their landing tables |
Whiteboard the warehouse
Open ER Diagram when you need the quickest read on which dimensions anchor the model, where the busiest fact clusters live, and how the bridge tables keep the joins honest.
Run the full playbook
Go to Pipeline Flow when the question is about movement: how raw feeds become staging tables, where validation stops a bad possession, and which stages produce the public warehouse surface.
Trace source coverage
Use Endpoint Map when you know the source family or target table and need to reconnect extractors, result sets, and landing surfaces without reading transform code first.
Companion board
| Page | Ownership | Use it when |
|---|---|---|
| Auto ER Diagram | Generated from schema definitions | You need the exhaustive entity inventory rather than the curated whiteboard read |
Next steps from diagrams
Turn the board into join decisions
Continue to Relationships or the broader Schema Reference when the diagram has answered the shape question and you now need to plan the actual SQL path.
Switch from shape to dependency replay
Move to Lineage when you need to know not just what connects, but how a source feed or staging table propagates into downstream facts, aggregates, and analytics outputs.
Reconnect the picture to live source families
Jump to Endpoints when the visual board raises a coverage question and you need the page-by-page scouting report for the nba_api surface behind it.
Keep moving
Stay in the same possession
Keep the mental model warm with adjacent pages, section hubs, and search-friendly routes into the same topic cluster.