chore: remove plans folder
This commit is contained in:
@@ -1,45 +0,0 @@
|
||||
---
|
||||
finding: "Expose episode availability freshness / retry state"
|
||||
catalog: "Direction"
|
||||
impact:
|
||||
"Users cannot see stale, retrying, or failed episode availability state even though the app tracks
|
||||
it."
|
||||
base_commit: "0d31d46"
|
||||
---
|
||||
|
||||
## Effort
|
||||
|
||||
M/L - scope depends on whether this is a small per-title detail or a broader maintenance page.
|
||||
|
||||
## Risk
|
||||
|
||||
MED - exposing provider/cache internals can clutter UI or confuse users if wording is too technical.
|
||||
|
||||
## Confidence
|
||||
|
||||
MED - the data exists, but product shape needs maintainer judgment.
|
||||
|
||||
## Evidence
|
||||
|
||||
- `internal/episodes/worker.go:12-31` refreshes due episode availability in the background.
|
||||
- `internal/episodes/service/cache_store.go:50-65` stores next refresh, retry window, last
|
||||
attempt/success, failure count, and last error metadata through query parameters.
|
||||
- `templates/components/anime_episode_count.gohtml` currently collapses availability to a compact
|
||||
episode/audio label.
|
||||
|
||||
## Resolution Approach
|
||||
|
||||
Start with the smallest useful user-facing surface: a per-title availability status detail near the
|
||||
existing episode-count/audio label. Show human-readable freshness such as last refreshed, next
|
||||
refresh, retrying soon, or temporarily unavailable. Avoid exposing raw provider errors unless they
|
||||
are sanitized and clearly useful.
|
||||
|
||||
Consider adding an authenticated manual refresh action only after the read-only status is useful.
|
||||
Manual refresh should be rate-limited or guarded to avoid hammering providers.
|
||||
|
||||
Add service/view-model tests that map cache metadata to user-facing states. Add template tests for
|
||||
fresh, stale, retrying, and failed states. If this becomes a maintenance page instead, split that
|
||||
into a separate design plan before implementation.
|
||||
|
||||
Verify with `go test ./internal/episodes/... ./templates ./...` and relevant lint/typecheck commands
|
||||
if UI scripts are added.
|
||||
Reference in New Issue
Block a user