43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
|
# IMPORT-LOG
|
||
|
|
|
||
|
|
Append-only ledger of media-import events for ARRFLIX. Each file in this
|
||
|
|
directory documents a single import operation so future audits can trace
|
||
|
|
content on disk back to its provenance.
|
||
|
|
|
||
|
|
## Convention
|
||
|
|
|
||
|
|
- **One file per import event.**
|
||
|
|
- **Filename format:** `YYYY-MM-DD-<source>-<show-slug>.md`
|
||
|
|
- `<source>` is the upstream type (`youtube`, `tvdb-rip`, `bluray`, `manual`, etc.).
|
||
|
|
- `<show-slug>` is the lowercase show name with `-` separators.
|
||
|
|
- Example: `2026-05-08-youtube-sassy-the-sasquatch.md`.
|
||
|
|
- **Date** is the day the import landed on the live library (not the day the
|
||
|
|
source was published).
|
||
|
|
|
||
|
|
## Required sections
|
||
|
|
|
||
|
|
Each entry should include:
|
||
|
|
|
||
|
|
1. **Source** — upstream URL/handle, channel/distributor, identifiers.
|
||
|
|
2. **Date imported** — ISO-8601.
|
||
|
|
3. **Episodes imported** — table mapping source identifier → canonical
|
||
|
|
filename → Jellyfin item id (resolution + size where applicable).
|
||
|
|
4. **Naming rules applied** — citations of the `docs/0X.md` rule numbers
|
||
|
|
invoked, with a short note on the specific edit each made.
|
||
|
|
5. **rsync stats** — `sent / received / speedup` from the transfer.
|
||
|
|
6. **Jellyfin verification** — series id, episode count, direct-play status.
|
||
|
|
7. **Known caveats** — anything that wasn't perfect (missing metadata,
|
||
|
|
failed thumbnails, age-restricted episodes, etc.).
|
||
|
|
8. **Source manifest copied** — top-level fields of the operator's
|
||
|
|
`manifest.json`. Do **not** embed the full `episodes[]` array — link to
|
||
|
|
the canonical files in the live library instead.
|
||
|
|
|
||
|
|
## Boundaries
|
||
|
|
|
||
|
|
- **No access tokens, API keys, or session cookies** in any log file.
|
||
|
|
- For YouTube imports, **do not include full video URLs** — record the bare
|
||
|
|
`videoId` only, so import logs are not indexable as a re-distribution
|
||
|
|
pointer.
|
||
|
|
- Logs are **immutable once committed**. To correct a mistake, append a
|
||
|
|
follow-up entry rather than rewriting history.
|