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
77 lines
4.8 KiB
C#
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);
|
|
}
|