admin/goyomi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: move deferred Phase 2 tasks to Phase 5 where they belong

Browse Source
This commit is contained in:
achmad
2026-05-10 21:37:58 +07:00
parent be46add182
commit 6d084d3df0
2 changed files with 6 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/phase2-database.md
+2 -9
View File
@@ -139,22 +139,15 @@ Generated by `sqlc generate` (config: `sqlc.yaml`, `sql_package: pgx/v5`).
## 2.5 Data Flow & Cache Logic
TTL env vars implemented in `internal/config/config.go`. Cache check logic lives in the API handler (Phase 5) using these values.
TTL env vars implemented in `internal/config/config.go`. Cache check logic and `?refresh=true` bypass live in the Phase 5 API handler using these values.
- [x] `MANGA_LIST_TTL_SECONDS` env var (default 600)
- [x] `MANGA_DETAIL_TTL_SECONDS` env var (default 3600)
- [x] `CHAPTER_LIST_TTL_SECONDS` env var (default 600)
- [ ] `?refresh=true` query param bypass — implemented in Phase 5 API handler
- [ ] Per-flow cache check + upsert logic — implemented in Phase 5 API handler
---
## Checklist: Phase 2 Done When
- [ ] `golang-migrate` runs `000001_init.up.sql` on a fresh DB without error (manual test with running postgres)
- [x] `sqlc generate` completes without errors; generated files compile
- [ ] `UpsertManga` + `GetMangaBySourceURL` round-trip test passes (requires running postgres)
- [ ] `UpsertChapter` correctly sets `source_order` from slice position (requires running postgres)
- [ ] TTL cache logic returns DB rows on second call (Phase 5)
- [ ] `?refresh=true` bypasses TTL (Phase 5)
- [ ] All tables visible in `psql` after API calls (Phase 5)
- [x] `go build ./...` succeeds
docs/phase5-api.md
+4
View File
@@ -168,6 +168,10 @@ OR `GET /api/sources/{id}/chapters?url={encodedURL}`
## Checklist: Phase 5 Done When
- [ ] `golang-migrate` runs `000001_init.up.sql` on a fresh DB without error
- [ ] `UpsertManga` + `GetMangaBySourceURL` round-trip succeeds (confirm via `psql`)
- [ ] `UpsertChapter` correctly sets `source_order` from slice position
- [ ] All tables (`manga`, `chapters`, `pages`) populated after API calls — confirm via `psql`
- [ ] `GET /api/sources` returns all registered sources
- [ ] `GET /api/sources/{heancmsID}/popular?page=1` returns ≥1 manga; rows in `manga` table confirmed via `psql`
- [ ] Second call to same URL returns from DB (no source HTTP call — confirm via log)