# 01 — Discovery

**Project:** website-tuvi
**Date:** 2026-05-30
**Reference site:** https://diencamtamthe.com/

---

## 1. Persona — Mass market (Vietnamese, 18–55)

Hai nhóm chính, design phải cover cả hai:

### Persona A — Genz/Millennial (18–30)
- **Role/Context:** học sinh, sinh viên, dân văn phòng trẻ
- **Tech skill:** cao, dùng app/social hằng ngày
- **Device:** smartphone (iOS/Android), thỉnh thoảng laptop
- **Channels:** TikTok, Instagram, Facebook reel
- **Mood:** thích UI đẹp, animation, dễ share, tarot-like aesthetic
- **Vocabulary:** "cung hoàng đạo", "thần số học", "hợp tuổi yêu", "hôm nay tử vi nói gì"

### Persona B — Trung niên (35–55)
- **Role/Context:** bố mẹ, doanh nhân, người chuẩn bị xây nhà/cưới hỏi
- **Tech skill:** trung bình, ngại UI phức tạp
- **Device:** smartphone (Zalo/FB), ít dùng máy tính
- **Channels:** Facebook group, Zalo, search Google
- **Mood:** muốn UI to, rõ, chữ dễ đọc, ít animation, kết quả đáng tin
- **Vocabulary:** "lá số tử vi", "ngày tốt", "phong thủy nhà", "tuổi gì làm ăn được"

### Hệ quả design
- **Mobile-first 100%** — design 375px trước
- Typography: cỡ chữ body ≥ 16px, line-height thoáng (1.6+) cho persona B
- Tone visual có thể trẻ trung nhưng phải giữ cảm giác **truyền thống/đáng tin** (gold + đỏ đô + đen) — không quá trendy/flashy
- Vietnamese text (~25% dài hơn EN) → buttons/labels cần room đủ

---

## 2. Jobs-to-be-done — ưu tiên trang chủ

| # | Job | Tỷ trọng |
|---|---|---|
| 🥇 | Xem **lá số tử vi trọn đời** (nhập ngày sinh → 12 cung) | Cao nhất |
| 🥈 | Hỏi **AI luận giải vận mệnh** (chat-style, hỏi tự do) | Cao |
| 🥉 | Tra **ngày tốt** (khai trương, cưới, động thổ) | Cao |
| 4 | 22 công cụ phụ (tứ trụ, thần số, hợp tuổi, phong thủy nhà...) | Trung bình |
| 5 | Đọc blog kiến thức (sao, cung, ngũ hành) | Trung bình |

→ Trang chủ:
- Hero CTA chính: **"Xem tử vi trọn đời"** (form ngày sinh ngay above-fold)
- 2 CTA phụ ngang: **"Hỏi AI luận giải"** + **"Xem ngày tốt"**
- Section "Tất cả công cụ" group 25+ tool theo nhóm
- Section "Tử vi hôm nay" / "Lục diệu theo giờ" — quick-check
- Section blog (SEO content)

---

## 3. Usage Context

- **Device:** mobile-first (90%+), desktop có nhưng không ưu tiên
- **Breakpoints:** 375 / 768 / 1024 / 1440 — mobile design chuẩn xong rồi scale up
- **Frequency:** mix giữa **one-shot** (xem ngày tốt cho 1 sự kiện) và **recurring** (tử vi ngày, tử vi năm)
- **Network:** giả định 4G Việt Nam — page < 200KB initial, lazy load aggressive
- **Locale:** vi_VN duy nhất (không multi-lang ở MVP)

---

## 4. Success Criteria — mass approach (cân bằng cả 4)

| Mục tiêu | KPI cụ thể | Ưu tiên |
|---|---|---|
| (a) SEO traffic | Google index 25+ tool pages, schema markup, CWV xanh, blog dày | Cao |
| (b) User signups + retention | Signup rate, DAU/MAU, "lá số của tôi" usage | Cao |
| (c) Engagement | Tools/session, time on site, cross-link CTR | Trung bình |
| (d) Conversion AI calls | Free→paid AI conversion (sau khi launch monetization) | Trung bình (Phase 2) |

**Hệ quả:**
- Mỗi tool page là một **landing page SEO độc lập** (URL, title, meta, schema)
- Auth + dashboard "lá số của tôi" là core feature (không phải optional)
- Cross-link giữa tool ("đã xem tử vi → xem thêm phong thủy nhà phù hợp")
- Blog skeleton từ đầu (content fill sau)
- Free tier AI giới hạn → upgrade Premium (hook nhưng chưa enforce ở MVP)

---

## 5. Constraints

### Timeline
- **Càng nhanh càng tốt** — MVP 1–2 tuần, refactor sau
- → Ưu tiên ship được, không over-engineer
- → Logic tử vi/lịch âm chính xác > UI hoàn hảo (có thể polish sau)

### Brand identity
- **Chưa có gì** — Carla propose toàn bộ
- Đề xuất sẽ submit ở Stage 2 (ui-reference) + Stage 3 (ui-system):
  - Tên site (đề xuất 3 lựa chọn)
  - Logo concept (text-based đầu tiên, refine sau)
  - Color palette: gold + đỏ đô + đen (Á Đông cao cấp), dark mode mặc định

### Domain & Language
- Domain: chưa có, sẽ propose cùng tên brand
- Language: **chỉ tiếng Việt**

### Budget AI — thoải mái ($100+/tháng)
- Cho phép user dùng AI rộng rãi
- Vẫn có rate limit cơ bản chống abuse (vd: 50 calls/user/ngày free, 500/ngày premium)
- Cache kết quả luận giải (key = hash(ngày sinh + cung) → reuse lại)
- Provider: OpenAI GPT-4o-mini default (rẻ + tiếng Việt tốt) + fallback Claude

### Compliance & SEO
- ✅ **Disclaimer "chỉ mang tính tham khảo"** — sticky footer + popup khi xem kết quả AI lần đầu
- ✅ **Cookie consent banner** — GDPR-lite, opt-in cho Analytics
- ✅ **Google Analytics 4 + Tag Manager** — track theo events (tool_view, tool_complete, ai_query, signup)
- Schema markup: WebSite + BlogPosting + HowTo cho tool pages

---

## Gate — Stage 1 EXIT CRITERIA

- [x] ≥1 persona → 2 personas (A: genz, B: trung niên)
- [x] ≥1 JTBD → 5 JTBD ranked
- [x] ≥1 success criterion → 4 KPIs

✅ **PASS** — Sẵn sàng vào Stage 2 (ui-reference)