Gap: HomeFix (api.homefix.asia) vs WELIFE
Live
https://api.homefix.asia/docsđang 502 Bad Gateway (toàn bộ host).
Đối chiếu dựa trên snapshot local:docs/references/homefix-swagger-snapshot.json
(title trong snapshot: Baotienweb API — backend phục vụ HomeFix).
Số liệu
| Chỉ số | HomeFix snapshot | WELIFE (2026-07-27) | Mục tiêu WELIFE |
|---|---|---|---|
| Tags | 103 | 33 | ~40+ (đúng domain WELIFE) |
| Paths | ~902 | ~200 | contract theo UI + pattern HF |
| Operations | ~1121 | 254 (197 IMP / 57 STUB) | stub → implement dần |
| Schemas | ~414 | DTO mỏng + StubResponse | DTO theo module |
Chi tiết: SWAGGER-AUDIT.md · ma trận 01-MATRIX-TRACEABILITY.md §F.
Khác biệt domain
HomeFix có nhiều module xây dựng / CRM / commissioning (Inventory 51, Change Orders, QC, Fleet…) — không copy nguyên vào WELIFE.
Nên học / port pattern từ HomeFix:
| HomeFix tag | → WELIFE |
|---|---|
| OTP + Auth + Sessions + 2FA + Social | auth mở rộng |
| User Addresses | addresses |
| Profile + KYC + Account Deletion | users / kyc |
| Upload + Presigned | media |
| Marketplace Wallet + Payment (MoMo/VNPay) | wallet / payments |
| Cart + Orders + Products | cart / orders / F&B·grocery·pharmacy catalog |
| Notifications + Push Tokens | notifications |
| Chat + Conversations | chat |
| Reels + Video Interactions | social / reels |
| Ratings | reviews |
| AI Agent (general-chat) | assistant |
Kết luận
WELIFE đúng là thiếu rất nhiều so với HomeFix docs. Đang bổ sung Swagger contract (stub) theo pattern HomeFix + UI WELIFE — endpoint trả { status: 'stub' } cho đến khi implement thật.