# sunmer/social-casino-index architecture

> Architecture diagram of the GitHub repository sunmer/social-casino-index, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sunmer/social-casino-index
- Repository: https://github.com/sunmer/social-casino-index

## Overview

Social Casino Index is a static comparison and answer site for social-casino offers, redemption thresholds, and payout methods, with an MCP interface to its published toplist. Its monitoring subsystem gathers and evaluates published evidence; benchmark modeling feeds ranked/product views and answer-page data consumed by Eleventy. The available excerpts show these data/model and rendering relationships, but not the full collection or publication runtime, so those links are limited to explicit references.

Main entry points: [`scripts/monitor/benchmarks.mjs`](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/benchmarks.mjs) (Benchmark model), [`scripts/monitor/run.mjs`](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/run.mjs) (Monitoring workflow), [`scripts/monitor/answer-pages.mjs`](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/answer-pages.mjs) (Answer pages), [`eleventy.config.js`](https://github.com/sunmer/social-casino-index/blob/main/eleventy.config.js) (Static site rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitor["Evidence monitoring"]
  node_monitor_run["Monitoring workflow<br/>[run.mjs]"]
  node_discovery["Source discovery<br/>[discovery.mjs]"]
  node_providers["Evidence providers<br/>[providers.mjs]"]
  node_numeric["Numeric extraction<br/>[numeric-core.mjs]"]
  node_archive[("Capture archive<br/>[archive.mjs]")]
  node_schema["Evidence schema<br/>[schema.mjs]"]
  node_review["Evidence review<br/>[review-core.mjs]"]
  node_publication["Publication model"]
end

subgraph group_models["Comparison models"]
  node_benchmarks["Benchmark model<br/>[benchmarks.mjs]"]
  node_toplist["Ranked toplist<br/>[toplist.mjs]"]
  node_product["Product views<br/>[product-view.mjs]"]
  node_answers["Answer pages<br/>[answer-pages.mjs]"]
  node_presentation["Toplist presentation"]
end

subgraph group_site["Published site"]
  node_eleventy["Static site rendering<br/>[eleventy.config.js]"]
  node_answer_data["Answer-page data"]
  node_comparison_data["Comparison data"]
  node_updates_data["Updates and player answers"]
  node_redemption_data["Low redemption data"]
end

subgraph group_access["Data access"]
  node_mcp["MCP server<br/>[server.mjs]"]
  node_published_data[("Published toplist JSON")]
end

node_operator(("Casino operators"))
node_mcp_client(("MCP client"))

node_operator -.->|"publishes information"| node_discovery
node_monitor_run -.->|"coordinates discovery"| node_discovery
node_monitor_run -.->|"runs extraction"| node_numeric
node_monitor_run -.->|"coordinates review"| node_review
node_monitor_run -.->|"coordinates publication"| node_publication
node_discovery -.->|"finds sources"| node_providers
node_providers -.->|"archives captures"| node_archive
node_numeric -.->|"validates against"| node_schema
node_review -.->|"evaluates extracted evidence"| node_numeric
node_publication -.->|"provides published evidence"| node_benchmarks
node_benchmarks -->|"builds"| node_toplist
node_benchmarks -->|"attaches product views"| node_product
node_benchmarks -.->|"uses daily semantics"| node_presentation
node_eleventy -->|"registers page filters"| node_answers
node_eleventy -->|"uses CSV view"| node_product
node_eleventy -.->|"renders computed data"| node_updates_data
node_answer_data -->|"builds answer data"| node_answers
node_comparison_data -->|"builds comparison answers"| node_answers
node_redemption_data -->|"builds low-redemption answers"| node_answers
node_updates_data -->|"builds benchmark sections"| node_benchmarks
node_mcp -->|"fetches toplist JSON"| node_published_data
node_mcp_client -.->|"sends requests"| node_mcp

click node_monitor_run "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/run.mjs"
click node_discovery "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/discovery.mjs"
click node_providers "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/providers.mjs"
click node_numeric "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/numeric-core.mjs"
click node_archive "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/archive.mjs"
click node_schema "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/schema.mjs"
click node_review "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/review-core.mjs"
click node_publication "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/publication-core.mjs"
click node_benchmarks "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/benchmarks.mjs"
click node_toplist "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/toplist.mjs"
click node_product "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/product-view.mjs"
click node_answers "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/answer-pages.mjs"
click node_presentation "https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/toplist-presentation.mjs"
click node_eleventy "https://github.com/sunmer/social-casino-index/blob/main/eleventy.config.js"
click node_answer_data "https://github.com/sunmer/social-casino-index/blob/main/src/redemption-times/redemption-times.11tydata.js"
click node_comparison_data "https://github.com/sunmer/social-casino-index/blob/main/src/compare/compare.11tydata.js"
click node_updates_data "https://github.com/sunmer/social-casino-index/blob/main/src/updates/updates.11tydata.js"
click node_redemption_data "https://github.com/sunmer/social-casino-index/blob/main/src/bonuses/under-50-sc.11tydata.js"
click node_mcp "https://github.com/sunmer/social-casino-index/blob/main/mcp/server.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_monitor_run,node_discovery,node_providers,node_numeric,node_archive,node_schema,node_review,node_publication,node_mcp_client toneBlue
class node_benchmarks,node_toplist,node_product,node_answers,node_presentation toneAmber
class node_eleventy,node_answer_data,node_comparison_data,node_updates_data,node_redemption_data toneMint
class node_mcp,node_published_data toneRose
class node_operator toneIndigo
```

## Components

### Evidence monitoring

- [Monitoring workflow](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/run.mjs): `scripts/monitor/run.mjs`
- [Source discovery](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/discovery.mjs): `scripts/monitor/discovery.mjs`
- [Evidence providers](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/providers.mjs): `scripts/monitor/providers.mjs`
- [Numeric extraction](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/numeric-core.mjs): `scripts/monitor/numeric-core.mjs`
- [Capture archive](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/archive.mjs): `scripts/monitor/archive.mjs`
- [Evidence schema](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/schema.mjs): `scripts/monitor/schema.mjs`
- [Evidence review](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/review-core.mjs): `scripts/monitor/review-core.mjs`
- [Publication model](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/publication-core.mjs): `scripts/monitor/publication-core.mjs`

### Comparison models

- [Benchmark model](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/benchmarks.mjs): `scripts/monitor/benchmarks.mjs`
- [Ranked toplist](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/toplist.mjs): `scripts/monitor/toplist.mjs`
- [Product views](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/product-view.mjs): `scripts/monitor/product-view.mjs`
- [Answer pages](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/answer-pages.mjs): `scripts/monitor/answer-pages.mjs`
- [Toplist presentation](https://github.com/sunmer/social-casino-index/blob/main/scripts/monitor/toplist-presentation.mjs): `scripts/monitor/toplist-presentation.mjs`

### Published site

- [Static site rendering](https://github.com/sunmer/social-casino-index/blob/main/eleventy.config.js): `eleventy.config.js`
- [Answer-page data](https://github.com/sunmer/social-casino-index/blob/main/src/redemption-times/redemption-times.11tydata.js): `src/redemption-times/redemption-times.11tydata.js`
- [Comparison data](https://github.com/sunmer/social-casino-index/blob/main/src/compare/compare.11tydata.js): `src/compare/compare.11tydata.js`
- [Updates and player answers](https://github.com/sunmer/social-casino-index/blob/main/src/updates/updates.11tydata.js): `src/updates/updates.11tydata.js`
- [Low redemption data](https://github.com/sunmer/social-casino-index/blob/main/src/bonuses/under-50-sc.11tydata.js): `src/bonuses/under-50-sc.11tydata.js`

### Data access

- [MCP server](https://github.com/sunmer/social-casino-index/blob/main/mcp/server.mjs): `mcp/server.mjs`
- **Published toplist JSON**

### Other components

- **Casino operators**
- **MCP client**

## Connections

- Casino operators → Source discovery: publishes information
- Monitoring workflow → Source discovery: coordinates discovery
- Monitoring workflow → Numeric extraction: runs extraction
- Monitoring workflow → Evidence review: coordinates review
- Monitoring workflow → Publication model: coordinates publication
- Source discovery → Evidence providers: finds sources
- Evidence providers → Capture archive: archives captures
- Numeric extraction → Evidence schema: validates against
- Evidence review → Numeric extraction: evaluates extracted evidence
- Publication model → Benchmark model: provides published evidence
- Benchmark model → Ranked toplist: builds (evidence: `scripts/monitor/benchmarks.mjs`)
- Benchmark model → Product views: attaches product views (evidence: `scripts/monitor/benchmarks.mjs`)
- Benchmark model → Toplist presentation: uses daily semantics
- Static site rendering → Answer pages: registers page filters (evidence: `eleventy.config.js`)
- Static site rendering → Product views: uses CSV view (evidence: `eleventy.config.js`)
- Static site rendering → Updates and player answers: renders computed data
- Answer-page data → Answer pages: builds answer data (evidence: `src/redemption-times/redemption-times.11tydata.js`)
- Comparison data → Answer pages: builds comparison answers (evidence: `src/compare/compare.11tydata.js`)
- Low redemption data → Answer pages: builds low-redemption answers (evidence: `src/bonuses/under-50-sc.11tydata.js`)
- Updates and player answers → Benchmark model: builds benchmark sections (evidence: `src/updates/updates.11tydata.js`)
- MCP server → Published toplist JSON: fetches toplist JSON (evidence: `mcp/server.mjs`)
- MCP client → MCP server: sends requests
