{
  "document": "今日行动字段与状态契约",
  "version": "2026-09-28-implementation-aligned-review",
  "authority": {
    "confirmed": "本轮用户要求或需求文档明确",
    "proposal": "本轮可开发提案，待产品评审",
    "pending_evidence": "缺正式动作或科学证据，不可作上线参数",
    "prototype_only": "只用于模拟演示，不表示真实识别或奖励到账"
  },
  "catalog": {
    "status": "confirmed",
    "target_structure": "10选3",
    "available_distinct_action_count": 4,
    "rule": "只显示已获有效内容的行动；不以旧选择页示例条目补成10项",
    "actions": [
      {
        "action_id": "neck_left_right",
        "label": "颈部轻转",
        "modes": [
          "nose_track_a",
          "glider_airflow_b"
        ],
        "count_as": "one_distinct_action",
        "content_status": "source_candidate_or_design_value_as_specified"
      },
      {
        "action_id": "breathing_guidance",
        "label": "轻柔慢呼吸",
        "modes": [
          "paper_disc_video"
        ],
        "count_as": "one_distinct_action",
        "content_status": "source_candidate_or_design_value_as_specified"
      },
      {
        "action_id": "fingertip_attention",
        "label": "指尖留意",
        "modes": [
          "soft_discs"
        ],
        "count_as": "one_distinct_action",
        "content_status": "source_candidate_or_design_value_as_specified"
      },
      {
        "action_id": "simple_drawing",
        "label": "自由画线",
        "modes": [
          "direct_stroke_optional_symmetry"
        ],
        "count_as": "one_distinct_action",
        "content_status": "source_candidate_or_design_value_as_specified"
      }
    ]
  },
  "content_fields": {
    "required_before_release": [
      "action_id",
      "display_name",
      "intro_short",
      "intro_detail",
      "instructions_by_step",
      "post_completion_copy",
      "estimated_duration_seconds",
      "duration_source",
      "scientific_claim_sources",
      "completion_definition",
      "safety_copy",
      "content_version"
    ],
    "neck_additional": [
      "camera_setup_copy",
      "neutral_calibration_rule",
      "left_right_order",
      "movement_range",
      "target_tolerance",
      "valid_hold_duration",
      "repetitions",
      "tracking_confidence_rule",
      "tracking_loss_rule"
    ],
    "breathing_additional": [
      "phase_sequence",
      "phase_durations",
      "total_duration",
      "video_asset",
      "text_fallback"
    ],
    "touch_additional": [
      "valid_touch_rule",
      "minimum_or_total_duration",
      "completion_threshold"
    ],
    "drawing_additional": [
      "valid_stroke_rule",
      "minimum_or_total_duration",
      "early_finish_rule",
      "artwork_retention_rule"
    ],
    "unresolved_values": "仅未确认的奖励数值、权限/隐私、生产服务日和试机阈值为null；当前原型完成脚本已有具体取值"
  },
  "evidence_candidates": {
    "source_document": "行动依据核查.md",
    "neck_left_right": {
      "source": "S1_NHS_sitting_exercises_neck_rotation",
      "source_supported_steps": "舒适范围左右缓慢转头，约5秒保持后回正，左右各3次",
      "status": "source_checked_content_review_pending",
      "camera_completion_validity": "not_established"
    },
    "breathing_guidance": {
      "source": "S2_NHS_breathing_exercises_for_stress",
      "source_supported_steps": "轻柔舒适地吸气和呼气，可各数到5，至少持续约5分钟，不强迫",
      "status": "source_checked_content_review_pending",
      "breath_detection": "not_present"
    },
    "fingertip_attention": {
      "source": "S4_PAUSE_2016_interaction_precedent",
      "prototype_duration_seconds": 60,
      "duration_status": "product_experience_candidate_not_clinical_dose",
      "attention_detection": "not_present"
    },
    "simple_drawing": {
      "prototype_duration_seconds": 60,
      "duration_status": "product_experience_candidate_not_clinical_dose",
      "clinical_effect_evidence": "not_identified"
    }
  },
  "daily_task": {
    "target_distinct_actions": 3,
    "status": "confirmed",
    "count_key": [
      "user_id",
      "service_date",
      "action_id"
    ],
    "count_rule": "同日同action_id的首个已提交完成计1；后续再练计0；neck两模式共用action_id",
    "progress": "min(3, distinct_completed_action_ids_count)",
    "task_done_when": "distinct_completed_action_ids_count >= 3",
    "no_score_or_bonus": true,
    "completed_action_replay": "allowed_without_extra_count",
    "date_authority": "production_server_policy_pending",
    "prototype_date_policy": "device_local_date_display_only"
  },
  "calendar": {
    "week_starts_on": "sunday",
    "statuses": {
      "past_zero": "睡觉图案并标日期；中性记录，不作为惩罚",
      "today_zero": "待开始",
      "today_partial": "旗帜，显示1/3或2/3",
      "today_complete": "花朵，显示3/3",
      "past_partial": "旗帜，显示实际1/3或2/3",
      "past_complete": "花朵，显示3/3",
      "future": "未来日期，不能显示已完成记录"
    }
  },
  "page_flow": [
    "action_list",
    "intro_tutorial",
    "preparation",
    "camera_calibration_if_neck",
    "execution",
    "completion_and_settlement",
    "action_list"
  ],
  "session_states": [
    "not_started",
    "intro",
    "preparation",
    "requesting_camera_permission",
    "camera_calibrating",
    "ready",
    "running",
    "tracking_lost",
    "exit_confirmation",
    "completion_submitting",
    "completed",
    "abandoned"
  ],
  "session_transitions": [
    {
      "from": "intro",
      "event": "prepare_non_camera",
      "to": "preparation"
    },
    {
      "from": "preparation",
      "event": "start_non_camera",
      "to": "running"
    },
    {
      "from": "intro",
      "event": "prepare_camera",
      "to": "preparation"
    },
    {
      "from": "preparation",
      "event": "camera_setup",
      "to": "requesting_camera_permission"
    },
    {
      "from": "requesting_camera_permission",
      "event": "permission_granted",
      "to": "camera_calibrating"
    },
    {
      "from": "camera_calibrating",
      "event": "neutral_stable_and_eligible",
      "to": "ready"
    },
    {
      "from": "ready",
      "event": "start",
      "to": "running"
    },
    {
      "from": "running",
      "event": "tracking_lost",
      "to": "tracking_lost",
      "effect": "stop_action_judgement_and_invalidate_current_hold_remainder"
    },
    {
      "from": "running",
      "event": "exit_tap",
      "to": "exit_confirmation"
    },
    {
      "from": "exit_confirmation",
      "event": "continue",
      "to": "running"
    },
    {
      "from": "exit_confirmation",
      "event": "confirm_exit",
      "to": "abandoned",
      "effect": "clear_only_unsubmitted_session_progress"
    },
    {
      "from": "running",
      "event": "all_valid_steps_complete",
      "to": "completion_submitting"
    },
    {
      "from": "completion_submitting",
      "event": "completion_confirmed",
      "to": "completed"
    },
    {
      "from": "running",
      "event": "app_background_or_interruption",
      "to": "abandoned",
      "effect": "clear_only_unsubmitted_session_progress"
    },
    {
      "from": "requesting_camera_permission",
      "event": "permission_denied",
      "to": "preparation"
    },
    {
      "from": "tracking_lost",
      "event": "tracking_restored",
      "to": "running",
      "effect": "clear_current_hold_return_neutral_retry_current_repetition_keep_prior_completed_repetitions"
    }
  ],
  "execution_nodes": {
    "nose_track_a": [
      "neutral",
      "move_to_target",
      "in_target",
      "hold",
      "return_neutral",
      "next_or_complete"
    ],
    "glider_airflow_b": [
      "neutral",
      "airflow_revealed",
      "move_to_band",
      "hold_and_collect_visual_fragments",
      "return_neutral",
      "next_or_complete"
    ],
    "paper_disc_video": [
      "video_ready",
      "guided_phase_sequence",
      "guided_total_elapsed",
      "complete"
    ],
    "soft_discs": [
      "wait_first_touch",
      "60s_foreground_timer",
      "touch_aggregates_discs",
      "finger_up_relaxes_discs_timer_continues",
      "retouch_aggregates",
      "complete_automatically"
    ],
    "direct_stroke_optional_symmetry": [
      "wait_first_stroke",
      "60s_foreground_timer",
      "finger_strokes_optional_symmetry",
      "clear_strokes_without_resetting_timer",
      "nonempty_collect_button_after_60s",
      "complete_on_user_click"
    ]
  },
  "camera": {
    "modes": [
      "nose_track_a",
      "glider_airflow_b"
    ],
    "input": "nose_position_estimate_from_live_camera",
    "prototype_input": "simulated_track_with_persistent_visible_label",
    "low_confidence_behavior": "stop_action_judgement_show_recenter_and_retry_current_node",
    "hold_recovery": "do_not_resume_remaining_hold_time",
    "recording_or_upload": "pending_privacy_and_technical_decision",
    "safety_and_mapping_parameters": "normalized_tolerance_0.12_and_return_stable_0.65_are_prototype_engineering_values_to_device_test; cannot_detect_safe_range"
  },
  "completion_record": {
    "fields": [
      "completion_id",
      "session_id",
      "user_id",
      "action_id",
      "mode_id",
      "content_version",
      "completed_at",
      "service_date",
      "is_first_distinct_completion_today",
      "daily_progress_after",
      "reward_status"
    ],
    "server_unique_session": "session_id",
    "history_is_permanent_after_commit": true,
    "abandon_does_not_delete_history": true
  },
  "reward": {
    "policy_status": "proposal_pending_confirmation",
    "proposal": "每日前3个不同action首次完成自动获既有规则奖励；重复练习及第4个不同action无新增今日行动奖励",
    "actual_amounts": null,
    "actual_resource_types": null,
    "daily_3_of_3_bonus": "unknown",
    "automatic_grant_after_completion": "confirmed",
    "idempotency_key_parts": [
      "user_id",
      "service_date",
      "action_id",
      "reward_rule_id"
    ],
    "states": [
      "not_eligible",
      "pending",
      "granted",
      "failed_retryable",
      "none_for_replay"
    ],
    "result_unknown_rule": "query_by_session_id_before_retry",
    "settlement_display": "show_only_actual_ledger_items; pending_or_failed_shown_explicitly",
    "prototype_label": "模拟结算，非真实资源到账",
    "settlement_copy": {
      "pending": "完成已记录 · 奖励确认中",
      "granted": "已获得：{真实资源名称} × {账本数量}",
      "failed_retryable": "行动已完成，奖励暂未到账。系统会继续处理。",
      "none_for_replay": "本次是再次练习，今日进度不变，无新增奖励",
      "not_eligible_after_three": "本次行动已记录，今日任务已完成，无新增今日行动奖励"
    },
    "prototype_state": "currently_stays_pending_because_business_ledger_not_connected"
  },
  "prototype_disclosures": [
    "模拟追踪，尚未接入摄像头识别",
    "模拟结算，非真实资源到账",
    "演示节奏，非正式动作处方"
  ],
  "open_decisions": [
    "choose_neck_mode_after_real_device_and_user_test",
    "camera_mapping_calibration_privacy_and_device_placement",
    "reward_rule_resource_amounts_and_fourth_action_behavior",
    "drawing_artwork_retention",
    "full_ten_action_catalog",
    "production_service_date_and_week_history_policy",
    "health_content_review_of_NHS_candidate_wording",
    "device_validation_of_0.12_tolerance_and_0.65_return",
    "usability_validation_of_60_second_touch_and_drawing_experience"
  ],
  "action_parameters": {
    "neck": {
      "action_id": "neck_left_right",
      "display_name": "颈部轻转",
      "direction_sequence": [
        "left",
        "right",
        "left",
        "right",
        "left",
        "right"
      ],
      "repetitions_total": 6,
      "repetitions_each_side": 3,
      "hold_seconds_each": 5,
      "hold_seconds_provenance": "NHS_S1_action_candidate_subject_to_content_review",
      "return_neutral_stable_seconds": 0.65,
      "return_provenance": "engineering_prototype_value_device_test_required",
      "normalized_target_tolerance": 0.12,
      "tolerance_provenance": "simulated_engineering_value_not_cervical_angle",
      "fixed_degrees": null,
      "tracking_loss": "clear_current_hold_return_neutral_retry_current_repetition_keep_prior_completed_repetitions",
      "can_detect_medical_safe_range": false
    },
    "breath": {
      "action_id": "breathing_guidance",
      "display_name": "轻柔慢呼吸",
      "inhale_seconds": 5,
      "exhale_seconds": 5,
      "media_valid_playback_seconds": 300,
      "source_boundary": "NHS_S2_supports_comfortable_breathing_counting_to_five_and_at_least_five_minutes; product_5_5_timing_is_guidance_candidate",
      "completion": "accumulate_only_valid_media_playback; no_breath_sensing",
      "audio_in_current_version": false
    },
    "touch": {
      "action_id": "fingertip_attention",
      "display_name": "指尖留意",
      "duration_seconds": 60,
      "duration_provenance": "product_experience_value_not_clinical_dose",
      "timer_start": "first_touch",
      "timer_during_finger_up": "continues_while_foreground",
      "visual_when_finger_up": "discs_relax_and_spread",
      "retouch": "resume_visual_aggregation",
      "completion": "automatic_after_60_foreground_seconds_from_first_touch"
    },
    "drawing": {
      "action_id": "simple_drawing",
      "display_name": "自由画线",
      "duration_seconds": 60,
      "duration_provenance": "product_experience_value_not_clinical_dose",
      "timer_start": "first_stroke",
      "timer_during_pen_up": "continues_while_foreground",
      "clear_canvas": "remove_strokes_only_do_not_reset_timer",
      "finish_after_60": "enable_collect_artwork_only_if_nonempty_then_user_clicks",
      "empty_canvas": "cannot_complete",
      "symmetry": "optional",
      "completed_artwork": "shown_on_prototype_result; long_term_retention_pending"
    }
  }
}
