legal: private bug reports, mirrored widget images, logs, AI merge disclosure

- privacy (effective 2026-10-24): bug reports live in a private repository (they now
  do — the site files them in poli0981/site-reports); widget thumbnails and game icons are
  served by the site itself, so nothing reaches YouTube or Steam before you press play;
  Workers Logs (7-day retention) and expiring IP blocks are disclosed; the service
  worker's offline cache is listed with the other local storage.
- ai-usage: §3 says what is true — changes still reach the site only through PRs that
  pass CI, and the AI agent merges/deploys them only when explicitly told to; Claude Opus
  5.5 added to the model table.
- third-party: the libraries and every infrastructure service the site uses (R2,
  Images, Access, Workers Logs, Discord).
- README: gallery-photos/ and now/, and how publishing works from the admin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
poli0981andClaude Opus 5.5 committed 2026-10-24 09:52:11 +07:00
1 parent 51a1625b20
commit 9265c94db2
4 files changed
+55 -28

No files matched your search

+11 -3
View File
@@ -13,8 +13,10 @@ content collections read directly from these paths, so the directory names here
| `stories/` | `stories` | `<series>/<chapter>.md` — the folder name is the series route segment |
| `projects/` | `projects` | standalone schema (`name`, `tagline`, `stack`, `repo`, `year`…) |
| `faq/` | `faq` | `q`, `lang`, `group` (`channel` / `dev` / `personal`), `order` |
| `gallery/` | `gallery` | album **metadata only** — the images live in the site repo under `src/assets/gallery/<album>/` |
| `gallery/` | `gallery` | album **metadata only**; photos are local files in the site repo (`src/assets/gallery/<album>/`) and/or R2 uploads listed in `gallery-photos/<album>.json` |
| `gallery-photos/` | — | per-album R2 photo lists (`{ photos: [{ id, w, h, caption: { vi, en } }] }`), written by the admin |
| `legal/` | `legal` | bilingual within one file (`## English` then `## Tiếng Việt`); both locale routes render the same document |
| `now/` | `now` | the /now page, one file per locale (`updated` is required) |
## Editing
@@ -34,8 +36,14 @@ MDX files can only use components that exist there.
## Publishing a change
Commit here, then bump the submodule pointer in the site repo — the site builds from the
commit that repo has pinned, so a commit here alone does not deploy anything.
Most edits happen in the admin (admin.poli0981.dev), which commits straight to `main` here.
Its **Publish** button then runs the site repo's `content-bump` workflow: a PR that points the
submodule at this repo's `main`, merged automatically once CI passes when only `.md`/`.json`
changed (MDX runs code at build time, so it waits for a review).
Editing by hand works the same way: commit here, then bump the submodule pointer in the site
repo — the site builds from the commit that repo has pinned, so a commit here alone does not
deploy anything.
## License
+26 -15
View File
@@ -1,7 +1,7 @@
---
title: "Sử dụng AI / AI Disclosure"
order: 6
effectiveDate: "2026-08-10"
effectiveDate: "2026-10-24"
---
## English
@@ -17,8 +17,11 @@ reviewing/checking the result. The table below names the model, its version, and
taken and edited by me. Nothing in `/blog`, `/truyen` or `/gallery` is model-generated text or
image, and I do not intend to change that without saying so here first.
**3. Human review.** Every change reaches the site through a pull request that I read and merge
myself. AI does not have publish access, and no automation deploys unreviewed output.
**3. Human control.** Every change reaches the site through a pull request, and every pull
request must pass CI first: build, type checks, unit tests, a smoke test of the built Worker and
a SonarCloud quality gate. I either merge it myself or explicitly tell the AI agent to merge (and
deploy) it once those checks pass. The agent has no standing permission to publish, and nothing
it writes goes live unless I asked for that change.
**4. The legal texts.** Terms, Privacy, Disclaimer, Content License and Third-Party Notices were
drafted from AI-generated templates and then edited against how the site actually works. They
@@ -43,8 +46,11 @@ rà soát/kiểm tra kết quả. Bảng dưới ghi rõ tên model, phiên bả
viết, chụp và biên tập. Không có chữ hay ảnh nào trong `/blog`, `/truyen`, `/gallery` do model sinh
ra, và mình sẽ không thay đổi điều đó mà không ghi lại ở đây trước.
**3. Con người duyệt.** Mọi thay đổi lên trang đều đi qua một pull request do chính mình đọc và
merge. AI không có quyền publish, và không có tự động hoá nào deploy thứ chưa được duyệt.
**3. Con người quyết định.** Mọi thay đổi lên trang đều đi qua một pull request, và mọi pull
request phải qua CI trước: build, kiểm tra kiểu, unit test, smoke test cho Worker đã build và
quality gate của SonarCloud. Mình tự merge, hoặc chỉ thị rõ ràng cho AI agent merge (và deploy)
khi các bước kiểm tra đó đã đạt. Agent không có quyền publish thường trực, và không thứ gì nó
viết được đưa lên trang nếu mình không yêu cầu thay đổi đó.
**4. Về các văn bản pháp lý.** Điều khoản, Bảo mật, Miễn trừ, Giấy phép nội dung và Bên thứ ba được
soạn từ template do AI sinh ra, sau đó biên tập lại cho khớp với cách site thực sự hoạt động. Đây
@@ -58,16 +64,21 @@ luyện bị cấm theo [Điều khoản](/legal/terms/) §3 và [Giấy phép n
## Models
| Việc / Task | Công cụ / Tool | Model | Nhà phát triển / Vendor |
| --------------------------------------- | ----------------- | --------------- | ----------------------- |
| Viết mã nguồn / Writing source code | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Viết mã nguồn / Writing source code | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Kiểm thử / Testing | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Kiểm thử / Testing | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Gỡ lỗi / Debugging | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Gỡ lỗi / Debugging | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Rà soát, kiểm tra / Review and checking | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Rà soát, kiểm tra / Review and checking | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Việc / Task | Công cụ / Tool | Model | Nhà phát triển / Vendor |
| ----------------------------------------------------------------- | --------------------- | --------------- | ----------------------- |
| Viết mã nguồn / Writing source code | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Viết mã nguồn / Writing source code | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Viết mã nguồn / Writing source code | Claude Code (desktop) | Claude Opus 5.5 | Anthropic |
| Kiểm thử / Testing | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Kiểm thử / Testing | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Kiểm thử / Testing | Claude Code (desktop) | Claude Opus 5.5 | Anthropic |
| Gỡ lỗi / Debugging | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Gỡ lỗi / Debugging | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Gỡ lỗi / Debugging | Claude Code (desktop) | Claude Opus 5.5 | Anthropic |
| Rà soát, kiểm tra / Review and checking | Claude Code (CLI) | Claude Opus 4.8 | Anthropic |
| Rà soát, kiểm tra / Review and checking | Claude Code (CLI) | Claude Opus 5 | Anthropic |
| Rà soát, kiểm tra / Review and checking | Claude Code (desktop) | Claude Opus 5.5 | Anthropic |
| Merge và deploy theo chỉ thị / Merging and deploying when told to | Claude Code (desktop) | Claude Opus 5.5 | Anthropic |
**Verifiable / Có thể kiểm chứng:** commits made with AI assistance carry a
`Co-Authored-By: Claude <noreply@anthropic.com>` trailer naming the model, so the git history is
+9 -9
View File
@@ -1,7 +1,7 @@
---
title: "Bảo mật / Privacy Policy"
order: 2
effectiveDate: "2026-10-07"
effectiveDate: "2026-10-24"
---
## English
@@ -12,15 +12,15 @@ This is a personal website designed to collect as little data as possible.
**2. Analytics.** The Site uses Cloudflare Web Analytics, a cookie-free, privacy-focused service that reports aggregate statistics (page views, country, browser type, page-load performance). Pages load its small script from static.cloudflareinsights.com, which reports to Cloudflare. It sets no cookies and does not build visitor profiles.
**3. Hosting & security logs.** The Site runs on Cloudflare. Like virtually all websites, requests pass through infrastructure that processes IP addresses and request metadata for security (DDoS mitigation, abuse prevention, rate limiting). I use IP addresses only transiently for rate limiting and blocking abuse; they are not stored in my own records.
**3. Hosting & security logs.** The Site runs on Cloudflare Workers. Like virtually all websites, requests pass through infrastructure that processes IP addresses and request metadata for security (DDoS mitigation, abuse prevention, rate limiting). The Site also keeps short-lived technical request logs (Cloudflare Workers Logs: the page path without its query string, the response status, timing, errors, and request metadata such as IP address, country and browser type), which Cloudflare deletes after 7 days. I use them only to fix problems and stop abuse. An IP address or range is kept longer only if I block it for abuse, and every such block has an expiry.
**Bot check.** Before your first page view the Site runs Cloudflare Turnstile, a challenge that checks the browser is not an automated scraper; Cloudflare processes technical signals for it (such as IP address and browser characteristics) under its own privacy policy. Passing it sets one strictly necessary cookie, `__Host-gate`, valid for 48 hours. It holds only an expiry time, a random value and a signature — nothing that identifies you — and is never used for tracking. Search engines and link-preview services verified by Cloudflare skip the check; feeds, the sitemap and the legal pages are always open.
**4. Bug reports (the only form on the Site).** If you choose to send a bug report, the following is transmitted and stored as a private GitHub issue and a Discord notification: your description, the page route, browser user-agent, viewport size, theme/language setting, and — only if you leave the checkbox enabled — the last console error messages shown to you in a preview before sending. No IP address is stored with the report. Contact me to request deletion of a report you sent.
**4. Bug reports (the only form on the Site).** If you choose to send a bug report, the following is transmitted and stored as an issue in a private GitHub repository (visible only to me) and sent as a Discord notification: your description, the page route, browser user-agent, viewport size, theme/language setting, and — only if you leave the checkbox enabled — the last console error messages shown to you in a preview before sending. No IP address is stored with the report. Contact me to request deletion of a report you sent.
**5. Embedded videos.** YouTube videos load only after you click them, via YouTube's privacy-enhanced domain (youtube-nocookie.com). Before you click, only a static thumbnail is loaded. Once you click, YouTube's own privacy policy applies.
**5. Embedded videos and widget images.** YouTube videos load only after you click them, via YouTube's privacy-enhanced domain (youtube-nocookie.com). Before you click, the video thumbnail — like the game icons in the home-page widgets — is a copy served by this Site, so your browser does not contact YouTube or Steam just to show the page. Once you click, YouTube's own privacy policy applies.
**6. Local storage.** The Site stores small preferences in your browser only: theme, scrollbar visibility, reading settings, legal-notice acknowledgement, and (if you play the offline mini-game) a best score. These never leave your device.
**6. Local storage.** The Site stores small preferences in your browser only: theme, scrollbar visibility, reading settings, legal-notice acknowledgement, and (if you play the offline mini-game) a best score. To work offline, a service worker also keeps the offline page and some of the Site's own script and style files in your browser's cache. None of this ever leaves your device.
**7. Email.** Mail sent to any @poli0981.dev address (contact@, privacy@, security@, and the other topic addresses listed on the Site) is delivered to my mailbox on Google Workspace (Google LLC processes it under its own terms) and kept as normal correspondence.
@@ -38,15 +38,15 @@ This is a personal website designed to collect as little data as possible.
**2. Thống kê truy cập.** Trang web dùng Cloudflare Web Analytics — dịch vụ không cookie, tôn trọng quyền riêng tư, chỉ báo số liệu tổng hợp (lượt xem, quốc gia, loại trình duyệt, tốc độ tải trang). Các trang tải một script nhỏ từ static.cloudflareinsights.com và gửi số liệu về Cloudflare. Script không đặt cookie và không dựng hồ sơ người xem.
**3. Hạ tầng & log bảo mật.** Trang web chạy trên Cloudflare. Như hầu hết website, request đi qua hạ tầng có xử lý địa chỉ IP và metadata cho mục đích bảo mật (chống DDoS, chống lạm dụng, rate limiting). Mình chỉ dùng IP thoáng qua để giới hạn tần suất và chặn phá hoại; IP không được lưu trong hồ sơ riêng của mình.
**3. Hạ tầng & log bảo mật.** Trang web chạy trên Cloudflare Workers. Như hầu hết website, request đi qua hạ tầng có xử lý địa chỉ IP và metadata cho mục đích bảo mật (chống DDoS, chống lạm dụng, rate limiting). Trang cũng giữ log kỹ thuật ngắn hạn cho từng request (Cloudflare Workers Logs: đường dẫn trang không kèm query string, mã trạng thái, thời gian xử lý, lỗi, và metadata như địa chỉ IP, quốc gia, loại trình duyệt); Cloudflare tự xoá sau 7 ngày. Mình chỉ dùng chúng để sửa lỗi và chặn phá hoại. Một địa chỉ IP (hoặc dải IP) chỉ bị lưu lâu hơn khi mình chặn nó vì lạm dụng, và mọi lệnh chặn đều có thời hạn.
**Xác minh chống bot.** Trước lượt xem đầu tiên, trang chạy Cloudflare Turnstile — bước kiểm tra trình duyệt không phải bot thu thập nội dung; Cloudflare xử lý các tín hiệu kỹ thuật (như địa chỉ IP, đặc điểm trình duyệt) theo chính sách riêng của họ. Qua bước này, trình duyệt nhận một cookie thiết yếu duy nhất, `__Host-gate`, hiệu lực 48 giờ. Cookie chỉ chứa thời điểm hết hạn, một giá trị ngẫu nhiên và chữ ký — không có gì định danh bạn — và không bao giờ dùng để theo dõi. Công cụ tìm kiếm và dịch vụ xem trước liên kết đã được Cloudflare xác thực thì bỏ qua bước này; RSS, sitemap và các trang pháp lý luôn mở.
**4. Báo lỗi (biểu mẫu duy nhất trên trang).** Nếu bạn chủ động gửi báo lỗi, những thứ sau được truyền và lưu dưới dạng GitHub issue riêng tư + thông báo Discord: mô tả của bạn, đường dẫn trang, user-agent trình duyệt, kích thước màn hình, cài đặt theme/ngôn ngữ, và — chỉ khi bạn để nguyên ô tick — các lỗi console gần nhất (có bản xem trước trước khi gửi). Địa chỉ IP không được lưu kèm báo cáo. Muốn xoá báo cáo đã gửi: liên hệ mình.
**4. Báo lỗi (biểu mẫu duy nhất trên trang).** Nếu bạn chủ động gửi báo lỗi, những thứ sau được truyền và lưu dưới dạng issue trong một repo GitHub riêng tư (chỉ mình xem được), kèm một thông báo Discord: mô tả của bạn, đường dẫn trang, user-agent trình duyệt, kích thước màn hình, cài đặt theme/ngôn ngữ, và — chỉ khi bạn để nguyên ô tick — các lỗi console gần nhất (có bản xem trước trước khi gửi). Địa chỉ IP không được lưu kèm báo cáo. Muốn xoá báo cáo đã gửi: liên hệ mình.
**5. Video nhúng.** Video YouTube chỉ tải sau khi bạn bấm, qua tên miền tăng cường riêng tư (youtube-nocookie.com). Trước khi bấm, chỉ có ảnh thumbnail tĩnh. Sau khi bấm, chính sách của YouTube áp dụng.
**5. Video nhúng và ảnh trong widget.** Video YouTube chỉ tải sau khi bạn bấm, qua tên miền tăng cường riêng tư (youtube-nocookie.com). Trước khi bấm, ảnh thumbnail — cũng như icon game trong các widget ở trang chủ — là bản sao do chính trang này phục vụ, nên trình duyệt của bạn không kết nối tới YouTube hay Steam chỉ để hiển thị trang. Sau khi bấm, chính sách của YouTube áp dụng.
**6. Lưu trữ cục bộ.** Trang web lưu vài tuỳ chọn nhỏ ngay trong trình duyệt của bạn: theme, ẩn/hiện thanh cuộn, cài đặt đọc, ghi nhận đã xem thông báo pháp lý, và (nếu bạn chơi mini-game offline) điểm cao nhất. Chúng không bao giờ rời thiết bị của bạn.
**6. Lưu trữ cục bộ.** Trang web lưu vài tuỳ chọn nhỏ ngay trong trình duyệt của bạn: theme, ẩn/hiện thanh cuộn, cài đặt đọc, ghi nhận đã xem thông báo pháp lý, và (nếu bạn chơi mini-game offline) điểm cao nhất. Để dùng được khi mất mạng, service worker còn giữ trang offline và một số file script/style của chính trang trong bộ nhớ đệm của trình duyệt. Tất cả những thứ này không bao giờ rời thiết bị của bạn.
**7. Email.** Mail gửi tới bất kỳ địa chỉ @poli0981.dev nào (contact@, privacy@, security@ và các địa chỉ theo chủ đề ghi trên trang) được chuyển vào hộp thư Google Workspace của mình (Google LLC xử lý theo điều khoản của họ) và lưu như thư từ thông thường.
+9 -1
View File
@@ -20,9 +20,17 @@ Trang web này được xây dựng bằng phần mềm mã nguồn mở. Mỗi
| Tailwind CSS | MIT |
| Pagefind | MIT |
| Zod | MIT |
| jose (admin sign-in check) | MIT |
| marked, yaml (admin editor) | MIT / ISC |
| sharp | Apache-2.0 |
| Satori + @resvg/resvg-js (build-time OG images) | MPL-2.0 |
| TypeScript (build-time type checking) | Apache-2.0 |
| Wrangler | MIT / Apache-2.0 |
| Bricolage Grotesque, Be Vietnam Pro, Literata, JetBrains Mono | SIL OFL 1.1 |
**Infrastructure services** (not packages, listed for transparency): Cloudflare (hosting / CDN / analytics / Turnstile), GitHub (source, issues), YouTube / Steam / GitHub public-data APIs (widgets).
**Infrastructure services** (not packages, listed for transparency):
- **Cloudflare** — hosting (Workers, KV, R2 storage, Images), CDN, Web Analytics, Turnstile, Access (the admin sign-in) and Workers Logs.
- **GitHub** — source code, content, and bug reports (filed in a private repository).
- **Discord** — notifications when a bug report arrives.
- **YouTube / Steam / GitHub public data** — read by a scheduled job for the home-page widgets; their pictures are copied and served from this site.