#ifndef _APP_HOME_PAGE_H
#define _APP_HOME_PAGE_H

#include "../data/key_manager.h"
#include <stdint.h>
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

/* ====================================================================================================================
 * 文件名称: app_home_page.h
 * 文件职责: 首页App层头文件 - 事件处理，协调Service和UI，管理页面生命周期
 * 架构位置: APP层 (Controller)
 * ==================================================================================================================== */

/**
 * @brief  页面创建（供ui_manager调用）
 */
void app_home_page_create(void);

/**
 * @brief  事件处理（供按键处理调用）
 * @param  kval  按键值
 */
void app_home_page_handle_event(keyValue kval);

/**
 * @brief  页面销毁（供ui_manager调用）
 */
void app_home_page_destroy(void);

/**
 * @brief  获取当前显示组索引
 * @return 当前组索引 0-4
 */
uint8_t app_home_page_get_current_group_index(void);

#ifdef __cplusplus
}
#endif

#endif /* _APP_HOME_PAGE_H */
