import json  # 用于处理 JSON 格式的数据读写
import os    # 用于与操作系统进行交互，这里主要用来检查文件是否存在
from datetime import datetime  # 用于获取当前的日期和时间

# 定义全局常量，指定存储记账记录的 JSON 文件名
FILE = "zhangben.json"

def load_records():
    """
    加载本地账本数据。
    如果文件存在，则读取并解析 JSON 数据；如果不存在，则返回一个空列表。
    """
    # os.path.exists 用于检查当前目录下是否存在该文件
    if os.path.exists(FILE):
        # 使用 "r" (只读) 模式打开文件，指定 utf-8 编码防止中文乱码
        with open(FILE, "r", encoding="utf-8") as f:
            return json.load(f)  # 将 JSON 格式的字符串反序列化为 Python 字典/列表
    return []  # 文件不存在时，返回空列表初始化账本

def save_records(records):
    """
    将当前内存中的账本数据保存到本地 JSON 文件中。
    """
    # 使用 "w" (写入) 模式打开文件，如果文件不存在会自动创建，存在则覆盖
    with open(FILE, "w", encoding="utf-8") as f:
        # ensure_ascii=False 确保中文字符能正常显示而不是被转义成 Unicode
        # indent=2 让生成的 JSON 文件有 2 个空格的缩进，方便人类阅读
        json.dump(records, f, ensure_ascii=False, indent=2)

def add_record(records):
    """
    添加一条新的记账记录（收入或支出）。
    包含基础的输入验证，防止程序崩溃。
    """
    # .strip() 用于去除用户输入字符串首尾的空格
    kind = input("类型（收入/支出）：").strip()
    
    # 校验输入类型是否合法
    if kind not in ("收入", "支出"):
        print("请输入「收入」或「支出」")
        return  # 输入不合法，提前结束函数
    
    # 校验金额是否为有效数字
    try:
        amount = float(input("金额："))  # 尝试将输入的字符串转换为浮点数
    except ValueError:
        # 如果用户输入了非数字（如字母或符号），捕获异常并提示
        print("金额必须是数字")
        return
        
    note = input("备注：").strip()
    
    # 将新的记录作为一个字典，追加到 records 列表中
    records.append({
        "kind": kind,
        "amount": amount,
        "note": note,
        # datetime.now() 获取当前时间，strftime 负责将其格式化为指定的字符串样式
        "time": datetime.now().strftime("%Y-%m-%d %H:%M")
    })
    
    save_records(records)  # 调用保存函数，将更新后的列表写入文件
    print(f"✅ 已记录：{kind} {amount} 元")

def show_all(records):
    """
    格式化打印所有历史记账记录。
    """
    # 如果列表为空，提示并退出函数
    if not records:
        print("暂无记录")
        return
        
    # 打印表头，:<18 表示左对齐占用18个字符，:>8 表示右对齐占用8个字符
    print(f"\n{'时间':<18}{'类型':<6}{'金额':>8}  备注")
    print("-" * 45)  # 打印分隔线
    
    # 遍历所有记录
    for r in records:
        # 如果是收入则前缀为 "+" 否则为 "-"
        sign = "+" if r["kind"] == "收入" else "-"
        # 格式化输出每一行数据，>7.2f 表示右对齐，占7个字符位，保留两位小数
        print(f"{r['time']:<18}{r['kind']:<6}{sign}{r['amount']:>7.2f}  {r['note']}")
    print()  # 打印空行换行

def show_balance(records):
    """
    计算并展示总收入、总支出和当前余额。
    """
    # 使用生成器表达式计算总收入（筛选出 kind 为 "收入" 的 amount 并求和）
    income  = sum(r["amount"] for r in records if r["kind"] == "收入")
    # 使用生成器表达式计算总支出
    expense = sum(r["amount"] for r in records if r["kind"] == "支出")
    # 计算结余
    balance = income - expense
    
    # 打印统计结果，.2f 表示保留两位小数
    print(f"\n总收入：{income:.2f} 元")
    print(f"总支出：{expense:.2f} 元")
    print(f"当前余额：{balance:.2f} 元\n")

def main():
    """
    程序的主入口点，负责初始化数据和控制菜单循环。
    """
    records = load_records()  # 启动时先加载现有数据
    print(f"记账本已启动，共 {len(records)} 条历史记录")
    
    # 使用字典来构建菜单路由，键为用户输入，值为一个元组 (描述文本, 对应的执行函数)
    # 使用 lambda 表达式(匿名函数)是为了延迟执行，只在用户选择时才调用，并将 records 传进去
    menu = {
        "1": ("添加记录", lambda: add_record(records)),
        "2": ("查看所有", lambda: show_all(records)),
        "3": ("查看余额", lambda: show_balance(records)),
        "0": ("退出",     None),
    }
    
    # 无限循环，保持程序持续运行，直到用户选择退出
    while True:
        print("1 添加  2 查看  3 余额  0 退出")
        choice = input("请选择：").strip()
        
        # 处理退出逻辑
        if choice == "0":
            print("再见！")
            break  # 退出 while 循环，程序随之结束
            
        # 处理其他有效菜单选项
        if choice in menu:
            name, action = menu[choice]  # 解包元组，获取函数
            action()  # 执行对应的函数
        else:
            # 用户输入了 0,1,2,3 之外的内容
            print("无效输入，请重试")

# 经典的 Python 入口判断：
# 确保只有在直接运行该脚本时才会执行 main()，如果是被当作模块导入到其他文件中则不执行
if __name__ == "__main__":
    main()