# NOWA — User research planning

Ngày: **08/10/2026** · Owner: **Huy** · Trạng thái: **Bản đề xuất để thảo luận, chưa chốt tuyển mẫu**.

Mục đích: chuyển các thắc mắc của người thiết kế NOWA thành câu hỏi nghiên cứu có thể trả lời, chọn đúng người, đúng thời điểm và đúng phương pháp; dùng kết quả để quyết định thông điệp, trải nghiệm sản phẩm và gói giá.

## Bắt đầu ở đây

- **[Trang HTML tương tác](index.html)**: mô tả dự án, mục tiêu và ngân hàng câu hỏi; tìm kiếm không dấu, lọc kết hợp, sắp xếp từng cột, ẩn/hiện cột, xuất CSV theo kết quả đang lọc.
- [01 — Các câu cần làm rõ với Huy](01-clarifications.md).
- [02 — Research từ tài liệu, code, tài nguyên và website](02-research-evidence.md).
- [03 — Thiết kế hai project và kế hoạch phân tích](03-study-plan.md).
- [04 — Đối tượng, criteria và screener](04-recruitment-screener.md).
- [05 — Ngân hàng câu hỏi](05-question-bank.md): cùng dữ liệu với HTML, không phải một survey khổng lồ.
- [06 — Flow survey, interview và dùng thử](06-session-guides.md).
- [07 — Biểu mẫu ghi nhận, kiểm tra chất lượng, checkpoint](07-capture-and-review.md).
- [08 — Bản đồ thắc mắc gốc và bổ sung](08-coverage.md).

## Hướng nghiên cứu đề xuất

**Project 1 / Survey tự xây:** tích hợp video, hình và simulation ngắn; kiểm tra người mới hiểu gì, kỳ vọng gì, có nhu cầu nào, thấy giá trị gì, phản ứng với một gói giá cụ thể ra sao. Phân tích riêng theo mức quen thuộc với game nuôi pet và tuổi trẻ.

**Project 2 / Interview:** đào sâu lý do, quan sát pairing/onboarding và, nếu gửi thiết bị, theo dõi D1–D3–D7 trước buổi phỏng vấn cuối. Giữ cả gia đình không dùng hoặc bỏ dở. Nếu không gửi máy, chỉ kết luận về concept và usability trong phiên; không kết luận về engagement một tuần.

**Ba quyết định ưu tiên đề xuất:** (1) người xem có hiểu đúng và thấy phù hợp không; (2) giá trị thực tế có vượt công sức phụ huynh phải bỏ ra không; (3) phần nào nên nằm trong thiết bị/gói cơ bản/Nowa+. Huy chưa xác nhận thứ tự này.

## Phạm vi và cách sử dụng

Đây là công cụ lập kế hoạch nội bộ bằng tiếng Việt. Chưa có dữ liệu participant, chưa tạo project trên User Interviews, chưa liên hệ ai. Thị trường Mỹ, câu hỏi participant-facing bằng tiếng Anh đã được Huy xác nhận; wording cần pilot. Trang HTML đọc `questions.json` qua local server, không CDN, không analytics, không ghi nhận câu trả lời của gia đình.

Code được đọc từ các ref `origin/develop` đã fetch ngày 08/10: app `a578c7a`, API `7b9cd38`, firmware `de53d77b`; không đổi branch/checkouts. Nguồn web truy cập cùng ngày. Code có tính năng không có nghĩa build gửi cho gia đình đã triển khai tính năng đó.

## Xem trang

