Moji API

The backend service for Moji, a minimal and friendly expense tracker app to help you stay mindful with your money — with a touch of charm.

Production

git checkout main
git pull origin main

# bump version
pnpm run release

# build
docker buildx build --platform linux/amd64 -t moji-api .

# push to Docker Hub
docker login
docker tag moji-api chaiyokung/moji-api:latest
docker push chaiyokung/moji-api:latest

MongoDB Collections Schema

1. users

เก็บข้อมูลผู้ใช้ที่ล็อกอินผ่าน OAuth (Google, Facebook ฯลฯ) สำหรับเชื่อมโยงกับข้อมูลอื่น ๆ ในระบบ เช่น รายการธุรกรรม บัญชี หมวดหมู่

{
  _id: ObjectId,
  email: String,                   // อีเมล (unique, required)
  displayName: String,             // ชื่อที่แสดง (required)
  avatarUrl?: String,              // ลิงก์รูปโปรไฟล์ (optional)
  providers: [                     // รายการ OAuth2 providers ที่เชื่อมต่อ
    {
      provider: String,            // เช่น "google", "facebook" (required)
      providerId: String,          // user id จาก provider นั้น (required)
      linkedAt: Date               // วันที่เชื่อมต่อ provider นี้ (required)
    }
  ],
  settings?: {                     // การตั้งค่าส่วนตัว (optional)
    currency?: String,             // สกุลเงินหลัก เช่น "THB"
    language?: String              // ภาษา เช่น "th"
  },
  refreshTokens: [String],         // refresh token ที่ยังใช้ได้ (default: [])
  createdAt: Date,                 // วันที่สมัคร (auto)
  updatedAt: Date                  // วันที่แก้ไขล่าสุด (auto)
}

2. accounts

เก็บข้อมูลบัญชีเงินของผู้ใช้ เช่น กระเป๋าสตางค์ บัญชีธนาคาร บัตรเครดิต เพื่อใช้แยกประเภทและติดตามยอดเงินของแต่ละบัญชี

{
  _id: ObjectId,
  userId: ObjectId,            // อ้างอิงไปยัง users._id
  name: String,                // ชื่อบัญชี เช่น "กระเป๋าสตางค์", "บัญชีธนาคาร"
  type: String,                // ประเภทบัญชี เช่น "cash", "bank", "credit"
  balance?: Number,            // ยอดเงินปัจจุบัน (optional, สำหรับแสดงผล)
  currency: String,            // สกุลเงิน เช่น "THB"
  icon?: String,               // ไอคอนหรือสัญลักษณ์บัญชี (optional)
  createdAt: Date,             // วันที่สร้างบัญชี
  updatedAt: Date              // วันที่แก้ไขล่าสุด
}

3. categories

เก็บหมวดหมู่รายรับ/รายจ่าย เช่น อาหาร เดินทาง เงินเดือน เพื่อให้ผู้ใช้สามารถจัดกลุ่มและวิเคราะห์ธุรกรรมได้ง่ายขึ้น

{
  _id: ObjectId,
  userId: ObjectId | null,     // อ้างอิงไปยัง users._id (null ถ้าเป็น global category, default: null)
  name: String,                // ชื่อหมวดหมู่ เช่น "อาหาร", "เดินทาง" (required)
  type: String,                // "income" หรือ "expense" (required)
  icon?: String,               // ไอคอนหมวดหมู่ (optional)
  color?: String,              // สีประจำหมวดหมู่ (optional)
  parentId?: ObjectId | null,  // อ้างอิงหมวดหมู่หลัก (optional, สำหรับหมวดหมู่ย่อย, default: null)
  createdAt: Date,             // วันที่สร้าง (auto)
  updatedAt: Date              // วันที่แก้ไขล่าสุด (auto)
}

4. transactions

เก็บข้อมูลแต่ละรายการรายรับ/รายจ่ายของผู้ใช้ เช่น จำนวนเงิน วันที่ หมวดหมู่ และบัญชีที่เกี่ยวข้อง

{
  _id: ObjectId,
  userId: ObjectId,            // อ้างอิงไปยัง users._id (required)
  accountId: ObjectId,         // อ้างอิงไปยัง accounts._id (required)
  categoryId: ObjectId,        // อ้างอิงไปยัง categories._id (required)
  type: String,                // "income" หรือ "expense" (required)
  amount?: Number,             // จำนวนเงิน (optional)
  currency: String,            // สกุลเงิน เช่น "THB" (required)
  note?: String,               // หมายเหตุ (optional)
  date: Date,                  // วันที่ทำรายการ (required)
  status: String,              // "draft" หรือ "confirmed" (default: "confirmed")
  aiModel?: String,            // โมเดล AI ที่ใช้สร้างรายการ (optional)
  createdAt: Date,             // วันที่สร้างรายการ (auto)
  updatedAt: Date              // วันที่แก้ไขล่าสุด (auto)
}