NNutmeg概率预测工作台

Provider Ops

数据源状态、赛事准入、ID 映射和快照覆盖率用于支撑赛前预测链路的可追踪性。 这里不执行同步任务，也不包含自动投注能力。

Fallback dataFresh生成 05/06 20:45
已激活数据源
1
待审核数据源
4
映射实体
0
映射审核问题
1
冲突事件
0
Open 冲突
0
Beta Ready
1
真实 Key
0/4
授权复核到期
0
Ops 审计事件
0
Helper Runs
0
Runtime 异常
3
Provider Ops AccessAdmin controls lockedtoken configured

Provider Ops 的写入型工具需要先解锁；未解锁时页面只展示只读状态和合规提示。

Access token is never rendered back to the browser.

Provider Helper Run History

VPS helper 和 cron 的运行摘要；只记录状态、耗时和非敏感输出片段。

locked run loglatest nonelatest none

Admin controls locked. Unlock Provider Ops to view helper run history.

Provider Ops Audit Trail

记录 Provider Ops unlock、lock 和管理动作入口；不记录 API key、token 或 secret 值。

locked audit loglatest none

Admin controls locked. Unlock Provider Ops to view the audited operation log.

Provider Ops Runbook

从数据源 key、映射审核、赔率覆盖到 prediction gate 的当前链路状态。

ready 1/5current Runtime keyschecked 05/06 20:45

Runtime keys

needs review

0 of 4 external providers are safe for real dry-run calls.

real keys
0/4
mock dry-run
enabled
可先用 deterministic mock dry-run；提交写入前补齐 provider key。
01

Fixture mappings

blocked

The Odds API fixture mappings are not available yet.

mappings
0
review issues
0
先执行 mapping bootstrap/review，处理低置信度或碰撞映射。
02

Odds coverage

blocked

EPL coverage report has 0 odds snapshots and 0 fixture gaps.

1X2 odds
0%
handicap
0%
freshness
0%
gaps
0
先处理 Odds Coverage Gaps；通过审核后再用受保护路径写入 odds snapshots。
03

Prediction gate

needs review

Latest dry-run generated 2 predictions and skipped 1 fixtures.

generated
2
skipped
1
运行 Prediction Quality Gate dry-run，重点检查 odds gate skips 和 warnings。
04

Conflict governance

ready

No persisted open provider conflicts are blocking the current chain.

open
0
consistency
100%
保持 trusted provider priority 可审计。
05

Provider 授权状态

不显示 API key 值，仅显示环境变量引用与能力范围。

Provider 授权、能力与数据保留状态。
Provider状态能力商业使用保留快照使用策略复核历史/再分发Key 引用Owner备注
api-football05/08 08:00
review
competitionsseasonsfixturesresults
reviewreview
fixture_result_fallback_research_dry_runfree_plan_provider_defined
05/08 08:00due 11/04 08:00
history noredistribute no
API_FOOTBALL_API_KEYnutmeg-opsCandidate broad fixture/result fallback; free plan can be season-limited.
football-data.org05/06 08:00
review
competitionsseasonsfixturesresults
reviewreview
fixtures_results_research_dry_runfree_plan_provider_defined
05/06 08:00due 11/02 08:00
history noredistribute no
FOOTBALL_DATA_API_KEYnutmeg-opsCandidate schedule/result provider; legal and retention review required before production.
mock-local05/06 08:00
active
competitionsseasonsfixturesfixture_detailresultsoddslineupsinjuriesteam_stats
yesyes
local_development_and_testnone
05/06 08:00due 11/02 08:00
history yesredistribute yes
N/Anutmeg-opsLocal deterministic fixture provider for development and tests.
sportmonks05/06 08:00
review
fixturesresultsoddslineupsinjuriesteam_stats
reviewreview
broad_coverage_trial_researchtrial_plan_provider_defined
05/06 08:00due 11/02 08:00
history noredistribute no
SPORTMONKS_API_KEYnutmeg-opsCandidate broad coverage provider; production use requires explicit plan and contract check.
the-odds-api05/06 08:00
review
odds
reviewreview
odds_snapshot_research_dry_runfree_plan_provider_defined
05/06 08:00due 11/02 08:00
history noredistribute no
THE_ODDS_API_KEYnutmeg-opsCandidate odds provider; verify historical snapshot retention terms.

Provider Terms Review

Admin 审计链；记录条款复核、数据保留、历史数据和再分发许可，不显示任何 secret 值。

