Files
Neo-ZQYY/tests/test_property_readme_structure.py
Neo 2a7a5d68aa feat: 2026-04-15~04-20 累积变更基线 — 多主线合流
主线 1: rns1-customer-coach-api + 04-miniapp-core-business 后端实施
  - 新增 GET /xcx/coaches/{id}/banner 轻量接口
  - performance/records 加 coach_id 参数 + view_board_coach 权限分流
  - coach/customer/performance/board/task 服务层重构
  - fdw_queries 结算单粒度聚合 + consumption_summary 视图统一
  - task_generator 回访宽限 72h + UPSERT 替代策略 + Step 5 保底清理
  - recall_detector settle_type=3 双重限制 + 门店级 resolved

主线 2: 小程序权限分流 + 新增 coach-service-records 管理者视角业绩明细页
  - perf-progress 共享模块去重 task-list/coach-detail 动画逻辑
  - isScattered 散客标记端到端
  - foodDetail/phoneFull/creator* 字段透传

主线 3: P19 指数回测框架 Phase 1+2
  - 3 个指数表 stat_date 日快照模式
  - 新增 DWS_INDEX_BACKFILL / DWS_TASK_SIMULATION 工具任务
  - task_engine 升级 HTTP 实时 + 推演回测双模式

主线 4: Core 维度层启用
  - 新增 CORE_DIM_SYNC 任务(DWD → core 4 维度表)
  - 修复 app 视图空查询问题

主线 5: member_project_tag 改为 LAST_30_VISITS 消费次数窗口

主线 6: 2 个迁移 SQL 已执行(stat_date + member_project_tag 新窗口)
  - schema 基线与 DDL 快照同步

主线 7: 开发机路径迁移 C:\NeoZQYY → C:\Project\NeoZQYY(约 95% 改动量)

附带: 新建运维脚本(churned_customer_report / simulate_historical_tasks /
      backfill_index_snapshots)+ tools/task-analysis/ 任务分析工具

合计 157 文件。未包含中间产物(tmp/ .playwright-mcp/ inspect-* excel/sheet 分析 txt)。
审计记录见下一个 commit。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 06:32:07 +08:00

70 lines
1.8 KiB
Python

# -*- coding: utf-8 -*-
"""
README.md 结构完整性属性测试
**Validates: Requirements 1.5**
Property 1: 对于任意 Monorepo 一级目录,其 README.md 文件应存在
且包含"作用说明""结构描述""Roadmap"三个段落。
"""
import os
import re
from hypothesis import given, settings
from hypothesis.strategies import sampled_from
# Monorepo 根目录
MONOREPO_ROOT = r"C:\Project\NeoZQYY"
# 一级目录列表(需求 1.5 定义)
# 仅包含实际存在的一级目录
TOP_LEVEL_DIRS = [
"apps",
"packages",
"db",
"docs",
"infra",
"scripts",
"samples",
"tests",
]
@settings(max_examples=100)
@given(dir_name=sampled_from(TOP_LEVEL_DIRS))
def test_readme_structure_completeness(dir_name: str) -> None:
"""
Property 1: README.md 结构完整性
**Validates: Requirements 1.5**
对于任意一级目录,验证:
1. README.md 文件存在
2. 包含"作用说明"段落标题
3. 包含"内部结构""结构"段落标题
4. 包含"Roadmap"段落标题
"""
readme_path = os.path.join(MONOREPO_ROOT, dir_name, "README.md")
# README.md 必须存在
assert os.path.isfile(readme_path), (
f"{dir_name}/README.md 不存在: {readme_path}"
)
content = open(readme_path, encoding="utf-8").read()
# 包含"作用说明"段落标题
assert re.search(r"^#{1,3}\s*作用说明", content, re.MULTILINE), (
f"{dir_name}/README.md 缺少'作用说明'段落"
)
# 包含"结构"相关段落标题(内部结构 或 结构)
assert re.search(r"^#{1,3}\s*(内部)?结构", content, re.MULTILINE), (
f"{dir_name}/README.md 缺少'结构'段落"
)
# 包含"Roadmap"段落标题
assert re.search(r"^#{1,3}\s*Roadmap", content, re.MULTILINE | re.IGNORECASE), (
f"{dir_name}/README.md 缺少'Roadmap'段落"
)