NNutmeg概率预测工作台

Provider Ops

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

Fallback dataFresh生成 05/06 20:45
已激活数据源
1
待审核数据源
4
映射实体
2
映射审核问题
1
冲突事件
1
Open 冲突
1
Beta Ready
1
真实 Key
0/3
授权复核到期
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 3 external providers are safe for real dry-run calls.

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

Fixture mappings

ready

1 reviewed The Odds API fixture mappings are available for eventIds batch checks.

mappings
1
review issues
0
可运行 Mapped Odds Sync dry-run 检查最新赔率覆盖。
02

Odds coverage

needs review

EPL beta gate is available, but live odds coverage report was not fetched.

1X2 odds
0%
handicap
0%
freshness
0%
gaps
2
先处理 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

needs review

1 open provider conflicts still need operator resolution.

open
1
consistency
85%
先处理 open conflicts，再让 provider consistency 参与 feature snapshot。
05

Provider 授权状态

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

Provider 授权、能力与数据保留状态。
Provider状态能力商业使用保留快照使用策略复核历史/再分发Key 引用Owner备注
mock-local05/06 08:00
active
fixturesresultsoddslineupsinjuries
yesyes
local_development_and_testnone
05/06 08:00due 05/06 08:00
history yesredistribute yes
N/Anutmeg-opsLocal deterministic fixture provider for development and tests.
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; terms and retention review required.
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; historical snapshot retention must be verified.
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 review.
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.

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/08 11:30
Runtime key readiness for explicit provider sync operations.
ProviderKeyDry-runCommit真实请求Runtime env下一步
mock-localfixtures, results, odds, lineups
yeslocal onlyN/AreviewN/A
本地确定性测试可用deterministic_local_provider · no_external_request
football-data.orgcompetitions, seasons, fixtures, results
reviewmock sampleblockedreviewNUTMEG_FOOTBALL_DATA_API_KEY
真实同步前需配置 API keydry_run_uses_deterministic_sample · commit_sync_requires_api_key
the-odds-apiodds
reviewmock sampleblockedreviewNUTMEG_THE_ODDS_API_KEY
真实同步前需配置 API keydry_run_uses_deterministic_sample · commit_sync_requires_api_key
sportmonksfixtures, results, odds, lineups
reviewmock sampleblockedreviewNUTMEG_SPORTMONKS_API_KEY
真实同步前需配置 API keydry_run_uses_deterministic_sample · commit_sync_requires_api_key

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 0
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/08 11:35
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 ready80.4QB100%72%70%88%clear
J1 LeagueJPN_J1
betanot ready57.1QC96%48%35%64%
  • schedule_coverage_below_98
  • odds_coverage_below_60

Provider 映射摘要

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

按 provider 和实体类型聚合的映射统计。
Provider实体类型数量平均置信度最低置信度最近更新
football-data.orgfixture1100%100%05/08 09:05
the-odds-apifixture1100%100%05/08 09:10

Provider 映射审核

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

dry run yes检查 2critical 0warning 1as of 05/08 10:00
Provider mapping review issues for manual reconciliation.
严重度类型Provider实体Canonical IDProvider IDs最低置信度建议动作
warningCanonical 碰撞football-data.orgfixturefd_fixture_330299330299, 330299-alt91%
confirm_or_split_canonical_mapping05/08 09:05

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 缺口。

fallback gap reportgap fixtures 2no odds 1stale 1event unavailable 1unmapped 1max lag 168h
Fixture odds coverage gaps.
FixtureKickoffIssuesMappingOddsLatestNext
Arsenal vs Brightonfd_fixture_missing_odds
05/10 22:00
UnmappedProvider event unavailableNo odds
unmappedthe-odds-api
00 books / none
staleN/A
检查 fallback provider event mappingthe-odds-api has no mapped event for this fixture in the current provider-event bootstrap window; check fallback provider coverage.fallback: api-football (supported), sportmonks (supported)
Chelsea vs Evertonfd_fixture_stale_odds
05/12 03:00
Stale oddsMissing market
mappedfallback-event-297%
31 books / 1x2
stale317.0h
刷新 mapped event odds

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 1conflict 1quality -1.5consistency 85%persisted open 1resolved 0
Admin controls locked. Unlock Provider Ops to use this audited operation.
Persisted provider conflict event status.
ID状态严重度类型Canonical IDProviders创建解决
601openwarning映射冲突fd_fixture_330299football-data.org05/08 10:05N/A
Dry-run provider conflict events derived from current review evidence.
严重度类型实体Canonical IDProvidersTrusted质量影响证据动作
warning映射冲突fixturefd_fixture_330299football-data.orgfootball-data.org-1.5fallback-review-1confirm_or_split_canonical_mapping
Trusted provider priority policy used for conflict interpretation.
CapabilityProviderRankReason
mappingfootball-data.org10fixture_mapping_reference
mappingsportmonks20secondary_mapping_reference

最近映射关系

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

最近 provider entity mapping 记录。
IDProvider类型Provider IDCanonical ID置信度更新
101football-data.orgfixture330299fd_fixture_330299100%05/08 09:05
102the-odds-apifixtureevent_123fd_fixture_330299100%05/08 09:10