# Vietlume

> Vietlume (https://vietlume.com) là trang du lịch Việt Nam: bản đồ địa điểm có nguồn, mùa du lịch và lịch trình theo ngày.
> Tài liệu này mô tả một dạng link để người dùng lưu lịch trình vào tài khoản Vietlume của chính họ.
> English: a link format that saves a day-by-day itinerary into the user's own Vietlume account once they open it and sign in.

## Cách hoạt động
- Trợ lý AI dựng một link https://vietlume.com/lich/tao?... theo một trong hai dạng dưới và đưa cho người dùng.
- Người dùng mở link, đăng nhập, xem trước, rồi tự bấm "Lưu vào Lịch của tôi". Mở link không tạo hay đổi gì.
- Không cần khoá API, không cần đăng nhập phía trợ lý AI. Link chỉ chứa điểm đến, số ngày, loại hình hoặc tên địa điểm.

## Dạng 1 — lịch gợi ý có sẵn
https://vietlume.com/lich/tao?diem_den=<slug>&so_ngay=<N>&loai_hinh=<key>
- diem_den: slug điểm đến (mục Điểm đến).
- so_ngay: số ngày, trong khoảng của loại hình đó.
- loai_hinh (tuỳ chọn): key loại hình. Bỏ trống: loại hình đầu tiên có N ngày.
- dong (tuỳ chọn): pho-bien (mặc định — theo nơi nhiều người đã đi) hoặc trai-nghiem (lệch khỏi lối mòn, có lý do).
Ví dụ: https://vietlume.com/lich/tao?diem_den=dao-cat-ba&so_ngay=3&loai_hinh=kham_pha_thien_nhien

## Dạng 2 — lịch tự xếp
https://vietlume.com/lich/tao?diem_den=<slug>&so_ngay=<N>&lich=<chuỗi>
- lich: các buổi cách nhau bằng dấu ; — mỗi buổi là n<ngày>-<buổi>:<mục>,<mục>
- buổi: sang, trua, chieu, toi, dem
- mục: tên địa điểm viết thường, gạch ngang thay khoảng trắng; có dấu hay không dấu đều được.
  Dùng tên trong danh sách địa điểm của điểm đến (link ở mục Điểm đến) để khớp chắc chắn.
- Mục không khớp địa điểm nào được giữ thành ghi chú, đúng chữ đã viết (ví dụ: thue-xe-may, lan-ngam-san-ho).
- Giới hạn: 14 ngày, 6 mục mỗi buổi, 60 mục.
Ví dụ: https://vietlume.com/lich/tao?diem_den=dao-cat-ba&so_ngay=2&lich=n1-sang:<ten-dia-diem>,<ten-dia-diem>;n1-chieu:<ten-dia-diem>

- ten (tuỳ chọn, cả hai dạng): tên lịch, gạch ngang thay khoảng trắng.

## Điểm đến

### Đảo Cát Bà (Cat Ba Island) — dao-cat-ba
- Địa điểm (81): https://vietlume.com/llms/dao-cat-ba.txt
- Chưa có lịch gợi ý; dùng Dạng 2.

### Đảo Phú Quý (Phu Quy Island) — dao-phu-quy
- Địa điểm (40): https://vietlume.com/llms/dao-phu-quy.txt
- Loại hình (key: tên, số ngày):
  - nghi_duong_bien: Nghỉ dưỡng biển / Beach escape, 2–14
  - tam_linh_van_hoa: Tâm linh & văn hoá / Spiritual & cultural, 2–14
  - kham_pha_thien_nhien: Khám phá thiên nhiên / Nature exploration, 2–14
  - am_thuc: Ẩm thực / Food trail, 2–14
  - vui_choi_hoat_dong: Vui chơi & hoạt động / Activities & fun, 2–14
  - doan_dong: Đoàn đông / Large groups, 2–14
  - phuot_tiet_kiem: Phượt / tiết kiệm / Budget road trip, 2–14
  - cap_doi: Cặp đôi / trăng mật / Couples & honeymoon, 2–14

## English summary
- Suggested plan: https://vietlume.com/lich/tao?diem_den=<slug>&so_ngay=<days>&loai_hinh=<style key>
- Own plan: https://vietlume.com/lich/tao?diem_den=<slug>&so_ngay=<days>&lich=n1-sang:<place>,<place>;n1-chieu:<place>
  (buổi = sang morning · trua noon · chieu afternoon · toi evening · dem night; places in lowercase with dashes)
- The user opens the link, signs in, previews and saves. Opening the link alone changes nothing.

## Trang cho người đọc
- https://vietlume.com/ai — hướng dẫn dùng Vietlume với trợ lý AI
- https://vietlume.com/lich-trinh — lịch gợi ý
- https://vietlume.com/privacy — chính sách quyền riêng tư