# App_02_记账

- 应用信息
    - 应用名称
        - 记账
    - 英文标识
        - bill
    - 应用编号
        - app_02
    - 应用描述
        - 一个精明、毒舌但实际上很负责任的财务经理。说话喜欢带刺，吐槽用户乱花钱，但关键时刻会给出靠谱建议。
- 数据结构
    - 枚举数据
        - TransactionType 交易类型
            - EXPENSE = "expense"
            - INCOME = "income"
        - ExpenseCategory 支出分类
            - FOOD = "餐饮"
            - SHOPPING = "购物"
            - TRANSPORT = "交通"
            - HOUSING = "住房"
            - ENTERTAINMENT = "娱乐"
            - MEDICAL = "医疗"
            - SOCIAL = "人情"
            - EDUCATION = "学习"
            - FINANCE = "金融"
            - CHILD = "孩子"
            - PET = "宠物"
            - CAR = "汽车"
            - BEAUTY = "美容"
            - BUSINESS = "经营"
            - MISC = "杂项"
        - IncomeCategory 收入分类
            - SALARY = "工资"
            - BONUS = "奖金"
            - INVESTMENT = "理财"
            - PARTTIME = "兼职"
            - GIFT = "红包"
            - OTHER = "其他收入"
        - MessageRole 消息角色
            - USER = "user"
            - ASSISTANT = "assistant"
        - ReminderFrequency 提醒频率
            - MONTHLY = "monthly"
            - ONCE = "once"

    - Common 通用属性
        - seq 排序
        - isEnabled 是否启用
        - creator 创建人
        - created_at 创建时间
        - updated_at 更新时间
    - Transaction 交易记录
        - item 交易项目名称
        - amount: float 交易金额
        - type: TransactionType 交易类型
        - category: ExpenseCategory | IncomeCategory 交易分类
        - date 交易日期 YYYY-MM-DD
        - timestamp: int 时间戳（毫秒）
    - Message 聊天消息
        - role: MessageRole 消息角色
        - content 消息内容
        - timestamp: int 时间戳（毫秒）
        - transaction_id 关联的交易ID
    - Budget 预算
        - member_id 会员ID
        - budgets: dict 预算字典 {名称: 金额}
        - month 预算月份 YYYY-MM
    - Reminder 账单提醒
        - member_id 会员ID
        - title 提醒标题
        - amount: float 金额（可选）
        - frequency: ReminderFrequency 频率
        - target_date 目标日期: DD(每月) 或 YYYY-MM-DD(单次)
        - is_completed: bool 完成状态
    - AISettings AI助手设置
        - member_id 会员ID
        - name AI助手名称
        - persona AI性格描述
        - avatar 头像Base64编码
    - UserPreference 用户偏好设置
        - member_id 会员ID
        - custom_preset_name 自定义预设名称
        - custom_preset_description 自定义预设描述
        - theme_index: int 主题索引
        
- API接口
    - Auth 授权
        - POST /api/wx/get_token
            - 获取token
        - GET /api/wx/profile 
            - 获取个人信息
    - transaction Bill: 交易记录
        - GET /api/bill/transactions
            - 获取分页交易记录
        - GET /api/bill/transactions/{id}
            - 获取交易记录详情
        - POST /api/bill/transactions
            - 创建交易记录
        - PUT /api/bill/transactions/{id}
            - 更新交易记录
        - DELETE /api/bill/transactions/{id}
            - 删除交易记录
    - Message Bill: 聊天消息
        - GET /api/bill/messages
            - 获取分页聊天消息
        - GET /api/bill/messages/{id}
            - 获取聊天消息详情
        - POST /api/bill/messages
            - 创建聊天消息
        - PUT /api/bill/messages/{id}
            - 更新聊天消息
        - DELETE /api/bill/messages/{id}
            - 删除聊天消息
    - Budget Bill: 预算
        - GET /api/bill/budgets
            - 获取分页预算
        - GET /api/bill/budgets/{id}
            - 获取预算详情
        - POST /api/bill/transactions
            - 创建交易记录
        - PUT /api/bill/transactions/{id}
            - 更新交易记录
        - DELETE /api/bill/transactions/{id}
            - 删除交易记录
    - BillReminder Bill: 账单提醒
        - GET /api/bill/bill_reminders
            - 获取分页账单提醒
        - GET /api/bill/bill_reminders/{id}
            - 获取账单提醒详情
        - POST /api/bill/transactions
            - 创建交易记录
        - PUT /api/bill/transactions/{id}
            - 更新交易记录
        - DELETE /api/bill/transactions/{id}
            - 删除交易记录
    - AISettings AI助手设置
        - GET /api/h5/ai_settings
            - 获取AI助手设置
        - PUT /api/h5/ai_settings
            - 更新AI助手设置
        - POST /api/h5/ai_settings/reset
            - 重置AI助手设置
    - UserPreference 用户偏好设置
        - GET /api/h5/user_preference
            - 获取用户偏好设置
        - PUT /api/h5/user_preference
            - 更新用户偏好设置
    
- 问题/需求
    - 单用户转换为多用户模式
        - 增加登录验证
        - 增加creator字段
    - 登录问题
        - URL传递参数openid和mobile
        - H5端首页先检测token状态
            - 如果存在并且未过期, 则携带token获取用户信息
            - 如果不存在则通过openid和mobile获取token, 并获取用户信息
    - 语音接口识别
	    - 接口鲁棒性调试
    - 识别消息对接创建交易记录接口
	    - 约定和调试大模型返回数据

- 开发任务
    - H5首页接收openid和mobile参数
        - 0.5小时/人
    - H5首页token检测并获取, 通过接口获取用户信息
        - 1.5小时/人
    - 开发H5端获取token接口
        - 2小时/人
    - 开发H5端获取用户信息接口
        - 1.5小时/人
    - 开发交易记录增删改查接口
        - 4小时/人
    - 开发聊天增删改查接口
        - 6小时/人
    - 开发预算增删改查接口
        - 4小时/人
    - 开发账单提醒增删改查完成接口
        - 6小时/人
    - 开发AI助手设置增删改查接口
        - 4小时/人
    - 开发用户偏好设置增删改查接口
        - 3小时/人
    - 调试H5页面交互, 调用交易记录、聊天、预算、账单提醒、助手设置、用户偏好接口
        - 8~12小时/人
    - 切换线上配置，打包、发布到线上服务器
        - 2小时/人