# Citronotes

**Repository Path**: lihugh/Citronotes

## Basic Information

- **Project Name**: Citronotes
- **Description**: 柠柚记 · Citronotes柠檬和西柚外表很像可能搞不清楚，但是记账不能糊涂，快快用这个小程序记录每一笔帐，搞清楚自己的账本吧~
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 柠柚记 - 微信记账小程序

一款简洁实用的微信小程序记账应用，帮助用户轻松记录日常收支，清晰掌握财务状况。

## 功能特性

### 📊 明细页面
- 展示收支明细列表，按日期智能分组
- 支持年/月快速筛选，灵活查看历史记录
- 左滑即可删除记录，长按编辑修改
- 实时显示当月支出/收入汇总

### 📈 图表页面
- 多维度统计：支出/收入分类查看
- 周期切换：周视图、月视图、年视图
- 可视化柱状图，直观展示消费趋势
- 消费排行榜，快速定位主要支出

### 💰 记账页面
- 支出/收入一键切换
- 28种支出分类 + 5种收入分类
- 支持补记历史账单
- 备注信息自由添加
- 智能日期选择（今天/昨天/其他日期）

## 分类体系

### 支出分类
餐饮、购物、日用、交通、、蔬菜、水果、零食、运动、娱乐、通讯、服饰、美容、住房、居家、长辈、社交、旅行、烟酒、数码、医疗、礼物、办公、维修、亲友、快递、超市、外卖、社保

### 收入分类
工资、奖金、投资、兼职、礼金

## 技术实现

### 技术栈
- **框架**: 微信小程序原生开发
- **存储**: 本地数据持久化 (wx.setStorageSync)
- **通信**: 页面间事件总线
- **UI**: 自定义 TabBar 组件

### 项目结构

```
ningyouji/
├── custom-tab-bar/          # 自定义底部导航栏
├── images/tab/              # TabBar 图标资源
├── pages/                   # 页面目录
│   ├── index/               # 明细页面
│   ├── chart/               # 图表页面
│   ├── add/                 # 记账页面
│   ├── discover/            # 发现页面
│   └── mine/                # 我的页面
├── typings/                 # TypeScript 类型定义
├── app.js                   # 应用入口
├── app.json                 # 全局配置
└── app.wxss                 # 全局样式
```

## 使用说明

### 安装依赖
本项目为微信小程序，无需额外安装依赖，直接导入微信开发者工具即可运行。

### 运行项目
1. 打开 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
2. 导入项目目录
3. 选择 `ningyouji` 文件夹
4. 点击编译运行

### 数据说明
- 所有数据存储在本地微信缓存中
- 卸载小程序将导致数据丢失，建议定期备份

## 开发指南

### 添加新页面
1. 在 `pages/` 目录下创建新页面文件夹
2. 在 `app.json` 的 `pages` 数组中添加页面路径
3. 在 `tabBar.list` 中添加底部导航配置

### 页面间通信
使用全局事件机制进行页面通信：

```javascript
// 发送事件
const app = getApp();
if (app.emitEvent) {
  app.emitEvent('recordAdded', null);
}

// 监听事件
const app = getApp();
this.onRecordChange = () => {
  this.loadRecords();
};
if (app.onEvent) {
  app.onEvent('recordAdded', this.onRecordChange);
}
```

## License

MIT License