Bài viết gần đây

| Backend tiệm nail: Express + PostgreSQL + 118 API (case study thực tế)

Được viết bởi thanhdt vào ngày 15/06/2026 lúc 07:37 | 34 lượt xem

Backend tiệm nail: Express + PostgreSQL + 118 API (case study thực tế)

Bài 2 trong loạt case study Vietnam Nails. Dành cho học viên khóa Lập trình NodeJS — thấy code production thật, không chỉ todo-list.

Kiến trúc monorepo nhẹ — đủ cho tiệm nail, không cần microservice

[React Client]  ──HTTP JSON──►  [Express server/routes.ts]
[Flutter App ]                  │
                                ▼
                         [storage.ts — Drizzle ORM]
                                │
                                ▼
                         [PostgreSQL Cloud]

[shared/*.ts]  ◄── import ──►  Client + Server (cùng quy tắc nghiệp vụ)

Vì sao quan trọng? Quy tắc giá, conflict lịch, voucher nằm trong shared/ — frontend và backend không thể “lệch nhau”. Đây là bài học cốt lõi khi dạy backend cho dự án SME.

Luồng API đặt lịch
Một request đặt lịch đi qua Express → PostgreSQL → trạng thái pending/completed

~118 API endpoint — nhóm theo domain

Module Ví dụ route Bài học
Users POST /api/users/login Auth, hash password, validation
Booking POST /api/appointments Conflict check, pricing server-side
Wallet POST /api/transactions State machine pending → completed
Reviews GET /api/reviews/recent Filter 5★ + join tên dịch vụ
Chat POST /api/chat/messages CRUD, read receipt, admin threads
Admin GET /api/admin/chat/threads requireOwner, phân quyền

3 pattern code đáng học trên lớp NodeJS

1. Logic dùng chung — shared/priceRound.ts

Giá slot làm tròn lên số nguyên; hóa đơn giữ 2 số thập phân. Một file — client preview và server tính tiền cùng kết quả.

2. Trạng thái lịch — shared/appointmentStatus.ts

countsTowardRevenue() chỉ trả true khi completed. appointmentStatusSync.ts tự chuyển pending khi qua giờ hẹn — giảm phụ thuộc thao tác tay lễ tân.

3. Repository mỏng — server/storage.ts

Route không viết SQL trực tiếp. Ví dụ getRecentReviews(): filter rating = 5, map thêm serviceName từ bảng services.

Migration khi boot server

Dự án dùng CREATE TABLE IF NOT EXISTS và ALTER TABLE ... ADD COLUMN IF NOT EXISTS trong routes.ts — phù hợp deploy single-server (Render, VPS). Học viên hiểu trade-off: nhanh go-live vs migration tool chuyên nghiệp (Prisma migrate, Flyway).

Học NodeJS từ case study này

Khóa Lập trình NodeJS — Express API tại Hướng Nghiệp Dữ Liệu dạy đúng stack:

  • Express routing & middleware
  • PostgreSQL + ORM
  • Authentication admin
  • CRUD nghiệp vụ thật
  • Deploy API production

Lab đề xuất cho giảng viên: clone module booking → GET /api/services + POST /api/appointments + test conflict cùng giờ.

📞 Tư vấn khóa học: 0934 145 100 · thanhdt9279@gmail.com

Hướng Nghiệp Dữ Liệu · huongnghiepdulieu.com