Files
Febe/src/Febe.Core/Storage/IEntryStore.cs
T
Claude 3aeaa17da7 M1 Dati e libreria: modello, archivi SQLite con scrittore unico, nomi dei file, scrittura sicura, miniature, impronte, _febe.jsonl, copie, eliminazione e ricostruzione
Modello del dominio e interfacce degli archivi in Febe.Core; implementazione SQLite in Febe.Data (WAL, chiavi esterne, migrazioni numerate in transazione, coda di scrittura su un solo thread); logica della libreria in Febe.Core/Library; 164 prove MSTest, compresa la ricostruzione del database da una libreria di prova e la scala a 200.000 elementi.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
2026-10-13 16:06:15 +00:00

77 lines
4.8 KiB
C#

using Febe.Core.Domain;
namespace Febe.Core.Storage;
/// <summary>Entries (spec §4.3, §8.3 <c>entry</c>) and the library queries of the interface (spec §4.6).</summary>
public interface IEntryStore
{
Task<Entry?> GetAsync(long entryId, CancellationToken ct = default);
Task<EntryWithMedia?> GetWithMediaAsync(long entryId, CancellationToken ct = default);
/// <summary>The entry with this identity, in any state (deleted included).</summary>
Task<Entry?> FindAsync(long accountId, EntryKind kind, string instagramId, CancellationToken ct = default);
/// <summary>
/// «Is this Instagram identifier known?» for (account, kind), in any state — deleted entries count as known so
/// they are never downloaded again (spec §4.6).
/// </summary>
Task<bool> IsKnownAsync(long accountId, EntryKind kind, string instagramId, CancellationToken ct = default);
/// <summary>Which of these identifiers are already known for (account, kind), in any state. For readers: one query per page.</summary>
Task<IReadOnlySet<string>> GetKnownInstagramIdsAsync(long accountId, EntryKind kind, IReadOnlyCollection<string> instagramIds, CancellationToken ct = default);
/// <summary>Entries of an account with this Instagram identifier, any kind and state (e.g. a story that entered a highlight).</summary>
Task<IReadOnlyList<Entry>> FindByInstagramIdAsync(long accountId, string instagramId, CancellationToken ct = default);
/// <summary>
/// An entry of (account, kind) published within <paramref name="tolerance"/> of <paramref name="publishedAt"/>:
/// recognizes imported entries that have no Instagram identifier (spec §9.5, two seconds).
/// </summary>
Task<Entry?> FindByPublicationTimeAsync(long accountId, EntryKind kind, DateTimeOffset publishedAt, TimeSpan tolerance, CancellationToken ct = default);
/// <summary>
/// Adds an entry with its files in one transaction. Idempotent on (account, kind, Instagram identifier): when the
/// entry is already known, nothing changes and the stored entry is returned with <c>Created = false</c>.
/// Positions of the files must be distinct.
/// </summary>
Task<AddEntryResult> AddAsync(Entry entry, IReadOnlyList<Media> media, CancellationToken ct = default);
/// <summary>Adds many entries in one transaction (import, rebuild). Same semantics as <see cref="AddAsync"/>.</summary>
Task<IReadOnlyList<AddEntryResult>> AddManyAsync(IReadOnlyList<NewEntry> entries, CancellationToken ct = default);
/// <summary>Replaces the mutable fields of an entry (Instagram identifier, code, caption, author, state, dates).</summary>
Task UpdateAsync(Entry entry, CancellationToken ct = default);
Task SetStateAsync(long entryId, EntryState state, CancellationToken ct = default);
/// <summary>Recomputes the state of an entry from its files (<see cref="EntryStateRules.FromMedia"/>).</summary>
Task<EntryState> RecomputeStateAsync(long entryId, CancellationToken ct = default);
/// <summary>
/// «Eliminato»: the entry stays without files so it is not downloaded again (spec §4.6). Its files become
/// <see cref="MediaState.Deleted"/> and lose their path and perceptual hash; SHA-256 and size are kept. Deleting files on disk is the caller's job.
/// </summary>
Task MarkDeletedAsync(long entryId, DateTimeOffset at, CancellationToken ct = default);
/// <summary>«Eliminalo e lascia che torni»: removes the record (files records and highlight links by cascade).</summary>
Task RemoveAsync(long entryId, CancellationToken ct = default);
/// <summary>Entries of an account ordered by publication time, newest first (account tabs, collection pipeline).</summary>
Task<IReadOnlyList<Entry>> ListByAccountAsync(long accountId, EntryListOptions? options = null, CancellationToken ct = default);
/// <summary>Entries of (account, kind) discovered in [from, to): per-account daily backfill limit.</summary>
Task<int> CountDiscoveredAsync(long accountId, EntryKind kind, DateTimeOffset from, DateTimeOffset to, CancellationToken ct = default);
/// <summary>A window of the library mosaic with keyset paging: stays fast over 200,000 entries.</summary>
Task<LibraryPage> QueryLibraryAsync(LibraryQuery query, CancellationToken ct = default);
Task<LibraryTotals> GetLibraryTotalsAsync(LibraryFilter filter, CancellationToken ct = default);
/// <summary>Entries per local calendar day in Alberto's zone, newest day first.</summary>
Task<IReadOnlyList<DayCount>> CountLibraryByDayAsync(LibraryFilter filter, TimeZoneInfo zone, CancellationToken ct = default);
/// <summary>Tiles for given entries, in the given order (e.g. the items of a highlight collection).</summary>
Task<IReadOnlyList<LibraryTile>> GetTilesAsync(IReadOnlyList<long> entryIds, CancellationToken ct = default);
}