每日计划:代码部署后继续读取有效期内旧计划(台账 064)
一、统一旧计划兼容读取\n已发布计划独立于当前代码版本。直接读取最新旧格式快照不再因部署哈希变化而失败,保留原代码版本与追溯不完整标记;查询仍禁止现装配。\n\n二、验证与边界\n隔离配置、禁止联网的契约入口通过 33 个用例或断言组。新增跨代码版本读取测试,验证最新与日期查询一致、源查询和装配被禁止、原文件字节不变。\n\n三、保持的行为\n旧格式快照的十六小时时限与未来时间检查保留,候选规则、排序开关、完整版本发布及交易阈值不变。
This commit is contained in:
parent
69ce95f662
commit
fe443f63f3
34
plan.py
34
plan.py
|
|
@ -996,38 +996,22 @@ def render_md(d: dict) -> str:
|
||||||
|
|
||||||
|
|
||||||
class StaleSnapshot(RuntimeError):
|
class StaleSnapshot(RuntimeError):
|
||||||
"""快照还在,但太旧、不能拿来当今天的计划用。调用方接住它回落到实时装配。"""
|
"""旧快照无法证明在有效期内;查询明确失败,不回落实时装配。"""
|
||||||
|
|
||||||
|
|
||||||
def snapshot_fresh_enough(snap: dict) -> tuple:
|
def snapshot_fresh_enough(snap: dict) -> tuple:
|
||||||
"""这份快照够不够新,能不能当今天的计划直接下发。返回 (能不能, 一句原因)。
|
"""旧格式快照的时间守卫,返回 (是否可用, 原因)。
|
||||||
|
|
||||||
为什么需要这道守卫(2026-09-10,台账 057): 快照是出计划那一刻的定格,而实时装配读的是
|
2026-10-15,台账 064:已发布内容与代码部署相互独立。新代码仍可读有效期内
|
||||||
此刻的证据线。实测两条路比对,代码序列一模一样,但候选卡名次、判决、依据这些字段会有
|
的旧计划,保留原 plan_version 并注明追溯不完整,不能因代码版本不同而失效,
|
||||||
实质差异 —— 快照出得越早、差得越多。拿一份过时的快照下发,等于让下游用旧判决。
|
也不能查询时用当前证据重装配。新完整版本不使用旧格式的这道兼容守卫。
|
||||||
|
|
||||||
两条判据,任一不满足就退回实时装配(也就是这次改动之前的行为,不会变坏):
|
沿用 PLAN_SNAPSHOT_MAX_AGE_HOURS(默认十六小时)及未来时刻检查。
|
||||||
· 代码版本要和现在跑的一致。版本变了说明判决逻辑可能变了,用旧代码算的那份不算数。
|
有时区的生成时刻按自身时区算经过时间;旧无时区值保持原运行时解释,不能
|
||||||
正常情况下两者相同——出计划任务和接口进程跑的是同一份部署;只有"刚部署了新代码、
|
为旧档补造时区或新的决策版本。显式历史查询不受当前时间限制。
|
||||||
还没重新出计划"这个窗口里会不一致,而那正是该回落的时候。
|
|
||||||
· 生成时刻距今不超过 PLAN_SNAPSHOT_MAX_AGE_HOURS 小时(默认十六)。
|
|
||||||
|
|
||||||
**时间判据用的是"距今多久",不是"晚于今天几点"**:容器跑在世界协调时上(实测
|
|
||||||
2026-09-10 早上七点十分出的计划,快照里记的是 2026-09-09T23:10),拿本地日期算界会
|
|
||||||
差八小时,把新鲜的快照判成过期。距今多久与时区无关,怎么部署都不会算错。
|
|
||||||
"""
|
"""
|
||||||
import version
|
|
||||||
max_age_h = float(os.environ.get("PLAN_SNAPSHOT_MAX_AGE_HOURS", "16"))
|
max_age_h = float(os.environ.get("PLAN_SNAPSHOT_MAX_AGE_HOURS", "16"))
|
||||||
gen = str(snap.get("generated_at") or "")
|
gen = str(snap.get("generated_at") or "")
|
||||||
ver = str(snap.get("plan_version") or "")
|
|
||||||
now_ver = ""
|
|
||||||
try:
|
|
||||||
now_ver = str(version.git_short_rev() or "")
|
|
||||||
except Exception: # noqa: BLE001 —— 取不到版本就不拿这条卡人
|
|
||||||
now_ver = ""
|
|
||||||
if now_ver and ver and ver != now_ver:
|
|
||||||
return False, (f"快照是用代码版本 {ver} 出的,现在跑的是 {now_ver};"
|
|
||||||
f"判决逻辑可能已经变了,本次按实时装配")
|
|
||||||
if not gen:
|
if not gen:
|
||||||
return False, "快照没有生成时刻,判不了新旧"
|
return False, "快照没有生成时刻,判不了新旧"
|
||||||
try:
|
try:
|
||||||
|
|
@ -1037,7 +1021,7 @@ def snapshot_fresh_enough(snap: dict) -> tuple:
|
||||||
age_h = (dt.datetime.now(g.tzinfo) - g).total_seconds() / 3600.0
|
age_h = (dt.datetime.now(g.tzinfo) - g).total_seconds() / 3600.0
|
||||||
if age_h > max_age_h:
|
if age_h > max_age_h:
|
||||||
return False, (f"快照出于 {gen},距今 {age_h:.1f} 小时,超过 {max_age_h:g} 小时的界;"
|
return False, (f"快照出于 {gen},距今 {age_h:.1f} 小时,超过 {max_age_h:g} 小时的界;"
|
||||||
f"证据线可能已经变了,本次按实时装配")
|
f"请检查已发布计划,查询不会实时重装配")
|
||||||
if age_h < -1: # 生成时刻在未来:多半是两边时区不一致,别当新鲜的用
|
if age_h < -1: # 生成时刻在未来:多半是两边时区不一致,别当新鲜的用
|
||||||
return False, f"快照的生成时刻 {gen} 在未来 {-age_h:.1f} 小时,判不了新旧"
|
return False, f"快照的生成时刻 {gen} 在未来 {-age_h:.1f} 小时,判不了新旧"
|
||||||
return True, ""
|
return True, ""
|
||||||
|
|
|
||||||
|
|
@ -158,7 +158,7 @@ def test_freshness_guard():
|
||||||
if cur:
|
if cur:
|
||||||
ok3, why3 = plan.snapshot_fresh_enough(
|
ok3, why3 = plan.snapshot_fresh_enough(
|
||||||
snap((now - _dt.timedelta(hours=2)).isoformat(timespec="seconds"), "deadbee"))
|
snap((now - _dt.timedelta(hours=2)).isoformat(timespec="seconds"), "deadbee"))
|
||||||
t("代码版本对不上就不可用(判决逻辑可能变了)", not ok3 and "代码版本" in why3, why3)
|
t("代码部署不让有效期内已发布的旧计划失效", ok3, why3)
|
||||||
|
|
||||||
ok4, _ = plan.snapshot_fresh_enough(snap(""))
|
ok4, _ = plan.snapshot_fresh_enough(snap(""))
|
||||||
t("没有生成时刻的快照不可用", not ok4)
|
t("没有生成时刻的快照不可用", not ok4)
|
||||||
|
|
|
||||||
|
|
@ -126,6 +126,26 @@ class VersionsTest(unittest.TestCase):
|
||||||
self.assertEqual(small['main'][0]['research_rank'], big['main'][0]['research_rank'])
|
self.assertEqual(small['main'][0]['research_rank'], big['main'][0]['research_rank'])
|
||||||
self.assertEqual(big['main'][1]['research_rank'], 2)
|
self.assertEqual(big['main'][1]['research_rank'], 2)
|
||||||
|
|
||||||
|
def test_latest_legacy_survives_code_deployment_without_reassembly(self):
|
||||||
|
import version
|
||||||
|
legacy = sample()
|
||||||
|
legacy.update(plan_version='old-code', generated_at=(
|
||||||
|
dt.datetime.now(dt.timezone.utc) - dt.timedelta(hours=2)).isoformat())
|
||||||
|
path = Path(self.root) / ('plan_' + DAY + '.json')
|
||||||
|
path.write_text(json.dumps(legacy), encoding='utf-8')
|
||||||
|
original = path.read_bytes()
|
||||||
|
with patch.object(plan.config, 'PLAN_SNAPSHOT_DIR', self.root), \
|
||||||
|
patch.object(version, 'git_short_rev', return_value='new-code'), \
|
||||||
|
patch.object(plan, 'collect', side_effect=AssertionError('查询禁止重装配')), \
|
||||||
|
patch.object(plan.db, 'read_pg', side_effect=AssertionError('查询禁止回源')):
|
||||||
|
latest = plan.from_snapshot(top=1)
|
||||||
|
dated = plan.from_snapshot(DAY, top=1)
|
||||||
|
self.assertEqual(latest, dated)
|
||||||
|
self.assertEqual(latest['plan_version'], 'old-code')
|
||||||
|
self.assertEqual(latest['traceability'], 'legacy_unverified')
|
||||||
|
self.assertIsNone(latest.get('decision'))
|
||||||
|
self.assertEqual(path.read_bytes(), original)
|
||||||
|
|
||||||
def test_changed_review_all_exports_share_research(self):
|
def test_changed_review_all_exports_share_research(self):
|
||||||
a = self.publish()
|
a = self.publish()
|
||||||
p = sample()
|
p = sample()
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue