Tài liệu Nhà Chung V1

Toàn bộ tài liệu thiết yếu cho người dùng public beta và app nội bộ.

Tổng quan

Nhà Chung là social product tập trung vào thảo luận rõ ràng, kiểm chứng, phản biện có ích và AI hỗ trợ sensemaking. V1 public beta gồm feed công khai, tài khoản thành viên, post/comment/vote/save, AI summary, hồ sơ cá nhân và app nội bộ cho nhóm vận hành.

Onboarding

  • Mở trang chủ để xem feed, chủ đề nổi bật và thảo luận mới.
  • Đăng ký tại login để tạo tài khoản thành viên.
  • Sau khi đăng nhập bạn có thể đăng bài, bình luận, lưu bài viết và nhận thông báo.
  • Hồ sơ cá nhân ở profile cho phép cập nhật tên, username, bio và xem thông báo.

AI hoạt động ra sao

  • AI summary là công cụ hỗ trợ đọc nhanh, không thay thế bài gốc.
  • Hệ thống moderation AI có thể gắn nhãn hoặc đưa nội dung vào hàng chờ review nếu phát hiện rủi ro.
  • Khi AI chưa được cấu hình hoặc đang lỗi, UI sẽ hiển thị trạng thái fail-safe thay vì trả dữ liệu giả.

Quy tắc cộng đồng

  • Tấn công cá nhân, spam, lừa đảo và phát tán nội dung độc hại bị cấm.
  • Phát biểu như dữ kiện nên có nguồn hoặc ngữ cảnh đủ rõ.
  • Không lạm dụng AI để tạo hàng loạt nội dung rác hoặc thao túng thảo luận.
  • Khi phản biện, ưu tiên chất lượng lập luận hơn cường độ cảm xúc.

Quyền riêng tư

  • Cookie phiên được dùng để duy trì đăng nhập và bảo vệ thao tác người dùng.
  • Hồ sơ public không hiển thị email của thành viên cho người khác.
  • Thông báo và dữ liệu tài khoản chỉ hiển thị cho chính chủ sau đăng nhập.
  • Tích hợp AI và Flow API chỉ nên dùng trên dữ liệu mà bạn có quyền xử lý.

Điều khoản

  • Người dùng chịu trách nhiệm với nội dung mình đăng.
  • Nhà Chung có thể giới hạn hoặc khóa tài khoản vi phạm quy tắc cộng đồng.
  • Các tính năng public beta có thể thay đổi để cải thiện độ ổn định và an toàn.

Moderation

  • Moderation queue dành cho `admin` hoặc `moderator` trong app nội bộ.
  • Nội dung bị AI gắn cờ không tự động xóa; nó được đưa vào hàng chờ để review thủ công.
  • Quyết định moderation hiện có các trạng thái `approved`, `rejected`, `escalated`.

Admin Lite

  • `/app/*` là khu vực nội bộ, yêu cầu tài khoản có quyền app access.
  • Dashboard hiện tập trung vào flow inventory và thao tác tạo nhanh flow.
  • Tài khoản thành viên public đăng nhập được vào site nhưng không vào được app nội bộ.

Builder

  • Builder cho phép sửa `definition_json`, lưu draft, validate, preview và chạy flow nội bộ.
  • Autosave hoạt động trên draft của flow hiện tại.
  • Builder hiện là admin-lite tool, không phải public feature.

flow.iai.one & callback nội bộ

  • Nhà Chung gọi `flow.iai.one` để chạy automation; không mở webhook tool public trong V1.
  • Kết nối Flow API và callback nội bộ là tính năng nội bộ sau đăng nhập app.
  • Outbound triggers gồm `post_created`, `comment_added`, `vote_milestone`, `flow_run`, `user_registered`.
  • Inbound callbacks dùng connection key để xác thực và chỉ phục vụ app nội bộ.

FAQ

  • Tôi có cần tài khoản để đọc feed không? Không, nhưng cần tài khoản để tương tác.
  • Vì sao tôi không vào được `/app/`? Vì tài khoản của bạn chưa có quyền app nội bộ.
  • AI summary có luôn đúng không? Không. Đây là công cụ hỗ trợ đọc nhanh, không thay thế việc đọc và kiểm chứng bài gốc.

Troubleshooting

  • Nếu đăng nhập thành công nhưng không vào app nội bộ, kiểm tra lại role của tài khoản.
  • Nếu AI summary báo không khả dụng, khả năng cao AI API chưa được cấu hình hoặc đang tạm lỗi.
  • Nếu feed không tải được từ API, site sẽ fallback sang dữ liệu local `feed.json` để tránh trắng trang.
  • Nếu Flow trigger test thất bại, kiểm tra `flow_id`, `api_base_url`, `FLOW_API_KEY` và response log trong app.