chore: initial repo setup (.gitignore, README, CLAUDE.md)

2026-05-05 00:31:54 +03:00
commit a2396a39a7
3 changed files with 244 additions and 0 deletions
@@ -0,0 +1,56 @@
+# maraphon-app
+
+Sports betting odds analyzer for [marathonbet.by](https://www.marathonbet.by).
+
+Scrapes pre-match (`/su`) and live (`/su/live`) sports events, tracks coefficient changes
+over time, and detects anomalies — in particular the "odds-flip" pattern where the
+bookmaker freezes betting and then inverts underdog/favorite odds.
+
+## Tech stack
+
+- **.NET 8** + C# 12
+- **Blazor Hybrid** — WPF shell hosting `BlazorWebView` (designed to migrate to ASP.NET
+  Core Blazor Server with no UI rewrite)
+- **EF Core + SQLite** (WAL mode) for local storage
+- **ClosedXML** for Excel export
+- **AngleSharp** for HTML scraping (with **Playwright** fallback for JS-rendered pages)
+- **Polly v8** for retry / circuit breaker / rate limiting
+- **MudBlazor** UI components, **Plotly.Blazor** for charts
+- **Serilog** structured logging
+- **xUnit / FluentAssertions / NSubstitute** for tests
+
+## Project layout
+
+```
+src/
+  Marathon.Domain/         entities, value objects, no dependencies
+  Marathon.Application/    use cases, abstractions (IOddsScraper, IRepository, ...)
+  Marathon.Infrastructure/ EF Core, scraping, Polly, Excel, Playwright
+  Marathon.UI/             Razor Class Library — all Blazor components live here
+  Marathon.Hosts.WpfBlazor/ WPF + BlazorWebView host (replaceable for web)
+tests/
+  Marathon.*.Tests/        unit + integration tests per layer
+```
+
+## Build & run
+
+```pwsh
+dotnet build Marathon.sln
+dotnet test  Marathon.sln
+dotnet run   --project src/Marathon.Hosts.WpfBlazor
+```
+
+## Configuration
+
+All variable parameters (polling intervals, concurrency, user-agents, retry policy,
+snapshot retention, locale) are exposed via `appsettings.json` and live-editable via
+the in-app **Settings** page.
+
+## Status
+
+🟡 In active development. See [`plans/initial-implementation/PLAN.md`](plans/initial-implementation/PLAN.md)
+for the current phase plan and progress.
+
+## License
+
+Private — customer project.