Archived
snowy-yang
da3d013e9c
模板/样式/脚本的注释里散落着「第 N 条」「F59」「P3-43」这类编号，它们指向的 修复验收台账与交接文档已在本轮删除——留着既检索不到、也对不上号，还让后来读 注释的人以为存在一份可查的编号清单。本次只动注释，正文零改动。 覆盖范围（全仓一致）： - templates/index.html 163 处、static/site_auth.js 55 处，共 218 处编号整段摘除 （含「第 N 条（Px）：」前缀与「（Fxx 短标签）」括号）。 - 容器/配置 16 处：docker-compose.yml、entrypoint.sh（F59 / 第 93 条 / 第 97 条）、 Dockerfile（T7 / 第 97 条）、.dockerignore（T1 / 第 97 条 / 第 55 条 / P2-9）、 .env.example（F59 / 第 100 条 / 「详见交接文档 F11」这条失效指引）、.gitignore（P3-41）。 - Python 4 处：core/config.py（D-1）、services/tasks.py（O-5×2）、services/_shared.py（O-5） ——上一轮 Python 侧清理的漏网。 为什么规则要收窄（两类误伤，实测踩到）： 1. 标签首字母不能用泛化的 [A-Z]：X5 是 QQ 浏览器内核、ES5 是 JS 版本，都不是编号。 泛化后会把「微信 XWeb/X5、QQ 内置」改成「微信 XWeb/、QQ 内置」，把 「Chromium <87 的老 X5 不识别 inset」改成「老 不识别」。现按本仓真实用过的 任务族白名单收窄（A B C D F O P R S T U），X5/ES5 原样保留。 2. 括号内「编号 + 长说明」不能整段删：「（F51 只防了切歌，这里补同歌翻页）」 整段删掉会连说明一起丢；现只摘编号、保留说明文字。 为什么同步改黄金契约快照：题头注释属于模板内容，改了注释首页字节数必然变 （466261 → 464333），tests/golden/responses.json 的 index 条目按既定流程刷新 html_len/html_sha256；并在 tests/test_golden.py 补一段说明，写清该条目记的是 「当前模板」而非 Flask 期数值、以及有意改模板后如何重算 （html_len = 文件字节数 - 1，sha256 = 文件去掉末尾换行后的哈希）。 验证（全部通过）： - 与 HEAD 比对：剥离全部注释后的正文逐行一致（唯一差异是删掉了一处行尾空注释）， 行数不变、每行半角括号/引号数量不变 → 代码与字符串零改动； - node --check 通过（静态 JS + index.html 内联脚本），<style> 块花括号平衡； - 真实 uvicorn 冒烟：/health /user/status /api/topen → 200、/admin/site/backup/list → 403， /static/site_auth.js 响应体与本地文件 sha1 相同，/ 无「第 N 条」残留； - ruff All checks passed；pyright 0 errors / 0 warnings；pytest 144 passed。
114 lines
4.2 KiB
Python
114 lines
4.2 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""黄金契约回归：FastAPI 严格复现 Flask 时代的响应。
|
||
|
||
tests/golden/responses.json 是**删除 Flask 之前**从 Flask 应用捕获的快照
|
||
（状态码 + 响应体）。本测试让 FastAPI（根路径模式）跑同一批请求，
|
||
逐字段断言一致——这样删除 Flask 巨石后，行为回归仍有硬证据。
|
||
|
||
说明：
|
||
- 会话 Cookie 在运行时用当前库的 login_seq 动态构造（快照不存 Cookie）。
|
||
- 请求为只读/确定性调用，不含实时上游数据（那些由 parity/单测覆盖）。
|
||
- `index` 条目的 html_len/html_sha256 记的是**当前模板**渲染结果，不是 Flask 期数值
|
||
（该条目 body 为 null）。有意改模板后必须同步刷新这两项：
|
||
服务端渲染 = templates/index.html 去掉末尾换行，故
|
||
html_len = 文件字节数 - 1，html_sha256 = sha256(文件去掉末尾换行)。
|
||
"""
|
||
import hashlib
|
||
import json
|
||
import sqlite3
|
||
import time
|
||
from pathlib import Path
|
||
|
||
import pytest
|
||
from fastapi.testclient import TestClient
|
||
|
||
import auth_system
|
||
from core import session as cs
|
||
|
||
_GOLDEN = Path(__file__).parent / 'golden' / 'responses.json'
|
||
SECRET = 'golden-secret'
|
||
|
||
|
||
def _load_cases():
|
||
return json.loads(_GOLDEN.read_text(encoding='utf-8'))
|
||
|
||
|
||
def _session_for(role):
|
||
"""按当前库中该角色用户的 login_seq 造一份合法会话 Cookie。"""
|
||
conn = sqlite3.connect('data/site.db')
|
||
conn.row_factory = sqlite3.Row
|
||
try:
|
||
where = "role = 'admin'" if role == 'admin' else "role != 'admin' AND status = 1"
|
||
row = conn.execute(
|
||
f'SELECT id, login_seq FROM users WHERE {where} AND login_seq IS NOT NULL LIMIT 1'
|
||
).fetchone()
|
||
finally:
|
||
conn.close()
|
||
if row is None:
|
||
return None
|
||
return cs.dumps(SECRET, {
|
||
'site_uid': int(row['id']), 'site_uid_seq': int(row['login_seq']),
|
||
'site_uid_ts': int(time.time()),
|
||
})
|
||
|
||
|
||
@pytest.fixture()
|
||
def client(tmp_path, monkeypatch):
|
||
# 站点库仍用生产 data/site.db（只读），密钥 patch 成固定值以便造 Cookie
|
||
monkeypatch.setattr('web.deps.secret_key', lambda: SECRET)
|
||
monkeypatch.setattr(auth_system, 'get_secret_key', lambda: SECRET)
|
||
from web.app import create_app
|
||
return TestClient(create_app(api_prefix=''))
|
||
|
||
|
||
# 响应对比前剔除的易变字段（时钟）
|
||
_VOLATILE = {'timestamp'}
|
||
|
||
|
||
def _strip(obj):
|
||
if isinstance(obj, dict):
|
||
return {k: _strip(v) for k, v in obj.items() if k not in _VOLATILE}
|
||
if isinstance(obj, list):
|
||
return [_strip(v) for v in obj]
|
||
return obj
|
||
|
||
|
||
def _request(client, method, path, payload, cookie):
|
||
headers = {'Cookie': f'session={cookie}'} if cookie else {}
|
||
if method == 'GET':
|
||
return client.get(path, headers=headers)
|
||
return client.post(path, json=payload or {}, headers=headers)
|
||
|
||
|
||
def test_golden_contract(client):
|
||
"""逐例复现 Flask 快照。"""
|
||
cases = _load_cases()
|
||
failures = []
|
||
for c in cases:
|
||
if c.get('html_len'):
|
||
r = client.get(c['path'])
|
||
if r.status_code != c['status'] or len(r.content) != c['html_len']:
|
||
failures.append(f"{c['name']}: html {r.status_code}/{len(r.content)} "
|
||
f"!= {c['status']}/{c['html_len']}")
|
||
continue
|
||
cookie = None
|
||
if c['auth'] == 'admin':
|
||
cookie = _session_for('admin')
|
||
elif c['auth'] == 'user':
|
||
cookie = _session_for('user')
|
||
r = _request(client, c['method'], c['path'], c['payload'], cookie)
|
||
body = r.json() if r.headers.get('content-type', '').startswith('application/json') else None
|
||
if r.status_code != c['status']:
|
||
failures.append(f"{c['name']}: status {r.status_code} != {c['status']}")
|
||
elif _strip(body) != _strip(c['body']):
|
||
failures.append(f"{c['name']}: body\n fastapi={body}\n golden ={c['body']}")
|
||
assert not failures, '黄金契约回归失败:\n' + '\n'.join(failures)
|
||
|
||
|
||
def test_index_html_stable(client):
|
||
"""首页渲染逐字节稳定（模板未改时）。"""
|
||
cases = {c['name']: c for c in _load_cases()}
|
||
c = cases['index']
|
||
r = client.get('/')
|
||
assert hashlib.sha256(r.content).hexdigest() == c['html_sha256']
|