fallback review logdue 0latest 05/08 08:00
Admin controls locked. Unlock Provider Ops to use this audited operation.
Provider 条款复核、授权决策和证据载荷。
ProviderReviewReviewed使用策略数据权限下次复核证据备注
api-footballseed-api-football
review
05/08 08:00nutmeg-ops
fixture_result_fallback_research_dry_runfree_plan_provider_defined
commercial noretain nohistory noredistribute no
11/04 08:00sourceCandidate broad fixture/result fallback; free plan can be season-limited.
the-odds-apiseed-the-odds-api
review
05/06 08:00nutmeg-ops
odds_snapshot_research_dry_runfree_plan_provider_defined
commercial noretain nohistory noredistribute no
11/02 08:00sourceCandidate odds provider; historical snapshot retention must be verified.

Runtime key readiness

受 admin token 保护；只显示 key 是否配置和 dry-run 路径，不显示任何 secret 值。

fallback runtime viewmock dry-run enabledchecked 05/06 20:45
Runtime key readiness for explicit provider sync operations.
ProviderKeyDry-runCommit真实请求Runtime env下一步
api-footballcompetitions, seasons, fixtures, results
reviewmock sampleblockedreviewNUTMEG_API_FOOTBALL_API_KEY
真实同步前需配置 API keyruntime_credentials_unavailable · secret_value_not_exposed
football-data.orgcompetitions, seasons, fixtures, results
reviewmock sampleblockedreviewNUTMEG_FOOTBALL_DATA_API_KEY
真实同步前需配置 API keyruntime_credentials_unavailable · secret_value_not_exposed
mock-localcompetitions, seasons, fixtures, fixture_detail
yeslocal onlyN/AreviewN/A
本地确定性测试可用deterministic_local_provider · no_external_request
sportmonksfixtures, results, odds, lineups
reviewmock sampleblockedreviewNUTMEG_SPORTMONKS_API_KEY
真实同步前需配置 API keyruntime_credentials_unavailable · secret_value_not_exposed
the-odds-apiodds
reviewmock sampleblockedreviewNUTMEG_THE_ODDS_API_KEY
真实同步前需配置 API keyruntime_credentials_unavailable · secret_value_not_exposed

Provider Runtime Monitor

只读运行快照：provider probe 状态、延迟、错误率和限流信号；不显示任何 secret 值。

fallback monitordegraded 3rate limited 0alert P1avg latency N/Achecked 05/08 11:32
P1 fallback usageP2 runtime readiness / football-data.org
Provider runtime monitoring snapshots for read-only operations.
ProviderStatusLatencyError rateQuotaFallbackObservedNext action
mock-localdeterministic_fixture
key configuredLocal deterministic provider is available for dry-run workflows.
N/A0.0%provider definedreview05/08 11:32无需动作
football-data.orgfixtures_results
not configuredRuntime key is unavailable in fallback Provider Ops data.
N/AN/Aprovider definedyes05/08 11:32配置 runtime key
the-odds-apiodds
not configuredRuntime key is unavailable in fallback Provider Ops data.
N/AN/Aprovider definedyes05/08 11:32配置 runtime key
sportmonkslineups_injuries
not configuredRuntime key is unavailable in fallback Provider Ops data.
N/AN/Aprovider definedyes05/08 11:32配置 runtime key

Provider Runtime Incidents

Admin 只读 incident reports；保存 runtime alert 摘要、阈值和来源，不保存 provider secret。

fallback incidentslatest noneactive 0P1 0P2 0MTTR N/Areports 0lookback 30d
active window 0open 0ack 0resolved 0ignored 0notify failed 0

No runtime incident trend buckets in the last 30 days.

Runtime Incident Runbookclear
  1. 保持 30 分钟 runtime monitor cron；下一次 provider 降级时自动生成 incident 证据。
  2. 复核最近一条 resolved/ignored incident 的处置备注与 notification payload，确认没有 provider secret 泄露。
  3. 继续观察趋势窗口，若连续多个日期出现 P1/P2，再进入 provider coverage 排查。
Incident filtersshowing 0/0offset 820
allopenacknowledgedresolvedignored
alert allalert P1alert P2alert P0alert oknotify allnotify failednotify sentnotify skippednotify queuednotify not_configured
Previous incidentsNext incidentsReset incident filters
Admin controls locked. Unlock Provider Ops to use this audited operation.

No runtime incident reports recorded.

Free API application checklist

先申请免费或试用 key；足球赔率 free tier 可能不足，页面会标出限制。

