#ifndef MAIN_H
#define MAIN_H

#include "RTE_Components.h"
#include CMSIS_device_header

#include <stdint.h>
#include <stdio.h>

/**
 * @brief 系统任务枚举定义。
 * @note 每个枚举值对应任务调度器中的一个任务位，用于驱动主循环中的任务分发。
 */
enum system_task_t {
    TASK_ADC_VREF_SAMPLE = 0, /**< @brief 采样 VIN/VREF 原始值任务。 */
    TASK_ADC_TEMP_SAMPLE,     /**< @brief 采样内部温度通道原始值任务。 */
    TASK_ADC_PROCESS,         /**< @brief 对 ADC 原始值进行电压与温度计算任务。 */
    TASK_CAN_RX_POLL,         /**< @brief 兼容保留的 CANFD 接收轮询任务。 */
    TASK_CAN_RX_PARSE,        /**< @brief 解析并消费已接收 CANFD 帧任务。 */
    TASK_CAN_TX_PREPARE,      /**< @brief 准备 CANFD 状态发送帧任务。 */
    TASK_CAN_TX_SEND,         /**< @brief 发送已准备好的 CANFD 帧任务。 */
    TASK_STATUS_LED,          /**< @brief 状态灯维护任务。 */
    TASK_HEARTBEAT,           /**< @brief 系统心跳维护任务。 */
    TASK_DIAGNOSTIC_PRINT,    /**< @brief 诊断信息打印任务。 */
    TASK_COUNT                /**< @brief 任务总数，用于边界或统计场景。 */
};

/**
 * @brief 任务调度器状态结构体。
 * @note 保存各类节拍计数器与待执行任务标志位，由中断与主循环共享访问。
 */
struct task_scheduler_t {
    volatile uint32_t task_flags; /**< @brief 待执行任务位图，每一位对应一个任务。 */
    volatile uint32_t tick_100us; /**< @brief 100us 基准节拍累计计数。 */
    volatile uint32_t tick_1ms;   /**< @brief 1ms 节拍累计计数。 */
    volatile uint32_t tick_10ms;  /**< @brief 10ms 节拍累计计数。 */
    volatile uint32_t tick_100ms; /**< @brief 100ms 节拍累计计数。 */
    volatile uint32_t tick_1s;    /**< @brief 1s 节拍累计计数。 */
};

/**
 * @brief 全局任务调度器状态实例。
 * @note 由 TaskManager 管理，由中断与调试逻辑共享观察。
 */
extern task_scheduler_t g_scheduler;

/**
 * @brief 应用顶层对象。
 * @note 负责组织初始化、横幅输出与主循环执行。
 */
class App {
public:
    int run();

private:
    void printBanner() const;
};

#endif /* MAIN_H */