# Source code T5Edu

Source code T5Edu là một nền tảng EdTech production-ready gồm sản phẩm, AI workflow, SQL/API Playground, tài chính, vận hành và tài liệu chuyển giao kiến trúc.

- Canonical: https://t5edu.site/source-code
- Markdown: https://t5edu.site/source-code.md
- Cập nhật: 2026-09-11
- Loại nội dung: source-code-landing
- Giá source code: 40.000.000đ / 1500 USD
- Custom dev: 500.000đ/giờ / 25 USD/giờ
- Liên hệ: https://duonguyen.site/contact

## Không chỉ là starter kit hoặc bộ giao diện

Gói source code cung cấp toàn bộ hệ thống T5Edu đang vận hành thật. Các luồng học tập, AI, thanh toán, entitlement, vận hành và public discovery đã được kết nối thành một sản phẩm thống nhất.

## Bốn trụ cột sản phẩm

- Learning system: LMS theo cấu trúc Course - Chapter - Lesson, tiến độ, bài tập, quiz, testcase, mua nội dung và hệ sinh thái Markdown rendering (multiple-choice, table-testcase, dropdown-content, grid-content, sql-editor chạy PostgreSQL Lab có baseline liên kết, database-schema DBML ERD, code-runner qua Piston private, broadcast-action, tự động nhúng YouTube/Google Docs/TikTok, DocumentPreviewer PDF/DOCX/XLSX, sơ đồ Mermaid SVG, Shiki syntax, KaTeX toán học và dynamic config {{configs.KEY}}).
- AI system: Multi-Agent Tutor, AI Grading, Course Generator, Mock Interview, RAG, LangGraph và human-in-the-loop.
- Work system: T5Lab quản trị kiểm thử và T5Docs quản trị tài liệu cộng tác.
- Business system: Wallet, Sepay, Order, PRO/EDU, referral và admin operations.

## Custom Markdown cho bài học tương tác

- `multiple-choice correct="…" select="single|multiple"` tự chấm câu hỏi; `table-testcase` là ma trận testcase có thể chỉnh sửa cho thực hành QA.
- `dropdown-content` thu gọn giải thích/FAQ và `grid-content` trình bày các khái niệm song song dạng card; cả hai đều nhận Markdown lồng đúng format.
- `code-runner lang="sql"` và `sql-editor` chạy trên PostgreSQL SQL Lab cô lập. Baseline có dữ liệu profile, course, order, wallet và blog được liên kết để truy vấn có ngữ cảnh.
- `code-runner lang="python|js|ts|java"` chạy qua Piston private dùng chung, giữ runtime sẵn sàng thay vì khởi tạo container cho từng lần chạy; `database-schema` chuyển DBML thành ERD tương tác.
- `broadcast-action` chỉ dùng action ID được cung cấp từ hệ thống để đưa người dùng vào luồng broadcast hợp lệ.
- Lab cho phép SELECT, INSERT, UPDATE và DELETE; dữ liệu được khôi phục về baseline quen thuộc mỗi ngày. `DROP DATABASE` và `TRUNCATE TABLE` không được hỗ trợ.
- Cú pháp và attribute chính xác của các custom element được tập trung tại `system-prompt`, để AI workflow và renderer dùng chung một contract.

## SQL Playground và API Swagger Playground

