/**
 * @file main_menu.h
 * @brief 主菜单实现文件
 * @note 实现各种菜单显示功能函数声明
 */

#ifndef MAIN_MENU_H
#define MAIN_MENU_H

#include "config.h"

// 主菜单和子菜单显示函数

/**
 * @brief 显示主菜单
 * @details 显示学生成绩管理系统的主菜单界面，包括当前用户信息和可用功能选项
 *          根据用户权限动态显示菜单项（管理员可看到系统管理功能）
 * @note 菜单选项：
 *       1. 基本功能管理（所有用户）
 *       2. 统计分析功能（所有用户）
 *       3. 系统管理功能（仅管理员）
 *       0. 退出系统
 */
void displayMainMenu();

/**
 * @brief 显示基本功能菜单
 * @details 显示学生信息管理的基本功能菜单，包括增删改查和排序功能
 *          同时显示当前系统中的学生总数
 * @note 菜单功能：
 *       1. 添加学生信息
 *       2. 删除学生信息
 *       3. 修改学生信息
 *       4. 按学号查找学生
 *       5. 按姓名查找学生
 *       6. 显示所有学生
 *       7. 学生信息排序
 *       0. 返回主菜单
 */
void displayBasicFunctionsMenu();

/**
 * @brief 显示统计功能菜单
 * @details 显示统计分析功能菜单，提供各种数据统计和分析选项
 *          显示当前学生总数和系统平均分（如果有学生数据）
 * @note 菜单功能：
 *       1. 课程统计分析
 *       2. 成绩分布统计
 *       3. 分数段统计
 *       4. 综合统计分析
 *       0. 返回主菜单
 */
void displayStatisticsMenu();

/**
 * @brief 显示管理功能菜单
 * @details 显示系统管理功能菜单，仅管理员可访问
 *          提供用户账户管理功能，显示当前用户总数
 * @note 菜单功能：
 *       1. 添加用户账户
 *       2. 删除用户账户
 *       3. 修改用户密码
 *       4. 查看所有用户
 *       0. 返回主菜单
 * @warning 此菜单仅限管理员用户访问
 */
void displayAdminMenu();

#endif // MAIN_MENU_H