Split backend into internal packages by responsibility

All Go files lived flat in backend/ as one package main. Move store, latest-chapter polling, sessions, HTTP middleware, the JSON API, the userscript handler, and the web UI (with its templates/static assets) into backend/internal/{store,latest,session,httpmw,api,userscript,web}, each with an exported API. main.go becomes the composition root wiring them into newRouter; root-level tests cover the assembled router while package-local tests cover unit behavior. Update Dockerfile/.dockerignore for the new internal/ tree and CLAUDE.md to describe the layout. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-02 19:41:38 +07:00
parent e250762ea6
commit eeb601cbe2
36 changed files with 971 additions and 843 deletions
@@ -0,0 +1,122 @@
+package latest
+
+import "testing"
+
+// Trimmed from https://asurascans.com/comics/chronicles-of-the-demon-faction-f886a8af
+// fetched 2026-07-26. The first anchor is the "First Chapter" shortcut: it is a
+// real chapter link with no "Chapter N" text, and it must not be mistaken for
+// the latest just because it parses.
+const asuraSeriesFixture = `
+<a href="/comics/chronicles-of-the-demon-faction-f886a8af/chapter/1" class="py-3 rounded-md bg-[#E8E8E8]"><svg class="w-4 h-4"></svg>First Chapter</a>
+<a href="/comics/chronicles-of-the-demon-faction-f886a8af/chapter/179" data-astro-prefetch="hover" class="group flex"><span class="font-medium">Chapter 179</span></a>
+<a href="/comics/chronicles-of-the-demon-faction-f886a8af/chapter/181" data-astro-prefetch="hover" class="group flex"><span class="font-medium">Chapter 181</span></a>
+<a href="/comics/chronicles-of-the-demon-faction-f886a8af/chapter/180" data-astro-prefetch="hover" class="group flex"><span class="font-medium">Chapter 180</span></a>
+`
+
+// A chapter link belonging to a different series, of the kind a "you might also
+// like" strip would introduce. Slug scoping must exclude it.
+const asuraCrossSeriesFixture = asuraSeriesFixture + `
+<a href="/comics/some-other-series-aabbccdd/chapter/999" class="group flex"><span>Chapter 999</span></a>
+`
+
+// Trimmed from https://demonicscans.org/manga/Catastrophic-Necromancer fetched
+// 2026-07-26. Note the raw "&", the doubled space after <a, and the decimal
+// chapters, all as they appear live.
+const demonicSeriesFixture = `
+<a  href="/chaptered.php?manga=11799&chapter=0.5" class="chplinks" title="Catastrophic Necromancer 0.5">Chapter 0.5</a>
+<a  href="/chaptered.php?manga=11799&chapter=294" class="chplinks" title="Catastrophic Necromancer 294">Chapter 294</a>
+<a  href="/chaptered.php?manga=11799&amp;chapter=296" class="chplinks" title="Catastrophic Necromancer 296">Chapter 296</a>
+<a  href="/chaptered.php?manga=11799&chapter=295" class="chplinks" title="Catastrophic Necromancer 295">Chapter 295</a>
+`
+
+// What Cloudflare serves instead of the page when an IP's bot score flips.
+const challengeFixture = `<!DOCTYPE html><html><head><title>Just a moment...</title>
+<script src="/cdn-cgi/challenge-platform/h/b/orchestrate/chl_page/v1"></script></head>
+<body><div id="challenge-running">Checking your browser</div></body></html>`
+
+func TestLatestChapterFrom(t *testing.T) {
+	const asuraURL = "https://asurascans.com/comics/chronicles-of-the-demon-faction-f886a8af"
+	const demonicURL = "https://demonicscans.org/manga/Catastrophic-Necromancer"
+
+	tests := []struct {
+		name      string
+		site      string
+		seriesURL string
+		body      string
+		wantOK    bool
+		wantNum   float64
+		wantLabel string
+	}{
+		{
+			name: "asura takes the max, not the last listed",
+			site: "asura", seriesURL: asuraURL, body: asuraSeriesFixture,
+			wantOK: true, wantNum: 181, wantLabel: "Chapter 181",
+		},
+		{
+			name: "asura ignores another series' chapter links",
+			site: "asura", seriesURL: asuraURL, body: asuraCrossSeriesFixture,
+			wantOK: true, wantNum: 181, wantLabel: "Chapter 181",
+		},
+		{
+			name:      "asura scoping survives a build-hash rotation",
+			site:      "asura",
+			seriesURL: "https://asurascans.com/comics/chronicles-of-the-demon-faction-059befe1",
+			body:      asuraCrossSeriesFixture,
+			wantOK:    true, wantNum: 181, wantLabel: "Chapter 181",
+		},
+		{
+			name: "asura with an unparseable series url",
+			site: "asura", seriesURL: "https://asurascans.com/", body: asuraSeriesFixture,
+			wantOK: false,
+		},
+		{
+			name: "demonic takes the max across raw and escaped ampersands",
+			site: "demonic", seriesURL: demonicURL, body: demonicSeriesFixture,
+			wantOK: true, wantNum: 296, wantLabel: "Chapter 296",
+		},
+		{
+			name: "demonic keeps decimal chapters parseable",
+			site: "demonic", seriesURL: demonicURL,
+			body:   `<a href="/chaptered.php?manga=11799&chapter=0.5">Chapter 0.5</a>`,
+			wantOK: true, wantNum: 0.5, wantLabel: "Chapter 0.5",
+		},
+		{
+			name: "empty body",
+			site: "asura", seriesURL: asuraURL, body: "",
+			wantOK: false,
+		},
+		{
+			name: "cloudflare challenge page",
+			site: "asura", seriesURL: asuraURL, body: challengeFixture,
+			wantOK: false,
+		},
+		{
+			name: "demonic markup handed to the asura rule",
+			site: "asura", seriesURL: asuraURL, body: demonicSeriesFixture,
+			wantOK: false,
+		},
+		{
+			name: "unknown site",
+			site: "mangadex", seriesURL: "https://example.com/x", body: asuraSeriesFixture,
+			wantOK: false,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got, ok := latestChapterFrom(tt.site, tt.seriesURL, tt.body)
+			if ok != tt.wantOK {
+				t.Fatalf("ok = %v, want %v (got %+v)", ok, tt.wantOK, got)
+			}
+			if !tt.wantOK {
+				return
+			}
+			if got.Num != tt.wantNum {
+				t.Errorf("Num = %v, want %v", got.Num, tt.wantNum)
+			}
+			if got.Label != tt.wantLabel {
+				t.Errorf("Label = %q, want %q", got.Label, tt.wantLabel)
+			}
+		})
+	}
+}