⏳ Cuộc Sống 24 Giờ (24-Hour Life)

Game mô phỏng đưa ra quyết định thực tế về quản lý thời gian, năng lượng, tài chính và bẫy dopamine trong 24 giờ mỗi ngày.

---

🌟 Giới Thiệu Tổng Quan

"Cuộc sống 24 giờ" không phải là một trò chơi dạy đạo lý hay bắt bạn sống như một cỗ máy hoàn hảo. Trò chơi đặt bạn vào một mô phỏng thực tế: Bạn có đúng 24 giờ mỗi ngày, đối diện với các áp lực sinh hoạt, chi phí thuê nhà, công việc, các mối quan hệ xã hội và đặc biệt là những cơn thèm dopamine ngắn hạn của bộ não.

Mục tiêu của game là giúp người chơi tự nhận diện khoảnh khắc:

"Ơ, mình vừa đưa ra một lựa chọn tưởng chừng nhỏ nhặt và vô hại, nhưng cái giá phải trả vào ngày mai lại lớn đến thế!"

---

🧠 Thiết Kế Cốt Lõi (Core Mechanics)

1. Hệ thống 6 Chỉ số Đan xen

Chỉ số	Vai trò & Ý nghĩa	Hậu quả khi cạn kiệt / vượt ngưỡng
⚡ Năng Lượng (0–100%)	Sức lực thể chất để hoạt động trong ngày	Khi $\le 10%$: Kiệt sức hoàn toàn (Burnout).
🧠 Tinh Thần (0–100%)	Sức khỏe tâm lý, khả năng chịu đựng stress	Khi $\le 15%$: Trầm cảm, lo âu, tê liệt quyết định.
🛡️ Ý Chí (0–100%)	Cơ chế cốt lõi mới: Sức kháng cự trước cám dỗ	Khi $< 35%$: Kích hoạt hiệu ứng Ảo giác Cám dỗ!
✨ Dopamine (0–100%)	Mức độ hưng phấn và kích thích thần kinh	Nếu hôm đó dồn nhiều dopamine nhanh (≈ 45 điểm từ hành vi cám dỗ hoặc ≥ 3.5 giờ): Gây Dopamine Crash vào sáng hôm sau. Dopamine cao nhờ học tập, vận động không bị phạt.
👥 Kết Nối (0–100%)	Mối quan hệ với gia đình, bạn bè	Khi $< 25%$: Sự cô đơn làm xói mòn tinh thần tự động mỗi ngày.
💰 Tài Chính (nghìn VNĐ)	Ngân sách sinh hoạt và chi trả các nhu cầu	Tự trừ tiền trọ 120k/ngày. Nếu âm tiền: Khủng hoảng nợ nần.

---

2. Hai Con Đường Dopamine: Nhanh vs Chậm (Neuroscience Framework)

Game mô phỏng thực tế khoa học thần kinh về 2 cơ chế giải phóng dopamine:

• ⚡ Dopamine Nhanh (Fast / Cheap Dopamine):
  • Hoạt động: Doomscrolling TikTok, cày game gacha, đồ ăn siêu ngon miệng, mua sắm bốc đồng, nhậu nhẹt, caffeine ép tỉnh, và trò nghịch dại "chọc chó" tìm cảm giác mạnh.
  • Đặc điểm: Không cần nỗ lực, kích thích tức thì, nhưng tụt dốc rất nhanh (crash), hạ thấp dopamine baseline và đối mặt với rủi ro đắt giá (bị chó rượt, tiêm phòng dại).
• 🌱 Dopamine Chậm (Slow / Healthy Dopamine):
  • Hoạt động: Học tập chuyên môn sâu (Flow State), Luyện kỹ năng mềm & EQ, Chạy bộ, đi bộ phơi nắng, vuốt ve thú cưng, học đàn, trò chuyện sâu, thiền định, bữa ăn giàu tyrosine.
  • Đặc điểm: Cần nỗ lực và thời gian, nhưng xây dựng cảm giác tự hào sâu sắc, nâng cao ngưỡng thỏa mãn tự nhiên và phục hồi ý chí.

---

