first commit

README.md

@@ -0,0 +1,38 @@
+# 航标 · 班级达线指标预估
+
+B/S 系统：管理员上传历次大考总分，系统用卡尔曼滤波估计每个学生的稳定水平，模拟后续考试的年级排名，把达线概率加总后下达各班指标。下达人数是“按现有轨迹本来会到的人数”，班级工作是超越它。
+
+## 启动
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+python3 -m app
+```
+
+浏览器打开 http://127.0.0.1:8765
+
+默认账号：`admin` / `hangbiao2026`（请在 `app/config.py` 修改）
+
+## 成绩表要求
+
+- Excel `.xlsx`
+- 至少包含：学号或姓名、班级、多次考试总分
+- 建议包含：方向（物理/历史）、选科、学籍、异动
+- 物理/历史分表、艺体表、异动表都可以；系统会识别并在第二步让你勾选口径
+
+同目录的 `2024级指标分析成绩基础数据_5次考试.xlsx` 可在首页一键演示。
+
+## 四步分析
+
+1. 数据体检：读到哪些人、哪些考试、分数尺度
+2. 口径与目标：算谁、年级总盘子、预估步长
+3. 滤波与回测：Q/R 含义，以及用历史考试验证准不准
+4. 下达指标：班级期望 / 下达 / 保底 / 冲刺，点班级看学生，点学生看轨迹
+
+## 指标怎么理解
+
+- **下达指标**：滤波期望取整，合计等于年级目标人数
+- **保底 / 冲刺**：模拟分布大约 20% / 80% 分位
+- **相对最近一次**：预估相对最近一场已在线人数的增减，用来找上升生和不稳的在线生