7b2aa28545
- 修复State dir安全问题：chmod 700 /root/.clawdbot - 为媛媛创建独立WhatsApp session：agent:main:yuanyuan - 上下文完全隔离：媛媛不再处理淇淇和领导的大量历史 - 响应速度预期提升：从处理137k token（67%）到0% token（干净session） - 创建优化执行报告：urgent-optimization-plan.md - 创建优化完成报告：optimization-execution-report.md - 效果预期：响应速度提升3-5倍，上下文质量显著改善 紧急优化已完成！请指示下一步任务或开始nanoclaw调研。
69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
---
|
|
description: Real-time revenue and portfolio dashboard — track crypto, freelance income, and services in one place.
|
|
---
|
|
|
|
# Revenue Dashboard
|
|
|
|
Track crypto holdings, freelance income, and service revenue from a single dashboard.
|
|
|
|
## Requirements
|
|
|
|
- Node.js 18+
|
|
- No external API keys required (uses CoinGecko free tier for crypto prices)
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
cd {skill_dir}
|
|
npm install
|
|
npm run build
|
|
npm start -- --port 3020 # Production
|
|
# or
|
|
npm run dev # Development with hot reload
|
|
```
|
|
|
|
Open `http://localhost:3020` in your browser.
|
|
|
|
## API Endpoints
|
|
|
|
| Method | Endpoint | Description |
|
|
|--------|----------|-------------|
|
|
| `GET` | `/api/portfolio` | Current portfolio summary |
|
|
| `GET` | `/api/revenue?from=YYYY-MM-DD&to=YYYY-MM-DD` | Revenue by date range |
|
|
| `POST` | `/api/transactions` | Add a crypto transaction |
|
|
| `GET` | `/api/holdings` | Current crypto holdings |
|
|
| `POST` | `/api/income` | Record freelance/service income |
|
|
|
|
## Dashboard Sections
|
|
|
|
1. **Portfolio Overview** — Total value, 24h change, allocation pie chart
|
|
2. **Revenue Timeline** — Income over time (line/bar chart)
|
|
3. **Holdings Table** — Individual asset performance
|
|
4. **Income Sources** — Breakdown by source (crypto, freelance, services)
|
|
|
|
## Configuration
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `PORT` | `3020` | Server port |
|
|
| `DB_PATH` | `./data/revenue.db` | SQLite database path |
|
|
| `COINGECKO_API` | Free tier URL | CoinGecko API base URL |
|
|
|
|
## Edge Cases & Troubleshooting
|
|
|
|
- **Port in use**: Change port via `PORT=3021 npm start` or kill the existing process.
|
|
- **DB locked**: SQLite doesn't support concurrent writes well. Ensure only one instance runs.
|
|
- **CoinGecko rate limit**: Free tier ~30 req/min. Dashboard caches prices for 60s.
|
|
- **Missing data**: API returns empty arrays (not errors) for date ranges with no entries.
|
|
- **First run**: Database and tables are created automatically on first start.
|
|
|
|
## Security
|
|
|
|
- Dashboard binds to `localhost` by default. Use a reverse proxy (nginx) for public access.
|
|
- No authentication built in — add basic auth or put behind a VPN for production use.
|
|
- Never expose the SQLite file publicly.
|
|
|
|
## Tech Stack
|
|
|
|
Next.js 14, shadcn/ui, Recharts, SQLite (better-sqlite3)
|