2. Cơ chế Đặc biệt: Ảo Giác khi Ý Chí Thấp (Low-Willpower Illusion)

• Trong đời thực, khi bạn mệt mỏi và cạn kiệt ý chí, não bộ sẽ tự động tìm đường tắt dopamine.
• Trong game: Khi chỉ số Ý chí $< 35%$:
  • Các hành vi xấu (Lướt TikTok, Cày game xuyên đêm, Gọi đồ ăn nhanh) phát sáng viền hồng rực rỡ và hiển thị lượng Dopamine thưởng phóng đại gấp đôi (+40 Dopamine tức thì!).
  • Các hành vi tích cực (Tập thể dục, Học kỹ năng mới, Nấu ăn dinh dưỡng) bị mờ đi và bị phạt thêm chi phí sức ì nội tâm (-8 Ý chí phụ thu).

---

3. Hậu Quả Trễ Qua Đêm (Overnight Consequences)

• Hậu quả của các lựa chọn không chỉ xuất hiện tức thì mà tích tụ qua đêm:
  • Nợ ngủ lũy kế (Sleep Debt): Ngủ dưới 7 tiếng/ngày khiến nợ ngủ dồn lại. Khi nợ ngủ $\ge 6\text{h}$, bạn thức dậy với hội chứng sương mù não (Brain Fog).
  • Dopamine Crash: Ngày hôm trước lướt mạng và kích thích quá độ thì sáng hôm sau tỉnh dậy trong trạng thái trống rỗng, vô vị và bồn chồn.
  • Hé lộ quy luật ẩn (Ngày 3–5): Người chơi tự trải nghiệm và cảm nhận trước, sau đó game mới giải thích các bài học tâm lý học hành vi ở màn hình bình minh.

---

4. Kết Cục & Chia Sẻ

Mỗi ván kết thúc bằng một kết cục (10 kiểu người chơi, ví dụ Bậc Thầy Cân Bằng, Nô Lệ Dopamine, Ẩn Sĩ Ngủ Đông) cùng điểm 0–100. Người chơi có thể tạo ảnh chia sẻ ngay trên máy (Canvas, không server, không theo dõi).

---

5. Phòng Thí Nghiệm Mô Phỏng 1000 Ván (Simulation Bench)

Game tích hợp sẵn công cụ mô phỏng chiến thuật tự động ngay trên giao diện:

• Cho phép chạy 100, 500 hoặc 1000 ván chơi cho 5 phong cách sống:
  1. Dopamine Chaser: Ưu tiên lướt mạng, game, đồ ăn nhanh $\rightarrow$ Vui 1–2 ngày đầu, sau đó sụp đổ vào ngày 4–5.
  2. Workaholic: Cày tiền tối đa, ngủ 4–5 tiếng $\rightarrow$ Nhiều tiền nhưng sập vì Burnout.
  3. Pure Sleeper: Trốn tránh thực tế, chỉ ngủ và nằm $\rightarrow$ Phá sản vì không trả nổi tiền trọ.
  4. Party Animal: Tiệc tùng nhậu nhẹt $\rightarrow$ Kết nối cao nhưng cạn kiệt tài chính.
  5. Balanced Realist: Ngủ 8h, làm việc 4h, tập luyện và kết nối điều độ $\rightarrow$ Tỷ lệ sống sót cao nhất.

---

🏛️ Kiến Trúc "Clean Architecture Lite"

Dự án áp dụng chặt chẽ 3 nguyên tắc cốt lõi:

1. Domain logic KHÔNG import UI, KHÔNG import React, KHÔNG import localStorage: Mọi công thức tính toán, quy luật nhân quả và cân bằng số liệu được cô lập hoàn toàn tại packages/domain/src/.
2. Domain chỉ nhận input primitive, trả về output primitive: Mọi hàm nghiệp vụ giao tiếp bằng kiểu dữ liệu nguyên thủy (string, number, boolean, plain arrays) và trả về DTOs thuần túy.
3. UI + Storage là "adapter" cắm vào domain: React UI, LocalStorage và Web Audio đóng vai trò là các plugin/adapter cắm vào Domain Facade thông qua Controller Hook useGameAdapter.