fallback checklistchecked 05/06 20:45
Free or trial data-source API application checklist.
优先级ProviderAdapterFree fitKeyEnv申请下一步
1
football-data.orgfixtures/results dry-run
supportedfree okreviewNUTMEG_FOOTBALL_DATA_API_KEY
ApplyDocs
先申请 football-data.org free keyFree registered clients are suitable for initial fixtures/results dry-runs.
2
api-footballbroad fixtures candidate
supportedfree okreviewNUTMEG_API_FOOTBALL_API_KEY
ApplyDocs
配置 API-Football free keyFree API-Football access is useful for fixture coverage research and fallback mapping dry-runs.
3
sportmonkslineups/injuries
supportedtrialreviewNUTMEG_SPORTMONKS_API_KEY
ApplyDocs
申请 SportMonks trial keyUse a free trial key first for lineup and injury dry-runs.
4
the-odds-apiodds snapshots
supportedsoccer limitedreviewNUTMEG_THE_ODDS_API_KEY
ApplyDocs
可先申请 The Odds API free keyFree tier is useful for key plumbing, but soccer coverage may be limited.

赛事准入状态

准入结果来自数据质量、覆盖率、样本量和规则测试证据。

赛事准入状态与关键覆盖率。
赛事阶段结果质量赛程赔率阵容/伤停新鲜度阻塞项
Premier LeagueEPL
betabeta ready71.8QB99%61%70%0%clear

Provider 映射摘要

用于核对 provider ID 与 Nutmeg canonical ID 的关联覆盖。

按 provider 和实体类型聚合的映射统计。
Provider实体类型数量平均置信度最低置信度最近更新
暂无 provider 映射摘要

Provider 映射审核

低置信度、同 provider canonical 碰撞与陈旧映射进入人工复核队列；页面只展示审核证据。

dry run yes检查 422critical 1warning 0as of 07/03 15:50
Provider mapping review issues for manual reconciliation.
严重度类型Provider实体Canonical IDProvider IDs最低置信度建议动作
criticalCanonical 碰撞football-data.orgcompetitionEPL2021, PL100%
confirm_or_split_canonical_mapping05/08 03:06

Provider Sync Workflow

只运行 dry-run，所有 provider IDs 由 operator 显式填写。

Admin controls locked. Unlock Provider Ops to use this audited operation.

Mapped Odds Sync

基于已审核的 fixture mappings 批量检查 The Odds API 赔率，不写入 odds snapshots。

Admin controls locked. Unlock Provider Ops to use this audited operation.

Prediction Quality Gate

使用已存储赔率快照做 canonical prediction dry-run，暴露 odds gate skips 与 warning。

Admin controls locked. Unlock Provider Ops to use this audited operation.

Odds Coverage Gaps

只读报告：把 fixture 覆盖、The Odds API 映射和快照新鲜度合并，定位 no odds 与 stale odds 缺口。

live gap reportgap fixtures 0no odds 0stale 0event unavailable 0unmapped 0max lag 168h
Fixture odds coverage gaps.
FixtureKickoffIssuesMappingOddsLatestNext
当前窗口没有赔率覆盖缺口

Fallback Odds Probe

只读探测：检查 SportMonks 是否具备修复 provider event unavailable 缺口的映射与赔率覆盖。

fallback probekey missingmapped 0recoverable 0checked 1
SportMonks fallback odds probe.
FixtureStatusMappingProbeOddsNext
Arsenal vs Brightonfd_fixture_missing_odds
Mapping missing
mapping required
live nokey missing
00 books / none
补齐 SportMonks fixture mappingmissing_sportmonks_fixture_mapping

Provider 冲突治理

trusted provider priority 用于解释冲突归因，并给出 provider consistency 对数据质量的影响。

dry run yes检查 issue 0conflict 0quality 0.0consistency 100%persisted open 0resolved 0
Admin controls locked. Unlock Provider Ops to use this audited operation.
Persisted provider conflict event status.
ID状态严重度类型Canonical IDProviders创建解决
暂无持久化 provider conflict event
Dry-run provider conflict events derived from current review evidence.
严重度类型实体Canonical IDProvidersTrusted质量影响证据动作
当前未发现需要记录的 provider 冲突事件
Trusted provider priority policy used for conflict interpretation.
CapabilityProviderRankReason

最近映射关系

映射写入来自受控 provider sync 流程。

最近 provider entity mapping 记录。
IDProvider类型Provider IDCanonical ID置信度更新
暂无 provider 映射记录