คู่มือการใช้งาน

คู่มือฉบับสมบูรณ์สำหรับใช้งาน HearhuiOS — แพลตฟอร์มธุรกิจดิจิทัลแบบ Self-hosted

เริ่มต้นอย่างรวดเร็ว

  1. Deploy — Clone repo แล้ว deploy ขึ้น Vercel ด้วยคำสั่ง vercel --prod
  2. ตั้งค่า Environment VariablesDATABASE_URL, NEXTAUTH_SECRET, ENCRYPTION_KEY
  3. สร้างฐานข้อมูล — รันคำสั่ง npm run db:push
  4. สร้างบัญชี Admin — สมัครสมาชิกที่ /signup แล้วตั้งค่า role เป็น admin ในฐานข้อมูล
  5. รัน Setup Wizard — ไปที่ /admin/setup แล้วทำตามขั้นตอน
  6. Seed ข้อมูล — กด “Seed Skills” และ “Seed Email Templates” ใน wizard
  7. ตั้งค่าบริการ — ตั้งค่า SMTP, Stripe, และ Claude API key ผ่าน admin panel

คู่มือผู้ใช้

สมัครสมาชิกและเข้าสู่ระบบ

สร้างบัญชีที่ /signup ด้วยอีเมลและรหัสผ่าน ระบบจะส่งอีเมลยืนยันตัวตน — คลิกลิงก์เพื่อเปิดใช้งานบัญชี หากลืมรหัสผ่าน สามารถรีเซ็ตได้ผ่านลิงก์ “ลืมรหัสผ่าน?” ในหน้าล็อกอิน

แดชบอร์ด

หลังเข้าสู่ระบบ จะเห็นแดชบอร์ดแสดงสถิติ: คอร์สที่ลงทะเบียน, การซื้อ, ไฟล์, ใบประกาศนียบัตร, เซสชัน AI Chat และอื่นๆ ใช้เมนูด้านข้างเพื่อไปยังส่วนต่างๆ

คอร์สเรียน

ดูคอร์สที่มีได้ที่ /products หลังซื้อแล้ว ไปที่ /dashboard/courses เพื่อเข้าเรียน แต่ละคอร์สมีโมดูลที่มีบทเรียน (วิดีโอ, ข้อความ, แบบทดสอบ, หรือการบ้าน) เรียนจบทุกบทเรียนจะได้รับใบประกาศนียบัตรอัตโนมัติ

ทักษะ AI

เข้าถึง 8 ทักษะ AI ที่ /dashboard/ai-skills ทักษะจะเป็นแบบ Guided Journey — ทำแต่ละขั้นตอนให้เสร็จเพื่อปลดล็อกขั้นถัดไป แต่ละทักษะมีระบบ Chat แบบ Streaming ที่ขับเคลื่อนด้วย Claude AI

ใบประกาศนียบัตร

หลังเรียนจบคอร์ส ใบประกาศนียบัตรจะปรากฏที่ /dashboard/certificates คลิกเพื่อดูรายละเอียดและดาวน์โหลดเป็น PDF

ระบบแนะนำเพื่อน

แชร์ลิงก์แนะนำเฉพาะของคุณจาก /dashboard/referrals เมื่อเพื่อนสมัครและซื้อสินค้า คุณจะได้รับค่าคอมมิชชั่น 10% อัตโนมัติ ติดตามสถิติการแนะนำได้ในหน้าเดียวกัน

คู่มือผู้ดูแลระบบ

ภาพรวม Admin Panel

เข้าถึง Admin Panel ที่ /admin แดชบอร์ดแสดงตัวเลขสำคัญ: จำนวนผู้ใช้, ผู้ใช้ที่ใช้งาน, สินค้า, การซื้อ, รายได้, และผู้ใช้ใหม่ (7 วัน)

จัดการผู้ใช้

ที่ /admin/users ค้นหาและจัดการผู้ใช้ทั้งหมด คลิกผู้ใช้เพื่อดูรายละเอียด เปลี่ยนบทบาท (user/instructor/admin) ระงับบัญชี และเพิ่มบันทึกของ admin

สินค้าและราคา

สร้างสินค้าดิจิทัลที่ /admin/products ตั้งชื่อ, คำอธิบาย, รูปภาพ, ราคา, และประเภท (จ่ายครั้งเดียว หรือ สมาชิกรายเดือน/ปี) สินค้าสามารถเชื่อมกับคอร์สหรือไฟล์ดิจิทัลได้

ระบบอีเมล

  • ตั้งค่า SMTP (/admin/email-config) — Host, Port, Username, Password, From Address
  • เทมเพลต (/admin/email-templates) — 5 เทมเพลตพร้อมใช้ รองรับตัวแปร {{variables}}
  • บันทึกการส่ง (/admin/email-logs) — ดูอีเมลที่ส่งสำเร็จ/ล้มเหลวทั้งหมด
  • ทดสอบ (/admin/test-email) — ส่งอีเมลทดสอบเพื่อตรวจสอบการตั้งค่า

