/** * Brand app — nâng cấp thị giác cho các trang NỘI BỘ (bảng chấm điểm, form nộp * bài, Q&A, hướng dẫn sử dụng...) chạy qua `{% extends "templates/web.html" %}`. * Các trang này VỐN ĐÃ sáng (Bootstrap trắng mặc định) — vấn đề không phải tối, * mà là trông như Bootstrap mặc định, chưa ra thương hiệu. * * KHÁC hẳn brand-marketing.css (hệ "Poster" cho 9 trang công khai: viền đen 3px, * hard shadow đặc, tít in hoa 900): đây là GIAO DIỆN SẢN PHẨM — chỉ đồng bộ * bảng màu (biến từ brand-tokens.css) + font tiêu đề + bo góc nhỏ, TUYỆT ĐỐI * KHÔNG in hoa/viền dày/hard shadow — bảng dữ liệu & form cần dễ đọc lâu, không * "hét" vào mắt người dùng. * * An toàn nạp toàn site (file này nạp qua hooks.py web_include_css — mọi trang * website, kể cả 9 trang public + blog, đều tải file này): * - Desk (/app) KHÔNG bị ảnh hưởng: file này CHỈ khai trong web_include_css, * không khai trong app_include_css (khác brand-tokens.css — file đó chỉ có * custom properties nên an toàn nạp cả hai, xem hooks.py). * - 9 trang public (landing, lo_trinh, thu-vien, about, contact, cong-cu, * grill_result...) KHÔNG bị ảnh hưởng khi xem như GUEST/HV thật: đó là * trang TỰ CHỨA (có riêng) nên Frappe serve unwrapped, không đi qua * wrapper web.html chèn web_include_css (xác nhận bằng curl GUEST thật — * KHÔNG dùng cookie Administrator để test việc này: Administrator là * System User, gõ "/" sẽ bị route thẳng vào /dashboard theo * role_home_page/default_app nên trông giống có nạp file, đó là false * positive — xem docs/design-system-poster.md §8 mục 5). * - Blog/Web Page khác KHÔNG bị ảnh hưởng: MỌI rule dưới đây đều SCOPE bằng * `body[data-path=""] .page_content` — Frappe tự gắn `data-path` * đúng tên route lên cho mọi trang qua templates/web.html (xác nhận * bằng curl thật: ``, ``...) và `.page_content` chỉ bọc đúng khối * {% block page_content %} — KHÔNG bọc navbar/footer (2 khối đó là anh em * đứng ngoài `.page-content-wrapper`, xác nhận bằng curl thật) nên rule ở * đây không lỡ tay đổi màu link trên navbar/footer dùng chung. * - Danh sách 12 route trong phạm vi (đúng tên file templates/pages/*.html, * không thêm/bớt): dashboard, classroom_teacher, classroom_assignment, * classroom_lessons, classroom_student, classroom_students, * classroom_report, hoi_dap, huong_dan_admin, huong_dan_giang_vien, * huong_dan_hoc_vien, lesson. * * Kỹ thuật specificity — ĐỌC TRƯỚC KHI SỬA (đã bắt lỗi 2 lần bằng ảnh chụp * thật, không phải chỉ đọc code — xem 2 case dưới đây): * * 1) Khối scope `body[data-path="..."] .page_content` luôn bọc trong * `:where(...)` (specificity = 0). Nếu dùng `:is()` (giữ nguyên độ đặc * hiệu) thay vì `:where()`, một rule trần như ".card{...}" sẽ vô tình có * độ đặc hiệu CAO HƠN các class riêng của dashboard.html (`.s-card`/ * `.t-card`, single-class) và THẮNG NHẦM property trùng tên bất kể thứ tự * nạp, dù dashboard.html nạp