- [SQL Playground](https://t5edu.site/playground/sql): database manager công khai với schema tự đồng bộ, nhiều query tab, autocomplete và bảng kết quả lớn. SQL được gửi qua Server Action tới PostgreSQL Lab cô lập, dùng baseline dữ liệu liên kết và rate limit riêng.
- SQL Lab cho phép DML thông thường; guard phân tích toàn batch và chặn DROP database, table, schema cùng TRUNCATE trước khi thực thi.
- [API Swagger Playground](https://t5edu.site/playground/api): OpenAPI công khai được sinh từ resource registry và SQL Lab schema, bao phủ CRUD, quan hệ lồng nhau cùng action nghiệp vụ kiểu super admin.
- Mỗi người dùng có thể tạo nhiều API key có tên; secret chỉ hiển thị một lần và main database chỉ lưu hash. Bearer key dùng được trong Swagger hoặc từ Postman, Apidog và code bên ngoài.
- REST API cùng ánh xạ tới baseline của SQL Playground nhưng dùng rate limit độc lập, parameterized query, lỗi RFC 9457 và idempotency riêng cho mutation.

## Toàn bộ module

- LMS Đầy Đủ & Interactive Elements: Course → Chapter → Lesson đa dạng (lý thuyết, bài tập, trắc nghiệm, testcase). Resume learning, mua bài lẻ, tiến độ cá nhân.
- AI Tutor Multi-Agent ReAct: 4 agent chuyên biệt (Tutor, Practice, Diagnostic, Career) với Supervisor tự phân loại intent và vòng Reflection tự đánh giá chất lượng.
- AI Grading: Chấm bài học viên theo tiêu chí nghiệp vụ, hiểu PDF/DOCX/ảnh lỗi/Google Sheets. Ghi nhớ phản hồi kỳ trước để kiểm tra cải tiến.
- AI Course Generator: Đọc tài liệu, sinh dàn ý, tạo bài học hoàn chỉnh với hình minh họa qua LangGraph human-in-the-loop. RAG theo tầng + Web Search fallback.
- AI Mock Interview: AI đóng vai Lead QA, hỏi đáp theo năng lực học viên và tạo báo cáo phỏng vấn JD-friendly.
- ISTQB Importer: Import đề thi ISTQB từ PDF, dịch Anh-Việt, deduplication, quiz có countdown timer và báo cáo theo chương.
- T5Lab Test Management: Hệ thống quản lý testcase mô phỏng Jira: Project → Page → Feature → Testcase. AI sinh Pages/Features/Testcases từ tài liệu, Kanban, RBAC.
- T5Docs Workspace: Workspace tài liệu cộng tác cho QA/BA: Markdown editor, AI Ask Mode, AI Edit Mode có diff review, export sang T5Lab.
- Piston Code Runner đa ngôn ngữ: Trình thực thi mã nguồn qua Piston private, giữ runtime ấm để chạy nhanh và dễ mở rộng ngôn ngữ. SQL dùng PostgreSQL Lab riêng với dữ liệu bài học được liên kết và khôi phục hằng ngày.
- SQL Lab & Database ERD Canvas: Trình soạn thảo SQL có tab mẫu, chạy SELECT/INSERT/UPDATE/DELETE trên PostgreSQL Lab dùng chung và sơ đồ ERD tự động parse DBML sang ReactFlow graph.
- SQL Playground & Database Manager: Database manager công khai với schema tự đồng bộ, nhiều query tab, autocomplete và bảng kết quả lớn. SQL chạy qua Server Action vào PostgreSQL Lab cô lập, dùng baseline liên kết và rate limit riêng.
- API Swagger Playground: OpenAPI công khai sinh từ SQL Lab schema và resource registry; hỗ trợ CRUD, quan hệ, action nghiệp vụ super admin, Bearer API key, Swagger, Postman, Apidog, RFC 9457 và mutation idempotency.
- Testcase Matrix & Trắc nghiệm tương tác: Thẻ <table-testcase> dạng ma trận kiểm thử cho thực hành QA/Tester và thẻ trắc nghiệm <multiple-choice> tự động chấm kết quả đúng/sai tức thì.
- Accordion & Responsive Grid Layouts: Bộ thẻ bố cục nâng cao: <dropdown-content> thu gọn/mở rộng nội dung đệ quy (FAQ, tips) và <grid-content> chia cột card grid responsive (1-4 cột).
- Document Previewer & Multi-media Embed: Bộ xem tài liệu PDF, DOCX, XLSX trực tiếp qua Google Docs / Office Viewer; tự động nhúng video YouTube, TikTok, audio và lightbox phóng to ảnh modal.
- Mermaid SVG Diagrams & KaTeX Math: Vẽ sơ đồ Mermaid (Flowchart, Sequence, State) trực tiếp qua codeblock ```mermaid và hiển thị công thức toán/tài chính KaTeX chuẩn LaTeX (inline & block).
- CodeMirror 6 WYSIWYG & Dynamic Templating: Trình soạn thảo Markdown chuyên nghiệp với MDEditor + CodeMirror 6, toolbar picker chèn nhanh thẻ tương tác, R2 upload drag-and-drop và template động {{configs.KEY}}.
- Interactive Broadcast Action Buttons: Thẻ <broadcast-action> nhúng nút bấm tương tác kích hoạt luồng bản tin Admin: mở popup nạp ví, điều hướng mua khóa học hoặc chuyển trang ứng dụng.
- Wallet Economy: Ví điện tử nội bộ tích hợp Sepay QR, referral cashback, PRO/EDU ưu đãi, Spend Triggers, SpendXP milestones và Expiry Wallet.
- Portfolio Bento 2.0: Hồ sơ năng lực công khai: kỹ năng, dự án, kinh nghiệm, CV và chứng nhận khóa học có URL xác thực. Auto-fill từ AI, slug tùy chỉnh, heatmap tiến độ học.
- Blog + SEO + Auto-Post: Pipeline tự động: AI viết blog → tạo OG image → đăng Facebook Page. Full-text search, GIN index, TOC và reading progress.
- Admin Analytics Chat: Trợ lý dữ liệu quản trị: câu hỏi tiếng Việt → SQL read-only → Generative UI Bento (metric/bar/pie/ranking/table). Propose-then-confirm cho mutation.
- Referral System: Cashback người giới thiệu khi bạn được mời nạp tiền lần đầu và mỗi lần nạp tiếp theo. Configurable qua SystemConfig.
- Broadcast Popup: Hệ thống bản tin admin: gửi thông báo với actions tùy chỉnh (mua khóa, nạp ví, v.v.), tracking mở/đóng, auto-show theo cấu hình.
- Sepay Double-Check: Thanh toán QR qua Sepay với xác minh chéo Sepay User API, PaymentLog chống replay attack, anti-spam order protection.
- Submission Center: Trung tâm nộp bài, trạng thái duyệt, lịch sử retry, AI feedback, câu hỏi gợi mở và theo dõi cải thiện qua từng lần làm.
- Chứng nhận khóa học có thể xác thực: Cho học viên nhìn thấy hành trình cần hoàn thành, nhận chứng nhận ngay trong khóa học và chia sẻ thành tích qua đường dẫn công khai, email hoặc bản PDF đồng bộ nhận diện FREE/PRO. Kết quả thực hành tiếp tục phản ánh những lần học viên cải thiện bài sau khi được cấp.
- Course & Lesson Commerce: Bán khóa học hoặc mở khóa bài lẻ, resume learning, enrollment, pricing động, order thống nhất và thanh toán bằng ví/Sepay.
- RAG & Local Embedding Infrastructure: pgvector retrieval, document chunking, noise filter, web-search fallback và worker Transformers.js để vẫn tìm ngữ cảnh khi AI kill switch tắt.
- AI Model Operations: Provider/model config qua admin, fallback stack, rate limit Redis, kill switch, token/cost controls và Sentry tags theo workflow stage.
- T5Lab Collaboration & RBAC: Vai trò PO/PM/Tester/Developer/Guest, email invite, assignee, Kanban kéo thả, nested pages và persistence thứ tự testcase.
- T5Lab Analytics & Export: Phân tích coverage, risk, ROI, defect leakage, chất lượng testcase; export Excel và tải lại tài liệu dự án đã ingest.
- T5Docs Realtime Collaboration: Owner/Editor/Viewer, mention file/thư mục, Architecture Map, diff review Accept/Reject, Redis update indicator và export sang T5Lab.
- Professional Portfolio & CV: Public profile với kỹ năng, dự án, kinh nghiệm, learning heatmap, AI Summary, custom slug, chứng nhận xác thực và xuất CV PDF.
- Order, Wallet & Payment Ledger: Order/OrderItem cho mọi giao dịch trả phí, ví bonus/real FIFO, PaymentLog, Sepay QR, replay protection và finance reporting.
- EDU Benefits & Referral: Xác minh email giáo dục, welcome bonus, giảm giá course/lesson/PRO, attribution referral qua cookie bridge và cashback có audit.
- Contact, Presence & Roadmap: Chat hỗ trợ 1-1 qua SSE/Redis, online presence, email fallback, capture môi trường lỗi, Roadmap Kanban và feature reward.
- Admin Operations & Automation: Quản trị content/user/order/wallet/finance/config, retention lifecycle, auto-blog/social distribution và cron jobs độc lập.
- Security & Observability: CSP, Trusted Types, sanitize, payment double-check, SSE hardening, PM2 isolation, Sentry workflow tags và network retry.
- CI/CD Production qua GitHub Actions: Push hoặc merge vào main tự pull private repository qua SSH, chuẩn hóa Bun và Node.js, chạy dependency/Prisma/Code Runner theo file thay đổi, build, restart đúng process PM2 và gửi Telegram kèm commit, trạng thái cùng stage lỗi.
- AI-Readable, MCP & WebMCP: HTML/Markdown dual representation, llms discovery, public read-only MCP, server cards, agent-skill index và WebMCP manifest.

## Tech stack

- Framework: Next.js 16, React 19
- Styling: Tailwind CSS v4, Konsta UI v5 (iOS theme)
- Database: PostgreSQL 16, Prisma v7, pgvector
- Auth: NextAuth v5, Google OAuth
- State: Zustand
- Infra: Redis (ioredis), Cloudflare R2, VPS + Caddy, PM2
- AI / LLM: LangChain, LangGraph, Google Gemini, OpenAI, Brave Search, Tavily Search, Transformers.js (local embedding)
- Tools: Bun, GitHub Actions, exceljs, Nodemailer
- Tracking: Microsoft Clarity, GA4

## CI/CD production theo thay đổi

- Mỗi push hoặc merge vào `main` kích hoạt GitHub Actions, đối chiếu toàn bộ commit range và pull private repository trên VPS bằng fast-forward-only.
- Phiên SSH không tương tác tự tìm Bun và chọn Node.js cao nhất từ phiên bản 20.9.0 trở lên trong PATH hoặc các vị trí NVM, Volta, mise, asdf và fnm phổ biến.
- `package.json` thay đổi mới chạy `bun install`; Prisma app schema mới chạy `db push` rồi `generate`; schema SQL Lab mới chạy entrypoint triển khai Code Runner duy nhất.
- Build production luôn chạy trước khi restart. Workflow chỉ restart web app `t5edu`, trừ khi entrypoint cron hoặc embedding worker thay đổi thì reload toàn bộ PM2 ecosystem.
- Git credential chỉ tồn tại trong `GIT_ASKPASS` tạm thời. Telegram nhận số commit, từng commit title, trạng thái, stage lỗi, exit code và liên kết GitHub Actions sau mỗi lần deploy.

## Phạm vi bàn giao

- Toàn bộ source code: Full source code + quyền truy cập GitHub private repo. Không giới hạn chỉnh sửa và tái phân phối nội bộ.
- Hỗ trợ triển khai: Kèm GitHub Actions CI/CD tự động theo thay đổi, hướng dẫn setup VPS, cấu hình Caddy reverse proxy, PM2 cluster, cron jobs và biến môi trường production.
- Support 1-1: Giải thích kiến trúc phân lớp, AI workflows (LangGraph), admin operations và cách mở rộng tính năng mới.
- Tài liệu đầy đủ: README.md (business knowledge map), AGENTS.md (technical reference) và toàn bộ thư mục plans/ với 78+ plan kỹ thuật chi tiết.
- Gợi ý VPS Việt Nam: Tư vấn nhà cung cấp VPS phù hợp cho thị trường Việt Nam: latency thấp, giá tốt, hỗ trợ tiếng Việt.
- Demo sản phẩm trực tiếp: Trải nghiệm toàn bộ tính năng trên bản demo live trước khi quyết định.

## Đầu ra của quá trình chuyển giao

- Đội ngũ nhận toàn bộ source code và quyền chỉnh sửa nội bộ.
- Nắm được kiến trúc Client Component - Server Action - Service - Prisma và các ranh giới AI/payment/entitlement.
- Có thể triển khai trên VPS với Caddy, PM2, Redis, PostgreSQL và object storage.
- Có tài liệu business, operating guide, architecture docs và các plan kỹ thuật để tiếp tục phát triển.

## Phù hợp khi

- Bạn cần ra mắt hoặc nâng cấp một nền tảng đào tạo có AI mà không muốn xây lại toàn bộ lớp nền.
- Bạn có đội ngũ kỹ thuật hoặc kế hoạch thuê custom development để tiếp tục sở hữu roadmap.
- Bạn cần xem hệ thống demo và trao đổi phạm vi trước khi quyết định; landing không có checkout tự động.

## Public stats

- 2.000+ người dùng.
- 1M tổng nạp vào ví.
- 700K tổng đã sử dụng dịch vụ AI.
- 2.000+ bài nộp.
- 60+ đơn hàng hoàn tất.
- 6 khóa học đã xuất bản.
- 10+ dự án T5Lab.

## Liên kết liên quan

- [Xem bản HTML](https://t5edu.site/source-code)
- [Xem bản Markdown](https://t5edu.site/source-code.md)
- [LLM index](https://t5edu.site/llms.txt)

Dữ liệu Markdown này được cache công khai và sẽ được làm mới sau các thay đổi nội dung/admin.
