Skip to content

Rendering và SEO ​

Các trang công khai của DevLink được dựng metadata trên server để công cụ tìm kiếm và mạng xã hội đọc được tiêu đề, mô tả và liên kết đa ngôn ngữ. Trang này giải thích cách metadata, sitemap và robots được tạo, và vì sao việc làm lấy từ nguồn bên ngoài bị loại khỏi chỉ mục tìm kiếm.

Metadata từng trang ​

Mỗi page.tsx công khai export generateMetadata. Hầu hết gọi hàm buildLocalizedPageMetadata trong src/shared/constants/seo.ts, hàm này tạo ra:

  • title, description, keywords
  • alternates.canonical và alternates.languages (gồm cả x-default trỏ tới tiếng Anh)
  • Open Graph và Twitter Card; nếu không có ảnh riêng thì dùng /images/logo.png

Tiêu đề và mô tả đến từ bản dịch (getTranslations) hoặc từ dữ liệu của chính trang đó, ví dụ tên việc làm. Hàm toMetadataDescription xóa thẻ HTML, giải mã một số ký tự đặc biệt và cắt mô tả còn tối đa 160 ký tự.

Layout theo ngôn ngữ đặt metadata mặc định cho cả site, với robots: { index: true, follow: true }.

Trang được render lúc nào ​

Mọi trang dưới src/app/[locale]/ được render theo từng request; không trang nào được dựng sẵn thành HTML lúc build. Sau khi build, .next/prerender-manifest.json chỉ có sitemap.xml, robots.txt và favicon.ico. Ký hiệu ● mà next build in cạnh các route [locale] vì vậy không có nghĩa là HTML của trang được cache.

Thứ được cache là dữ liệu: các hàm fetchPublic* giữ phản hồi của backend trong 60 giây hoặc 1 giờ tùy loại, xem Chiến lược cache.

Trang chủ lấy sẵn dữ liệu trên server. (main)/page.tsx gọi song song fetchPublicJobs (trang 1 của việc làm nổi bật) và fetchPublicTopHiringCompanies, rồi truyền kết quả cho home-page-client.tsx qua hai prop initialJobs và initialCompanies. Nhờ vậy HTML trả về đã có danh sách việc làm và công ty, công cụ tìm kiếm đọc được mà không cần chạy JavaScript. Khi backend không trả lời, hai prop này là null và trình duyệt tự gọi API.

Content Security Policy ​

src/middleware.ts sinh một nonce mới cho mỗi request và gửi header Content-Security-Policy, dựng bằng buildCsp trong src/lib/security/headers.ts. script-src chỉ cho phép script mang đúng nonce đó, cộng với các script mà chúng tải tiếp ('strict-dynamic'); không có 'unsafe-inline'. Next.js đọc nonce từ header CSP của request và tự gắn vào script của nó. Root layout đọc header x-nonce và truyền cho ThemeProvider (script chống nháy theme) và GoogleOAuthProvider.

Hệ quả: HTML của mỗi trang chứa nonce của riêng request đó, nên trang dưới src/app/[locale]/ phải render theo từng request. Không chuyển các trang này sang ISR hay HTML tĩnh khi còn dùng nonce. Cache dữ liệu ở mức fetch không bị ảnh hưởng.

Vài chỉ thị có lý do riêng:

  • 'wasm-unsafe-eval': @react-pdf/renderer biên dịch engine dàn trang từ WebAssembly.
  • frame-src blob:: khung xem trước CV hiển thị PDF từ địa chỉ blob:.
  • style-src 'unsafe-inline': Radix UI và các thuộc tính style viết thẳng trong component.
  • 'unsafe-eval' chỉ có khi chạy next dev.
  • zod được cấu hình jitless trong src/shared/config/env.ts, vì nếu không nó gọi thử Function("") và tạo vi phạm trên mọi trang.

Muốn tạm quay về chế độ chỉ báo cáo, đổi CSP_HEADER trong src/middleware.ts thành Content-Security-Policy-Report-Only. Các header bảo mật còn lại (HSTS, X-Frame-Options, ...) vẫn do next.config.ts gửi qua buildSecurityHeaders.

Địa chỉ gốc của site ​

Hàm getSiteUrl đọc biến NEXT_PUBLIC_SITE_URL. Khi biến này trống, nó dùng http://localhost:3000. Vì vậy môi trường triển khai cần đặt biến này, nếu không canonical, sitemap và Open Graph sẽ trỏ về localhost. Xem Biến môi trường.

Sitemap ​

src/app/sitemap.ts gồm ba nhóm địa chỉ, đều ở dạng ngôn ngữ mặc định kèm danh sách alternates.languages:

NhómNguồn
Trang tĩnh: /, /jobs, /companiesDanh sách PUBLIC_SITEMAP_PATHS
Việc làm nội bộTối đa 1000 việc làm đầu tiên lấy từ backend
Công tyTối đa 500 công ty đầu tiên lấy từ backend

Sitemap không chứa việc làm bên ngoài. Khi backend không trả lời, hàm lấy dữ liệu trả về null và hai nhóm việc làm, công ty bị bỏ qua mà không báo lỗi: sitemap chạy thử không có backend chỉ còn ba địa chỉ trang tĩnh. Vì vậy cần kiểm tra sitemap thật sau khi triển khai, đừng chỉ dựa vào việc nó trả mã 200.

Robots ​

src/app/robots.ts cho phép mọi trang trừ các tiền tố riêng tư, mỗi tiền tố được thêm cho cả hai ngôn ngữ: /admin, /profile, /login, /register, /forgot-password, /reset-password, /verify-email, /account. Robots cũng khai báo địa chỉ sitemap.

Lưu ý: danh sách này không chứa /hr, nên trang /hr/dashboard không bị chặn qua robots. Đây là mô tả hiện trạng, không phải đánh giá bảo mật; trang vẫn yêu cầu đăng nhập vai trò HR ở frontend.

Vì sao việc làm bên ngoài là noindex ​

Trang /jobs/external/[id] hiển thị tin tuyển dụng tổng hợp từ nguồn khác. Code đặt cho nó robots: { index: false, follow: false } kèm chú thích: nội dung bên thứ ba không được đưa vào chỉ mục tìm kiếm. Hệ quả:

  • Công cụ tìm kiếm không lập chỉ mục trang này và không theo các liên kết trên đó.
  • Trang vẫn truy cập được bình thường từ danh sách /jobs.
  • Sitemap cũng không liệt kê nó, nhất quán với quyết định trên.

Code chỉ ghi chú ngắn về ý định; không có tài liệu thiết kế nào khác được xác nhận cho quyết định này.

Dữ liệu có cấu trúc ​

Hàm serializeJsonLd trong seo.ts biến dữ liệu thành chuỗi JSON-LD và thay ký tự < bằng < để không đóng sớm thẻ <script> khi nhúng vào HTML.

Source code liên quan ​

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code