Kittiwana Notify Platform

ภาพรวมระบบ API Reference Notification Channels Roadmap Privacy Policy Terms of Use

ภาพรวมระบบ

Kittiwana Notify Platform เป็นระบบแจ้งเตือนภายในองค์กร พัฒนาและให้บริการโดย บริษัท สมาร์ทเพลส 304 ไอพี 3 จำกัด (ในเครือกลุ่มกิตติวนา) รองรับการส่งการแจ้งเตือนผ่านหลายช่องทาง

Tech Stack

Runtime: Node.js
Framework: Express.js 5
Database: SQL Server (Prisma ORM)
Auth: JWT (7 วัน)
Build: @vercel/ncc
Process: PM2

Security

JWT Authentication (7-day expiry)
Resource-level Authorization
Helmet + CORS Whitelist
Rate Limiting (100 req/15min)
Input Query Whitelist

Notification Channels

iOS (APNs) Active

Push Notification ผ่าน Apple Push Notification service

Library: node-apn
รองรับ title, body, badge, sound
Config เก็บใน DB (ApplicationIOSConfig)
รองรับ Sandbox + Production

Email (SMTP) Active

ส่งอีเมลผ่าน SMTP Server

Library: nodemailer
รองรับ HTML body, CC
Config ผ่าน Environment Variables

Android (FCM) Active

Push Notification ผ่าน Firebase Cloud Messaging

Library: firebase-admin
FCM HTTP v1 API
Config เก็บใน DB (ApplicationAndroidConfig)
รองรับ high priority + custom data

LINE Active

แจ้งเตือนผ่าน LINE Messaging API

Library: @line/bot-sdk
Push Message + Flex Message
Webhook — ลงทะเบียน user อัตโนมัติผ่าน Bot
Config เก็บใน DB (ApplicationLINEConfig)
รองรับ multi-user push

API Reference

ทุก endpoint (ยกเว้น /auth/*) ต้องมี JWT token หรือ API Key ใน header:

Authorization: Bearer <jwt_token>    (Mobile App)
Authorization: ApiKey <api_key>      (External System)

Authentication

Method	Endpoint	Description
POST	`/auth/register`	ลงทะเบียน / เข้าสู่ระบบ
POST	`/auth/tokenVerify`	ตรวจสอบ JWT token

HRMS Info (ข้อมูลพนักงาน)

Method	Endpoint	Description
GET	`/hrmsInfo`	ดึงข้อมูลพนักงาน
POST	`/hrmsInfo/create`	สร้างข้อมูลพนักงาน
PUT	`/hrmsInfo/update`	อัปเดตข้อมูลพนักงาน
DELETE	`/hrmsInfo/delete`	ลบข้อมูลพนักงาน

Notification Log

Method	Endpoint	Description
GET	`/hrmsNotificationLog`	ดึง notification log
POST	`/hrmsNotificationLog/create`	สร้าง notification log
PUT	`/hrmsNotificationLog/update`	อัปเดต (mark read/unread)
PUT	`/hrmsNotificationLog/update/setIsRead/all`	Mark all as read/unread
DELETE	`/hrmsNotificationLog/delete`	ลบ notification log

Device Token

Method	Endpoint	Description
GET	`/hrmsStaticToken`	ดึง device token
POST	`/hrmsStaticToken/create`	ลงทะเบียน device token
PUT	`/hrmsStaticToken/update`	อัปเดต device token
DELETE	`/hrmsStaticToken/delete`	ลบ device token

Notification Sending

Method	Endpoint	Description
POST	`/notify/send`	ส่ง notification ทุก platform (Unified API)
POST	`/ios/send`	ส่ง iOS push notification
POST	`/ios/badge`	ตั้งค่า badge count
POST	`/line/send`	ส่ง LINE push message
POST	`/line/flex`	ส่ง LINE Flex Message
POST	`/android/send`	ส่ง Android push notification (FCM)
POST	`/line/webhook/:appCode`	LINE Webhook (ลงทะเบียน user อัตโนมัติ, no auth)
POST	`/mail/send`	ส่ง email

Admin

Method	Endpoint	Description
POST	`/admin/application/register`	ลงทะเบียน application + สร้าง API Key
POST	`/admin/application/regenerateKey`	สร้าง API Key ใหม่
GET	`/admin/application`	ดูรายการ application ทั้งหมด

Response Format

{
  "status": "SUCCESS",
  "data": { ... }
}

// Error
{
  "status": "ERROR",
  "message": "Error description"
}

Rate Limiting

API จำกัดที่ 100 requests ต่อ 15 นาที ต่อ IP — หากเกินจะได้ HTTP 429:

{
  "status": "ERROR",
  "message": "Too many requests, please try again later"
}

Development Roadmap

Phase 1: Bug Fixes & Stability COMPLETED

แก้ bug ทั้งหมด, standardize response format, รวม hardcoded values

Phase 2: Security Hardening COMPLETED

JWT expiration, resource-level auth, CORS whitelist, rate limiting, query whitelist, zod validation, request size limit

Phase 3: Performance & Optimization COMPLETED

Composite index, pagination, orderBy, APNs caching, concurrent scheduled tasks, code cleanup

Phase 4: New Features COMPLETED

LINE Notification, Android FCM, Notification Management, Soft Delete, Multi-Notify API, External System API (API Key auth)

Phase 5: Production Readiness ~20%

Health check, global error handler, .env.example — เหลือ: structured logging, Swagger, testing, PM2 config

Phase 6: Advanced Features NOT STARTED

WebSocket real-time, message queue (Bull/Redis), multi-tenant, analytics dashboard