Search guide

Search của Just the Docs dùng Lunr index sinh từ Markdown. Cách học nhanh nhất là gõ tên class, endpoint, migration, bảng database hoặc thuật ngữ nghiệp vụ.

Truy vấn nên thử

| Query | Dùng khi | | — | — |

Bản đồ trả lời nhanh Mở dashboard bảo vệ: câu trả lời 60 giây, 12 luồng nghiệp vụ, file/bảng cần nhắc và câu nên nói cho đúng.
Kiểm toán độ sẵn sàng Mở audit cuối để chứng minh font, flow, thông tin, UX/UI, DB count, search, link và câu chữ đều có evidence.
Sơ đồ thư mục Mở ảnh cây thư mục backend/frontend/docs và luồng mở file khi cần sửa code.
directory map Tìm trang sơ đồ thư mục và file flow bằng tiếng Anh.
luồng file Tìm sơ đồ mở file theo việc cần sửa: UI, logic, API, database, upload, video, Wiii.
readiness audit Tìm trang kiểm toán độ sẵn sàng trước khi gửi thầy hoặc báo cáo.
claim hygiene Tìm bảng câu không nên nói/câu nên nói để tránh claim quá đà.
font evidence Tìm bằng chứng phân biệt lỗi font thật với lỗi hiển thị terminal PowerShell.
12 luồng nghiệp vụ Tìm bảng actor -> UI -> backend/API -> database -> invariant cần thuộc trước khi báo cáo.
sơ đồ luồng nghiệp vụ Mở trang Luồng nghiệp vụ để xem flowchart tổng quan và sequence diagram cho auth, course, publication, learning, assessment, upload, video, payment và Wiii.
flow map trước khi tra file Mở Full File CodeMap và xem bản đồ request Angular -> API -> controller -> use case -> repository -> PostgreSQL trước khi tra file.
LMS Full File CodeMap Tra report HTML có flow map, cây thư mục, backend module, frontend feature và search toàn bộ file đã lập chỉ mục.
UX/UI và design system Tìm cách giải thích thiết kế LMS, design token, sửa màu/layout và smoke UI.
UX/UI design Tìm trang trả lời câu hỏi giao diện thiết kế có hợp lý không.
design token Tìm token màu chính
#0056D2 Tìm màu primary của LMS và nơi cần giữ nhất quán khi sửa UI.
đổi màu Tìm checklist mở component/template/SCSS và smoke khi đổi màu nút hoặc layout.
course editor UX Tìm bản đồ layout course editor, sidebar, curriculum, sticky save và section editor.
WiiiContextService Tìm luồng postMessage, Pointy, preview/apply token, safe click.
system diagram Tìm sơ đồ runtime tổng quan của LMS.
publication sequence Tìm sơ đồ submit-for-approval, approve và learner snapshot.
payment sequence Tìm sơ đồ VNPay/SePay callback, webhook và enrollment activation.
SQL schema catalog Tìm đủ 78 application tables, cột, index và migration nguồn.
migration inventory Tìm danh sách đầy đủ 107 file Flyway migration SQL.
107 migration SQL Trả lời vì sao version cuối là V135 nhưng repo có 107 file SQL.
Vị trí file code Tìm trang chỉ dẫn mở file khi sửa UI, logic, API, database.
code locations Tìm nhanh file frontend/backend/database theo việc cần sửa.
đổi màu Tìm checklist sửa CSS/SCSS và design token.
đổi logic Tìm checklist sửa controller, use case, repository, migration.
business flows Tìm các luồng nghiệp vụ end-to-end.
Ma trận bao phủ Kiểm tra docs đã bao phủ công nghệ, luồng, DB, Wiii, video, payment, sửa code chưa.
Bộ câu hỏi luyện Luyện vấn đáp theo nhóm kiến trúc, flow, DB, Wiii, payment, scale.
Kịch bản demo Trình bày LMS trong 10-15 phút, có thứ tự mở trang và cách xử lý lỗi demo.
Deploy docs lên Cloudflare Tìm runbook Cloudflare Pages/Workers để đưa docs-site lên docs.holilihu.online.
docs.holilihu.online Tìm checklist gắn custom domain cho docs site.
wrangler pages deploy Tìm lệnh deploy _site lên Cloudflare Pages.
Cloudflare Pages Tìm cấu hình Pages Direct Upload miễn phí cho docs Jekyll.
SEO docs Tìm cấu hình meta, Open Graph, Twitter card, robots và sitemap của docs.holilihu.online.
sitemap.xml Kiểm tra sitemap public của docs và cách Google có thể crawl các trang học/report.
robots.txt Kiểm tra docs đang cho phép index và trỏ tới sitemap.
Checklist chất lượng docs Kiểm font, tiếng Việt, UX/UI, search, link, evidence trước khi gửi thầy.
Thuật ngữ tra nhanh Tìm glossary giải thích DDD, publication, ABR, Pointy, payment, content_blocks.
Câu hỏi bảo vệ Tìm câu trả lời ngắn cho vấn đáp tốt nghiệp.
content_blocks Giải thích đây là cột JSONB trong lessons/questions, không phải bảng riêng.
ABR Tìm adaptive bitrate trong Shaka/HLS/DASH.
ARB Alias gõ nhầm thường gặp của ABR; dùng khi cần tìm adaptive bitrate trong Shaka/HLS/DASH.
78 application tables Trả lời câu hỏi database hiện có bao nhiêu bảng nghiệp vụ.
student_lesson_progress Tìm bảng tiến độ bài học đúng tên.
payment_transactions Tìm bảng giao dịch thanh toán chính.
course_tags_legacy Tìm bảng legacy được rename trong V70.
data-wiii-click-safe Tìm ranh giới click an toàn cho Wiii Pointy.
CourseAuthoringControllerV3 Tìm API tạo chương, bài học, section, upload file và preview PDF.
CourseEditorStore Tìm state chính của trình soạn khóa học Angular.
VideoAssetIngestService Tìm pipeline ingest video nội bộ.
ShakaPackagerService Tìm cách package HLS/DASH và output manifest.
AdaptiveVideoPlayerComponent Tìm player học viên, Shaka config và ABR.
OfflineSyncService Tìm queue đồng bộ offline progress.
lms-offline.db.ts Tìm schema IndexedDB/Dexie.
PaymentControllerV3 Tìm API thanh toán và callback.
V74__upload_sessions.sql Tìm schema upload session/presigned upload.
V135__video_storage_governance.sql Tìm governance video storage.
application-prod.yml Tìm cấu hình production cần kiểm tra khi deploy.
docker-compose.video-worker.yml Tìm runtime worker ingest video riêng.
DB sống Mở trang đối chiếu DB đang chạy, ERD DBeaver, row estimate và migration mới nhất.
DBeaver ERD Mở ảnh ERD tổng schema public và hướng dẫn trình bày database cho thầy.
row estimate Tìm bảng row estimate từ PostgreSQL và phân biệt với COUNT(*) tuyệt đối.
flyway_schema_history Giải thích đây là bảng kỹ thuật của Flyway, không tính vào bảng nghiệp vụ LMS.

