餅餅踏踏

基於 Next.js 的步步紀錄排行榜工具。

開發

pnpm install
pnpm dlx prisma migrate deploy
pnpm dev

功能

• 新增步步紀錄
  • iOS Shortcut
  • Android
• 歷史紀錄
  • 七天
  • 一個月
• 排行榜
  • 七天
  • 一個月
• 獎章系統
• PWA
• 分析功能

部署

餅餅踏踏使用 SQLite 作為資料庫，因此需要將資料庫檔案掛載到容器中。

touch stepstep.db
docker run -d -p 3000:3000 \
  -v $(pwd)/stepstep.db:/app/prisma/dev.db \
  -e JWT_SECRET=YOUR_SECRET \
  -e INVITE_CODE=YOUR_INVITE_CODE \
  --name stepstep \
  ghcr.io/gnehs/stepstep

API

GET /api/v1/rank?date=2024-06-10

• 取得指定日期的排行榜。
• 日期格式為 YYYY-MM-DD。

[
  {
    "steps": 5000,
    "distance": 5.123456789,
    "energy": 0,
    "user": {
      "id": "c123456",
      "name": "Test"
    }
  }
]

GET /api/v1/analytics?token=<TOKEN>

• 透過同步令牌取得分析資料。

interface ActivityData {
  success: boolean;
  data: {
    aggregate: {
      _sum: {
        distance: number;
        energy: number;
        steps: number;
      };
      _avg: {
        distance: number;
        energy: number;
        steps: number;
      };
    };
    last30dAggregate: {
      日: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      一: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      二: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      三: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      四: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      五: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
      六: {
        [hour: string]: { distance: number; energy: number; steps: number };
      };
    };
    last30dByDay: Array<
      | {
          distance: number;
          energy: number;
          steps: number;
          timestamp: string;
        }
      | { timestamp: string }
    >;
  };
}