จัดการบทความ

สร้างและจัดการบทความที่ /admin/blog เขียนเนื้อหา HTML, ตั้งค่า SEO metadata (ชื่อ, คำอธิบาย, slug, คีย์เวิร์ด) แล้วเผยแพร่ บทความจะปรากฏที่ /blog

เครื่องมือ SEO

  • คีย์เวิร์ด — ติดตามอันดับ keyword, search volume, และระดับความยาก
  • วางแผนเนื้อหา — วางแผนบทความพร้อมกระจายหลายช่องทาง
  • Site Monitor — ตรวจสอบ uptime และเวลาตอบสนองของเว็บ
  • วิเคราะห์เว็บ — วิเคราะห์ URL ใดก็ได้เพื่อหาปัญหา SEO

ติดตามและวิเคราะห์

ที่ /admin/tracking เพิ่ม tracking tags สำหรับ 11 แพลตฟอร์ม: GA4, GTM, Facebook Pixel, TikTok, LINE Tag, X/Twitter, LinkedIn, Snapchat, Pinterest และ custom scripts ดูรายงานที่ /admin/tracking/reports

การชำระเงิน Stripe

ตั้งค่า Stripe ที่ /admin/stripe ใส่ publishable key, secret key, และ webhook secret รองรับการจ่ายครั้งเดียวและสมาชิก นอกจากนี้ยังมี PromptPay QR สำหรับลูกค้าไทย

ตั้งค่า AI

ตั้งค่า Claude API ที่ /admin/ai-config ใส่ API key, เลือก model, และเปิด/ปิดฟีเจอร์ AI มี 8 ทักษะ AI พร้อมใช้หลัง seed ข้อมูล

จัดการคำสั่งซื้อ

ที่ /admin/purchases ดูคำสั่งซื้อทั้งหมด อนุมัติหรือปฏิเสธการชำระเงินผ่าน PromptPay เมื่ออนุมัติ ระบบจะส่งอีเมลยืนยัน ลงทะเบียนคอร์ส และสร้างลิงก์ดาวน์โหลดอัตโนมัติ

คู่มือผู้สอน

สร้างคอร์ส

  1. ไปที่ /dashboard/instructor/courses
  2. กด “สร้างคอร์สใหม่” — ใส่ชื่อ, คำอธิบาย, และเลือกสินค้าที่เชื่อมโยง
  3. เพิ่มโมดูล (หมวดหมู่) เพื่อจัดระเบียบเนื้อหา
  4. เพิ่มบทเรียนในแต่ละโมดูล — เลือกประเภท: วิดีโอ, ข้อความ, แบบทดสอบ, หรือการบ้าน
  5. กดไอคอนแก้ไขในแต่ละบทเรียนเพื่อเพิ่มเนื้อหา (URL วิดีโอ, ข้อความ, คำสั่ง)
  6. ตั้งสถานะคอร์สเป็น “เผยแพร่” เมื่อพร้อม

ตรวจการบ้าน

ดูงานที่นักเรียนส่งที่ /dashboard/instructor/submissions อนุมัติหรือปฏิเสธการบ้าน พร้อมเพิ่ม feedback ได้ รองรับทุกคอร์สที่คุณสอน

เทคโนโลยีที่ใช้

หมวดเทคโนโลยี
เฟรมเวิร์กNext.js 16 + React 19
ภาษาTypeScript
สไตล์Tailwind CSS v4 + shadcn/ui
ฐานข้อมูลPostgreSQL (Neon) + Drizzle ORM
ยืนยันตัวตนNextAuth v5 (credentials)
ชำระเงินStripe + PromptPay QR
AIClaude API (@anthropic-ai/sdk)
อีเมลNodemailer (SMTP)
เข้ารหัสAES-256-GCM
ทดสอบPlaywright (E2E)
โฮสติ้งVercel

ตัวแปรสภาพแวดล้อม

ตัวแปรจำเป็นคำอธิบาย
DATABASE_URLใช่PostgreSQL connection string
NEXTAUTH_SECRETใช่รหัสลับสำหรับเข้ารหัส session
NEXTAUTH_URLใช่URL ของแอป (เช่น https://hearhuios.vercel.app)
ENCRYPTION_KEYใช่รหัส hex 64 ตัวอักษรสำหรับ AES-256-GCM
CRON_SECRETแนะนำรหัสลับสำหรับ cron jobs (email sequences, cleanup)
SENTRY_DSNไม่บังคับSentry DSN สำหรับ error monitoring

Stripe, SMTP, และ Claude API key ตั้งค่าผ่าน Admin Panel และเก็บเข้ารหัสในฐานข้อมูล