Mẹo tìm nhanh

  • Gõ class/service chính: CourseAuthoringControllerV3, WiiiContextService, VideoAssetIngestService.
  • Gõ kiểm toán/evidence: Kiểm toán độ sẵn sàng, readiness audit, claim hygiene, font evidence.
  • Gõ endpoint: submit-for-approval, vnpay-ipn, sepay/webhook, competency-map.
  • Gõ migration: V92, V119, V130, V135, 107 migration SQL, migration inventory.
  • Gõ bảng: payment_transactions, student_lesson_progress, course_tags_legacy, content_blocks, 78 application tables.
  • Gõ tình huống sửa code: Vị trí file code, code locations, đổi màu, đổi logic, business flows.
  • Gõ UX/UI: UX/UI, design token, #0056D2, course editor UX, ConfirmDialog, Toast.
  • Gõ domain: publication, ORG_ADMIN, offline, interactive video, payment, rubric.
  • Dùng Ctrl+K để focus search bar.
  • Có thể gõ không dấu trong fallback search, ví dụ ban do tra loi nhanh, 12 luong nghiep vu, khong nen noi.

Các report HTML lớn vẫn mở được qua trang Report, nhưng search chính của Just the Docs hiệu quả hơn khi có các bridge page Markdown như trang này.

Search fallback của docs site

Docs site vẫn dùng search mặc định của Just the Docs/Lunr. Ngoài ra, docs-site/_includes/head_custom.html có một fallback nhỏ đọc /assets/js/search-data.json và render kết quả bằng DOM API. Lý do là khi demo trên màn hình hẹp hoặc khi paste text, event của theme có thể không chạy giống gõ phím thông thường. Fallback này giúp các query quan trọng như font, 8088, Wiii, 78 application tables, 107 migration SQL, Kịch bản demo vẫn tìm được.