feat: integrate Swiper.js, update media persistence, and enhance page metadata support

README.md

@@ -126,4 +126,37 @@ Tôi đã chạy lệnh ./gradlew spotlessApply để tự động dọn dẹp v
 
 (Lưu ý: Có một lỗi riêng trong lệnh chạy test ./gradlew test liên quan đến cấu hình taskExecutor bị thiếu của dự án gốc đối với môi trường test, nhưng nó hoàn toàn không ảnh hưởng đến việc chạy ứng dụng thực tế bằng ./gradlew bootRun).
 
-Bạn có thể refresh lại trang web để kiểm tra màu sắc trên menu header nhé, nó đã được sửa lại thành màu đen rồi!
+Bạn có thể refresh lại trang web để kiểm tra màu sắc trên menu header nhé, nó đã được sửa lại thành màu đen rồi!
+
+## How to Debug (VS Code)
+
+1. **Start the Application in Debug Mode**:
+   Open a terminal in the project directory (`sisvietnamvn_main`) and run:
+   ```bash
+   ./gradlew bootRun --debug-jvm
+   ```
+   The application will start and pause, displaying: `Listening for transport dt_socket at address: 5005`.
+
+2. **Configure VS Code**:
+   Ensure your `.vscode/launch.json` has the following configuration:
+   ```json
+   {
+     "type": "java",
+     "name": "Debug (Attach) - Port 5005",
+     "request": "attach",
+     "hostName": "127.0.0.1",
+     "port": 5005,
+     "projectName": "sisvietnamvn"
+   }
+   ```
+
+3. **Attach the Debugger**:
+   - Go to the **Run and Debug** view in VS Code (`Ctrl+Shift+D`).
+   - Select **Debug (Attach) - Port 5005** from the dropdown at the top.
+   - Click the green **Play** button (or press `F5`).
+   - The application will resume booting.
+
+4. **Set Breakpoints & Debug**:
+   - Open any Java file (e.g., `SwiperSliderPlugin.java`).
+   - Click in the left margin next to a line number to place a red breakpoint.
+   - Trigger the code (e.g., by navigating to the page in your browser). Execution will pause at your breakpoint, allowing you to inspect variables!