Changes

application/api/controller/References.php

@@ -1426,11 +1426,16 @@ class References extends Base
      *
      * POST/GET: p_article_id（必填）
      *
-     * 返回 list 中每项含：reference_no、p_refer_id、status（数值）、
+     * 返回 list 中每项含：reference_no、p_refer_id、progress_status（数值）、
      *                  total、pending、done、failed、pass、is_pass、last_updated_at、records
      *
-     * status 数值含义：
+     * 分组状态字段 progress_status 数值含义（生命周期顺序）：
      *   0 = 待校验   1 = 校对中   2 = 校对完成   3 = 校对失败
+     *
+     * records[i].status 与分组同一套数值含义（但 record 不会出现 1=校对中）：
+     *   0 = 待校验   2 = 校对完成   3 = 校对失败
+     *
+     * summary 用字符串键：pending / checking / completed / failed
      */
     public function referenceCheckProgressAI()
     {
@@ -1467,8 +1472,8 @@ class References extends Base
      * 返回字段：p_article_id、status、total、pending、done、failed、progress_percent
      *   total   —— 参考文献条数
      *   pending —— 该条参考文献仍有未跑完明细的数量（含"部分跑完"）
-     *   done    —— 该条参考文献所有明细都 status=1 的数量
-     *   failed  —— 该条参考文献全部跑完且至少 1 条 status=2 的数量
+     *   done    —— 该条参考文献所有明细都 status=2(完成) 的数量
+     *   failed  —— 该条参考文献全部跑完且至少 1 条 status=3(失败) 的数量
      *   pending + done + failed = total；progress_percent = (done+failed)/total
      *
      * 分组明细请走 referenceCheckProgressAI。