[Mở trang đang chạy](http://127.0.0.1:8766/). Nếu server đã tắt, từ folder này chạy `python3 -m http.server 8766 --bind 127.0.0.1`, rồi mở lại link.

## Rule book

Đọc [16 — Research question rule book](16-research-rulebook.md) trước khi sửa hoặc thêm câu. Nguồn: The Mom Test, Pew, NN/g và GOV.UK; có quy tắc riêng cho NOWA, checklist đáp án và giới hạn diễn giải. Xem [audit wording/đáp án](docs/audits/2026-10-10-question-wording-audit.md).

## Bảo trì

`questions.json` là nguồn dữ liệu duy nhất. `index.html` đọc file này; `build.py` xác thực và sinh `05-question-bank.md`, `08-coverage.md`. Khi sửa câu hỏi, sửa JSON rồi chạy `python3 build.py`. Xem [data contract](DATA-CONTRACT.md). Các file Markdown còn lại là tài liệu viết tay. Không lưu dữ liệu nghiên cứu cá nhân vào folder này.

## Assumptions & Confidence

| Giả định | Cơ sở | Nếu sai | Tin cậy |
|---|---|---|---|
| Đợt này nghiên cứu người mua là phụ huynh và người dùng là trẻ 3–10 | Brief + docs | Đổi screener và chia nhóm | Cao |
| Mỹ/English, homepage và preorder live | Huy xác nhận | Khóa phiên bản stimulus khi fieldwork | Cao |
| Ngân sách, build và thiết bị chưa chốt | Chưa có xác nhận | Phải điều chỉnh trước launch | Cao |
| Hai project là cấu trúc nghiên cứu mong muốn | Brief | Cấu hình platform có thể cần tách nhánh dùng thử | Cao |

Confidence tổng thể: cao với phạm vi cần nghiên cứu; trung bình với thiết kế mẫu; chưa có bằng chứng xác nhận giả thuyết khách hàng.

## Lọc phương thức và đọc màu nhóm

Chọn **Ưu tiên Survey** hoặc **Ưu tiên Interview** để xem câu được phân bổ tối ưu cho project đó, không phải mọi phương thức có thể dùng. Mỗi dòng có lý do phân bổ; Survey core là tập ngắn trong toàn bộ câu ưu tiên Survey. Màu nền theo nhóm thông tin, không theo phương thức.

## Trình bày trong buổi họp

1. **01 · Mục tiêu & câu hỏi:** đọc sáu điểm chưa chắc dưới góc nhìn người build; nối thông tin cần thu với quyết định. Dùng bảng để minh họa việc phân rã thành câu hỏi và các dimension.
2. **02 · Survey:** criteria → screener → bảng thành phần trải nghiệm → 39 mục đề xuất theo flow; có thể mở toàn bộ câu phù hợp và lọc chip để thảo luận module bổ sung.
3. **03 · Interview:** criteria → screener → chọn concept hoặc trial; flow trial đi từ first-use qua diary đến exit. Đây là menu điều phối, chọn probe theo thời lượng.

Pre-condition hiển thị bằng chip. Mở bộ lọc, chọn nhiều tag, chọn OR/AND. Mở “Điều kiện chi tiết” trong từng dòng trước khi quyết định hỏi participant. Chuyển tab/phạm vi sẽ reset bộ lọc; Đặt lại giữ tab/phạm vi và khôi phục thứ tự flow. Giá, cỡ mẫu, lịch và logistics còn là proposal cần chốt.

## User journey — 09/10

Trước bảng đầu tiên có 9 bước hành trình và các quyết định minh họa sau nghiên cứu. Canvas hiển thị 9 node ngang; kéo vùng trống hoặc thanh cuộn đáy để xem tiếp. Bấm node mở side panel và highlight câu liên quan; bấm lại để bỏ chọn. Highlight độc lập với dropdown “Lọc theo user flow”. Nút Bỏ highlight không thay đổi bộ lọc. Bank hiện 103 câu (54 Survey / 49 Interview); Q93–Q98 là probe mới, không bắt buộc hỏi hết. Xem [14-user-journey.md](14-user-journey.md).

## Hosting on a VPS

Serve the repository root with Nginx or another static HTTP server; `index.html` is the entry point. Keep `questions.json` and Markdown files at their relative paths. No Node dependencies, database, or application backend are required. `build.py` is an optional Python 3 validation/document-generation step, not a runtime server.

Local preview: `python3 -m http.server 8766 --bind 127.0.0.1`, then open http://127.0.0.1:8766/. Direct file:// opening does not reliably load JSON.

Deny access to dotfiles, particularly `.git`, and restrict access to this internal research workspace. The VPS needs an authorized GitHub identity to clone this private repository.

## Audit 09/10/2026

[Audit độc lập ba agent](docs/audits/2026-10-09-research-planner-audit.md): findings về instrument, recruitment và UI; phân biệt lỗi đã xác minh, quyết định mở và mô tả đã sửa.

## Survey tự xây

[17 — Thành phần trải nghiệm](17-custom-survey-components.md) là kế hoạch cần build, chưa phải survey participant đã chạy. Bảng components trong tab Survey dùng cùng tag với câu hỏi và có thể bấm lọc. 23 câu chuyển sang Survey, 3 câu mới cho simulation; flow 39 mục cần pilot lại thời lượng. Bản concept-only 19 mục giữ làm tham chiếu. Screener hiện 4 câu chung + 2 trial; tuổi từng trẻ nhập tự do và duyệt trước approve.