项目

一般

简介

0001-Sprint1规划会议 » 历史记录 » 版本 3

Huarui Lin, 2026-04-13 13:17

1 2 Huarui Lin
# Sprint 1 规划会议 Agenda:工程脚手架与架构护栏落地
2 1 Huarui Lin
3 2 Huarui Lin
**会议目标**:拒绝“纯技术”Sprint,将脚手架转化为“零偏移数据管线与强制规约护栏”的垂直切片;敲定跨团队依赖契约,输出首版架构决策记录(ADR)。
4
**参会角色**:项目经理(PM)、算法/研发工程师、基础架构/运维工程师、数据资产管理员(特邀)。
5 1 Huarui Lin
**会议时长**:60 分钟
6 2 Huarui Lin
**强制准入条件**:全员已阅读《最终设计规约 v1.0》及《系统架构与工程规范基线》。
7 1 Huarui Lin
8
---
9 2 Huarui Lin
## 议程一:架构对齐与企业级业务价值定义(15 mins)
10 1 Huarui Lin
11 2 Huarui Lin
**主导人**:PM
12
**讨论焦点**:
13
1. **Sprint 1 价值重塑**:明确本 Sprint 并非单纯“搭框架”,而是为企业级数据管线铺设“防出轨铁轨”(AST强拦截、SHA-256血缘、T-1参数化基建)。
14
2. **NFRs(非功能性需求)确认**:
15
   - **性能底线**:确认 Docker 构建与 CI 空跑的资源消耗预期。
16
   - **安全与合规底线**:确认非 root 运行、敏感参数(若有)环境变量化策略。
17
   - **可审计性**:确认 JSON 结构化日志的字段基线。
18 1 Huarui Lin
19 2 Huarui Lin
## 议程二:跨团队依赖与前置契约敲定(15 mins)
20 1 Huarui Lin
21 2 Huarui Lin
**主导人**:PM、基础架构/运维
22
**讨论焦点**:
23
1. **基础设施契约**:
24
   - **[需提供/确认]** Gitea Action Runner 在 64GB 实体机上的 Docker cgroup 内存限制凭证/配置确认(要求 `memory=50g`)。
25
   - **[需提供/确认]** 实体机访问阿里云 Docker/PyPI 镜像源的连通性测试结果。
26
2. **数据资产契约**:
27
   - **[需提供/确认]** 数据资产管理员确认 `fund_basic_info` 表新增的 4 列(`insert_datetime` 等)不会被业务方频繁更名或变更类型,支持我们在 `data_loader` 中做硬编码 `SELECT` 投影丢弃。
28
## 议程三:核心 Story 拆解与 ADR(架构决策记录)输出(20 mins)
29 1 Huarui Lin
30 2 Huarui Lin
**主导人**:研发工程师
31 1 Huarui Lin
32 2 Huarui Lin
**讨论焦点**(不深挖代码实现,仅定技术路线与决策):
33
1. **依赖隔离策略(S1-01)**:
34
   - **[需决策]** `pyproject.toml` 依赖版本策略:允许 Patch 级浮动(`^1.0.0`)还是全量锁死?若第三方库隐式依赖 Pandas,防御边界划在哪里(仅阻断 `src/` 手写,还是阻断全局构建环境)?
35
2. **配置中心演进路线(S1-02)**:
36
   - **[可复用逻辑指出]** 确认 Pydantic 强类型加载器的 Schema 设计,不仅服务本阶段,需确保其能直接被 Step 5 MLflow 参数持久化复用,避免重复造轮子。
37
3. **规约拦截器工程化(S1-04)**:
38
   - **[需决策]** AST 拦截脚本的“魔法数字黑名单”维护方式:是硬编码在脚本内,还是抽离为 `.magic_numbers` 配置文件以降低后续维护成本?
39 1 Huarui Lin
40 2 Huarui Lin
## 议程四:M1 验收标准终审与技术债预防(10 mins)
41
42
**主导人**:PM
43
**讨论焦点**:
44
1. **Done 标准无歧义对齐**:逐条过审 M1 的硬卡点(CI 0 Error、参数 0 偏差、main 分支保护生效)。
45
2. **技术债预防登记**:
46
   - 识别本 Sprint 可能引入的“临时妥协”(如:为了跑通 CI 暂时写了一个 Mock 测试用例),必须在 Redmine 提前建单登记清理 Deadline,严禁带入 Sprint 2。
47
---
48
**会议产出物要求**:
49
会后需由研发工程师在 Gitea `/docs` 目录下提交首份 `adr/001-s1-scaffolding-and-guardrails.md`,记录本次会议敲定的技术选型与决策理由。
50 3 Huarui Lin
51
---
52
### 下级目录
53
[[0001-Sprint1规划会议-会议纪要]]