chore: init ledger project with docs and gitignore

README.md

@@ -1,3 +1,66 @@
-# ledger
+# Node Ledger
 
-记账项目
+一个基于 Node.js 的轻量记账项目，包含：
+
+- 命令行记账（新增、删除、列表、汇总）
+- HTTP API（增删改查、汇总、分类统计）
+- 前端页面（Vite 构建后由后端静态托管）
+
+## 环境要求
+
+- Node.js 20+
+- npm 10+
+
+## 本地运行
+
+### 1. 安装前端依赖并构建
+
+```bash
+cd web
+npm install
+npm run build
+cd ..
+```
+
+### 2. 启动服务
+
+```bash
+node index.js serve 3001
+```
+
+打开 `http://localhost:3001`。
+
+## 常用命令
+
+```bash
+# 新增一条记录
+node index.js add 50 午饭
+
+# 查看记录（可按日期）
+node index.js list
+node index.js list --date 2026-05-01
+
+# 汇总（可按日期）
+node index.js sum
+node index.js sum --date 2026-05-01
+
+# 删除
+node index.js remove <id>
+```
+
+## API 示例
+
+- `GET /api/entries`
+- `POST /api/entries`
+- `PUT /api/entries/:id`
+- `DELETE /api/entries/:id`
+- `GET /api/summary`
+- `GET /api/stats/categories`
+
+## 部署
+
+Ubuntu 服务器建议使用：
+
+- `pm2` 守护 Node 进程
+- `nginx` 反向代理
+- `certbot` 配置 HTTPS