src/
├── domain/                 # 🧠 PURE DOMAIN (Rule 1 & 2: NO React/UI/Storage, Primitive I/O)
│   ├── types.ts            # Kiểu dữ liệu primitive (PlayerStatsPrimitive, SoundCue, ...)
│   ├── stats.ts            # Toán học chỉ số, clampStats, evaluateLifeStatus
│   ├── actions.ts          # 15 hành vi, executeActionById(actionId, stats, hoursRemaining)
│   ├── consequence.ts      # processOvernightCycle(stats, actionIds, sleepDebt, day)
│   ├── events.ts           # rollDomainEvent, resolveDomainChoice
│   ├── simulate.ts         # runDomainSimulation (động cơ mô phỏng headless 1000 ván)
│   └── index.ts            # Facade API Domain duy nhất
│
├── adapters/               # 🔌 ADAPTER LAYER (Rule 3: Cắm UI, Storage, Audio vào Domain)
│   ├── storageAdapter.ts   # Cắm localStorage vào domain primitives
│   ├── audioAdapter.ts     # Cắm Web Audio API vào domain sound cues
│   └── useGameAdapter.ts   # Controller Hook kết nối UI và Domain Facade
│
├── ui/                     # 🖥️ VIEW LAYER: React components hiển thị thuần
│   ├── TopNav.tsx          # Thanh điều hướng 3 vùng
│   ├── StatsHUD.tsx        # Bảng đo 6 chỉ số phản hồi động
│   ├── TimeTrack.tsx       # Thanh quỹ thời gian 24 giờ
│   ├── ActionCard.tsx      # Thẻ hành vi (ảo giác khi ý chí thấp)
│   ├── ActionGrid.tsx      # Lưới hành vi & bộ lọc danh mục
│   ├── MorningModal.tsx    # Hộp thoại bình minh & cơ chế ẩn
│   ├── EventModal.tsx      # Hộp thoại biến cố bất ngờ
│   ├── WeekReviewModal.tsx # Hộp thoại tổng kết tuần & câu hỏi phản tư
│   ├── SimulationBench.tsx # Bàn thí nghiệm mô phỏng thuật toán
│   └── GuideModal.tsx      # Hướng dẫn quy luật & triết lý
│
├── App.tsx                 # View Root điều phối qua useGameAdapter
└── main.tsx                # Entry point

---

🛠️ Hướng Dẫn Cài Đặt & Chạy Thử

Yêu Cầu Môi Trường

• Node.js: $\ge 18.0.0$
• npm hoặc yarn / pnpm

Khởi Chạy Dự Án

# 1. Cài đặt các gói phụ thuộc
npm install

# 2. Khởi chạy máy chủ phát triển
npm run dev

Khi deploy, đặt biến môi trường VITE_SITE_URL (trên Vercel tự nhận) để thẻ OG có URL tuyệt đối.

Mở trình duyệt tại địa chỉ: http://localhost:3000

Kiểm Tra Build & Linting

# Kiểm tra TypeScript
npm run lint

# Build bản phát hành (Production)
npm run build

Chơi nhiều người (tab "Chơi cùng bạn")

2–8 người cùng sống một tuần trong một thành phố 3D: mỗi người tự lo 24 giờ của mình, rủ nhau làm hoạt động chung (ăn, chạy bộ, học nhóm, tâm sự, xem phim, nhậu), động viên nhau; server tính mọi chỉ số, client chỉ gửi ý định. Không streak, không bảng xếp hạng, không quảng cáo. Chạy thử: npm run dev:all, mở http://localhost:3000 (vài tab), tab Chơi cùng bạn → tạo phòng → gửi mã 4 ký tự. Số liệu cân bằng nhóm và phiếu playtest: ROADMAP.md, PLAYTEST.md. Triển khai server: docs/deploy-server.md.

Cấu Trúc Monorepo (npm workspaces)

packages/domain   @24h/domain  luật chơi thuần, build bằng tsc -> dist (chạy được cả trong Node)
apps/web          @24h/web     Vite + React (import @24h/domain)
apps/server       @24h/server  Colyseus 0.18: LifeRoom (nhiều người chơi, server quyết định mọi chỉ số)

