← Về thư mục
KẾ HOẠCH THỰC THI GIAI ĐOẠN 2: CHUYỂN ĐỔI SSR VÀ API THỜI GIAN THỰC
Tài liệu này ghi nhận chi tiết các bước triển khai nâng cấp hệ thống SEO Dashboard từ nguyên mẫu tĩnh (SSG) sang ứng dụng máy chủ động (SSR) phục vụ dữ liệu thời gian thực.
1. MỤC TIÊU TỔNG QUAN
- Chuyển đổi kiến trúc Astro sang Node standalone server (SSR)
- Xây dựng API endpoints nội bộ xử lý dữ liệu động
- Tích hợp nút ép làm mới dữ liệu (Force Refresh) trên giao diện
- Tự động hóa việc map Target Page và cập nhật timestamp thời gian thực
2. LỘ TRÌNH THỰC THI CỤ THỂ (STEP BY STEP)
BƯỚC 1: Cấu hình môi trường SSR và Adapter Node.js
- Mục tiêu: Đưa dự án sang chế độ Server (output: 'server') với Node adapter.
- Trạng thái: ĐÃ HOÀN THÀNH.
- Tệp tin tác động:
package.json, astro.config.mjs.
BƯỚC 2: Xây dựng các API Endpoints nội bộ (RESTful Server Endpoints)
- Mục tiêu: Tạo các đường dẫn API nội bộ để giao diện fetch dữ liệu tươi hoặc kích hoạt ETL.
- Tệp tin khởi tạo:
src/pages/api/ai-queries.ts (trả dữ liệu JSON từ file store)src/pages/api/refresh.ts (kích hoạt Python ETL script trực tiếp từ giao diện)- Trạng thái: ĐANG THỰC THI.
- Mục tiêu: Cho phép người dùng bấm nút làm mới trên UI để tải lại dữ liệu mới nhất từ GSC API.
- Tệp tin tác động:
src/components/Header.astro, src/scripts/main.js.
- Trạng thái: CHỜ THỰC THI.
BƯỚC 4: Tự động hóa ánh xạ URL Target Page cho Bảng 04
- Mục tiêu: Khai báo bảng ánh xạ từ khóa với URL thực tế trên greenleafvietnam.com.
- Trạng thái: BỎ QUA (Chỉ số Target Page thủ công không khả thi do lệch pha dữ liệu).
BƯỚC 5: Kiểm thử toàn diện và đóng gói Server Production
- Mục tiêu: Chạy thử nghiệm server trên cổng Node.js (ví dụ 9126) và cấu hình Nginx reverse proxy.
- Trạng thái: HOÀN THÀNH. Tích hợp Tailscale Funnel để Public Ingress.