58 lines
2.8 KiB
Markdown
58 lines
2.8 KiB
Markdown
# Buzz Sheet Structured Guide Platform
|
||
|
||
## Product
|
||
|
||
Buzz Sheet is a Thai-first, image-first Genshin guide CMS. The public directory
|
||
shows a required cover and Overview for every guide. Each guide exposes only
|
||
non-empty Weapons, Artifacts & Stats, Constellations, Team Calc, and optional
|
||
Extra sections. Use the English terms “Build” and “Team” throughout the UI.
|
||
|
||
The admin workflow stays intentionally simple:
|
||
|
||
1. Manually Sync the latest Lunaris catalog.
|
||
2. Select one Lunaris character at `/admin/create`.
|
||
3. Upload a required Guide Image and write the Overview.
|
||
4. Edit one structured section at a time under `/admin/[charid]`.
|
||
5. Press Save to update the public website immediately.
|
||
|
||
There is one guide per Lunaris character key. Empty sections remain private.
|
||
Remove Guide moves content to a recoverable Trash before permanent deletion.
|
||
|
||
## Structured content
|
||
|
||
- Weapons: catalog weapon, R1–R5, overall percent and/or personal percent.
|
||
- Artifacts: multiple named ranking groups, one-set or two-set rows, percent,
|
||
up to two main stats per slot, ordered substats, targets, NA/E/Q priority and
|
||
levels, and an optional note.
|
||
- Constellations: C1–C6 description and cumulative performance against C0=100%.
|
||
- Team Calc: multiple four-character teams, raw damage, calculated member
|
||
shares, rotation duration, total DPS, and combo text.
|
||
- Extra: multiple sections of image-first rows with heading, short body, and an
|
||
optional percentage.
|
||
|
||
## Catalog and media
|
||
|
||
The Sync button enqueues a worker job. It fetches Lunaris `version.json` and
|
||
the versioned character, weapon, and artifact lists, validates them, filters
|
||
placeholder or missing-image records, mirrors unique WebP assets and normalized
|
||
JSON to Bun S3, then atomically activates the completed version. Failed jobs do
|
||
not replace the active catalog. There is no automatic sync.
|
||
|
||
`S3_ENDPOINT` is the private Garage API used for writes.
|
||
`S3_PUBLIC_URL=https://buzz-cdn.astrxl.dev` is the public read base. Browser
|
||
uploads go to an authenticated application route, which validates PNG, JPEG,
|
||
WebP, or GIF files up to 20 MB and writes them server-side through Bun S3.
|
||
|
||
## Operations and acceptance
|
||
|
||
- PostgreSQL migrations run before the ARM64 web and worker rollout.
|
||
- Better Auth users and sessions are preserved; the legacy block-editor guide
|
||
content is intentionally reset by migration `0002`.
|
||
- Redis outbox events invalidate the directory and guide streams after saves,
|
||
trash, restore, or delete actions.
|
||
- Verification requires `bun run test`, `bun run typecheck`, `bun run lint`,
|
||
`kubectl kustomize k8s/`, a successful ARM64 container build, ready health
|
||
checks, CDN reads, authenticated upload, catalog sync, and public rendering.
|
||
- Do not use Chromium or Playwright. Use Vitest, HTTP checks, and manual browser
|
||
verification.
|