• Ở root: npm run dev | build | lint | test chạy qua các workspace (domain trước, rồi web).
• apps/web đọc thẳng packages/domain/src (điều kiện source trong exports) nên có HMR và không cần build domain trước; Node/server dùng dist.
• Chạy cả web + server: npm run dev:all. Triển khai server (Docker, Fly.io, CORS, VITE_SERVER_URL): xem docs/deploy-server.md.
• Server: npm run dev -w @24h/server (watch) hoặc npm run build && npm start -w @24h/server. Biến môi trường PORT (mặc định 2567); GET /health trả {status:"ok"}.
  • Tạo phòng: client.create("life") -> mã 4 ký tự là room.roomId; vào phòng: client.joinById(code, {name}). Tối đa 8 người, phòng không liệt kê công khai.
  • Client chỉ gửi action {actionId}, move {x,z}, chat {text}; server validate và áp dụng bằng @24h/domain. Message lạ bị ngắt kết nối.
  • Vòng đời ngày: planning (240s, chỉnh bằng env PLANNING_SECONDS; hành động + ready) → night (server chạy processOvernightCycle cho từng người) → morning (mỗi client nhận morning = báo cáo riêng của mình; 20s hoặc mọi người ready) → ngày kế. Sau ngày 7 hoặc khi mọi người sụp đổ: ended. Phòng khóa sau đêm đầu tiên.
  • Hành vi chung (6 loại: ăn cùng, chạy bộ cùng, học nhóm, tâm sự sâu, xem phim, rủ đi nhậu): joint {op:'offer'|'join'|'leave'|'start'}. Người rủ (host) tạo lời rủ, người khác nhận invite và vào, host bắt đầu (hoặc đầy chỗ thì tự chạy). Kết quả tính bằng resolveJointAction; nudge {targetId} gửi lời động viên (hồi ý chí nhẹ, tối đa 3 lần/ngày). Lời rủ cám dỗ (nhậu) kéo nhẹ ý chí của người ý chí thấp, và trong buổi nhậu người ý chí thấp dễ bị kéo ở lại thêm (áp lực đồng trang lứa).
  • Ngắt kết nối: giữ chỗ 60s (vào lại bằng reconnect(token) và nhận lại báo cáo sáng nếu đang morning), sau đó bot Balanced chơi thay (player.bot = true). Người ngắt kết nối và bot không chặn việc sang phase kế.
  • Rng của mỗi người chơi seed theo roomSeed + playerId + day (roomSeed do server sinh, không gửi cho client).
• Vercel: đặt = (giữ bật "Include source files outside of the Root Directory"). nằm trong .

---

📋 Bản Đồ Tiến Độ (Roadmap)

Chi tiết tiến độ phát triển theo từng tuần, danh sách các đầu việc đã nghiệm thu và chỉ dẫn dành cho Agent được lưu trữ tại file ROADMAP.md:

• Tuần 1 & 2: Logic headless, 6 chỉ số, bẫy ý chí, mô phỏng thuật toán và UI vòng lặp 7 ngày [ĐÃ HOÀN THÀNH].
• Tuần 3: Playtest với 5 người dùng thực tế & mở rộng biến cố [ĐANG TRIỂN KHAI].
• Tuần 4 – 6: Tinh chỉnh cân bằng từ dữ liệu mô phỏng, âm thanh ambient, đo lường chỉ số D1/D7 và kế hoạch phát hành [KẾ HOẠCH].

---

📄 Triết Lý Phát Triển (Zero Dark Patterns)

Dự án kiên quyết tuân thủ:

• Không quảng cáo gây phiền toái hoặc cơ chế "xem video để hồi năng lượng".
• Không chuỗi đăng nhập vô nghĩa (streak) để giữ chân ảo.
• Không bảng xếp hạng ganh đua làm lệch lạc thông điệp về sự cân bằng cá nhân.
• Mọi dữ liệu được lưu cục bộ an toàn trên thiết bị của người chơi thông qua localStorage.