lightnovel-crawler

Add or modify a FastAPI endpoint in lncrawl — router aggregation, ensure_user/ensure_admin security, DTO vs DAO models, pagination, ServerErrors. Use when touching lncrawl/server/api/, security.py, or server/models/.

Add or modify a background job type in lncrawl — JobType enum, JobService factory, handler class, registry, notifications. Use when creating a new job kind, changing a handler, or debugging job scheduling/cancellation.

Create or fix a source crawler — base-class choice (SoupTemplate/LegacyCrawler/shared templates), selectors, cleaner tuning, testing via CLI, index-gen. Use when adding a new source site, fixing a broken crawler, or working in sources/ or lncrawl/templates/.

Schema changes in lncrawl — SQLModel DAO models, Alembic migration workflow (dev migrate CLI), Postgres/SQLite dialect differences, enum-sync migrations. Use when adding/changing a DAO model field or writing/reviewing a migration.

Binder (e-book output formats) and Translator services — architecture and recipes for adding an output format or a translation backend. Use when working in services/binder/ or services/translators/.

How lncrawl (lightnovel-crawler) releases work — version bump, tag-triggered release pipeline, changelog, per-OS builds, PyPI, Docker, web sync. Use when cutting a release, editing workflows, or debugging CI.