tane/apps/app_seeds/lib/db/tables.dart

import 'package:drift/drift.dart';

import 'enums.dart';
import 'sync_columns.dart';

/// The identity/accession — one row per distinct thing in the inventory.
/// Only [label] is mandatory (progressive disclosure).
class Varieties extends Table with SyncColumns {
  TextColumn get label => text()();
  TextColumn get speciesId => text().nullable()(); // → Species
  TextColumn get cultivarName => text().nullable()();
  TextColumn get category =>
      text().nullable()(); // free text, prefilled from family
  TextColumn get notes => text().nullable()();

  /// A draft captured photo-first ("capture now, catalogue later"): it holds a
  /// photo but not yet a real name, and lives in the "to catalogue" tray until
  /// the user labels it. A plain LWW scalar, so it merges like any other field.
  BoolColumn get isDraft => boolean().withDefault(const Constant(false))();

  /// Grower-declared organic ("eco") provenance. A self-declaration, not a
  /// third-party certification (that would be a separate flag). Surfaced as a
  /// badge and an inventory filter. A plain LWW scalar.
  BoolColumn get isOrganic => boolean().withDefault(const Constant(false))();

  /// A stewardship intent set by the grower: "regrow this variety this season"
  /// before its stock or vitality runs out. Complements the automatic viability
  /// warning (which is age-derived) with an explicit human decision. Surfaced
  /// as a badge and an inventory filter. A plain LWW scalar.
  BoolColumn get needsReproduction =>
      boolean().withDefault(const Constant(false))();

  /// Advisory crop-calendar months, typical for this variety — when to sow,
  /// transplant, expect flowers/fruit, and harvest seed. Each phase usually
  /// spans several months (e.g. sow in spring *and* autumn), so each is a set
  /// of months packed as a 12-bit mask (see `domain/crop_calendar.dart`), an
  /// optional LWW scalar; null means "not recorded". Guidance, not a per-year
  /// actuals log (that path stays available via Movements).
  IntColumn get sowMonths => integer().nullable()();
  IntColumn get transplantMonths => integer().nullable()();
  IntColumn get floweringMonths => integer().nullable()();
  IntColumn get fruitingMonths => integer().nullable()();
  IntColumn get seedHarvestMonths => integer().nullable()();
}

/// The multiple common names of a Variety (separate table so concurrent adds
/// merge as a set).
class VarietyVernacularNames extends Table with SyncColumns {
  TextColumn get varietyId => text()();
  TextColumn get name => text()();
  TextColumn get language => text().nullable()();
  TextColumn get region => text().nullable()();
}

/// Bundled, mostly read-only name catalog (Wikidata CC0 + GBIF CC-BY).
class Species extends Table with SyncColumns {
  TextColumn get scientificName => text()();
  TextColumn get wikidataQid => text().nullable()();
  IntColumn get gbifKey => integer().nullable()();
  TextColumn get family => text().nullable()();
  BoolColumn get isBundled => boolean().withDefault(const Constant(false))();

  /// Typical seed longevity in years under normal home storage — public-domain
  /// reference data bundled with the catalog (agricultural-extension viability
  /// tables). Drives the "expiring / past viability" warning on aging lots by
  /// comparing against a lot's [Lots.harvestYear]. Nullable: unknown for
  /// species without a bundled figure.
  IntColumn get viabilityYears => integer().nullable()();
}

/// Localized common names for the catalog (bundled).
class SpeciesCommonNames extends Table with SyncColumns {
  TextColumn get speciesId => text()();
  TextColumn get name => text()();
  TextColumn get language => text().nullable()();
}

/// A homogeneous batch held for a Variety — its own year and its own unit.
/// Quantity (commons_core value type) is flattened into columns here.
class Lots extends Table with SyncColumns {
  TextColumn get varietyId => text()();
  TextColumn get type =>
      textEnum<LotType>().withDefault(const Constant('seed'))();
  IntColumn get harvestYear => integer().nullable()();
  IntColumn get harvestMonth => integer().nullable()(); // 1..12, optional
  TextColumn get quantityKind => text().nullable()(); // QuantityKind.name
  RealColumn get quantityPrecise => real().nullable()();
  TextColumn get quantityLabel => text().nullable()();
  // How living (non-seed) material is packaged; null for seed lots or unset.
  TextColumn get presentation => textEnum<Presentation>().nullable()();
  TextColumn get storageLocation => text().nullable()();
  TextColumn get offerStatus =>
      textEnum<OfferStatus>().withDefault(const Constant('private'))();
  TextColumn get seedbankId => text().nullable()();

  /// Provenance of this batch, kept as lightweight free text so it needs no
  /// Party/Movement to record (the rigorous exchange path stays via Movements).
  /// [originName] = who grew or gave the seeds; [originPlace] = where they come
  /// from (with region/province). Both optional LWW scalars.
  TextColumn get originName => text().nullable()();
  TextColumn get originPlace => text().nullable()();

  /// Optional coarse "how much I have" for this lot — see [Abundance]. An
  /// offline alternative to the precise Quantity columns; either, both, or
  /// neither may be set.
  TextColumn get abundance => textEnum<Abundance>().nullable()();

  /// How the (seed) lot is physically conserved — see [PreservationFormat].
  /// Distinct from [storageLocation]. Optional.
  TextColumn get preservationFormat =>
      textEnum<PreservationFormat>().nullable()();
}

/// Optional germination history for a Lot; percent is derived in code.
class GerminationTests extends Table with SyncColumns {
  TextColumn get lotId => text()();
  IntColumn get testedOn => integer().nullable()(); // date, ms since epoch
  IntColumn get sampleSize => integer().nullable()();
  IntColumn get germinatedCount => integer().nullable()();
  TextColumn get notes => text().nullable()();
}

/// Optional storage-condition history for a seed Lot: periodic physical checks
/// of how many containers hold it and the state of the drying agent. Mirrors
/// [GerminationTests] — a dated log under a Lot, newest shown first.
class ConditionChecks extends Table with SyncColumns {
  TextColumn get lotId => text()();
  IntColumn get checkedOn => integer().nullable()(); // date, ms since epoch
  IntColumn get containerCount => integer().nullable()(); // "botes"
  TextColumn get desiccantState => textEnum<DesiccantState>().nullable()();
  TextColumn get notes => text().nullable()();
}

/// The append-only event log on a Lot — history + provenance DAG.
class Movements extends Table with AppendOnlyColumns {
  TextColumn get lotId => text()();
  TextColumn get type => textEnum<MovementType>()();
  IntColumn get occurredOn => integer().nullable()(); // date, ms since epoch
  TextColumn get counterpartyId => text().nullable()(); // → Party
  TextColumn get quantityKind => text().nullable()();
  RealColumn get quantityPrecise => real().nullable()();
  TextColumn get quantityLabel => text().nullable()();
  TextColumn get parentMovementId => text().nullable()(); // provenance DAG
  TextColumn get plantareId => text().nullable()(); // reserved (social layer)
  TextColumn get notes => text().nullable()();
}

/// A person or collective you exchange with.
class Parties extends Table with SyncColumns {
  TextColumn get displayName => text()();
  TextColumn get publicKey => text().nullable()();
  TextColumn get kind =>
      textEnum<PartyKind>().withDefault(const Constant('person'))();
  TextColumn get note => text().nullable()();
}

/// Photos/docs. Polymorphic parent. Photo bytes are stored in-DB (encrypted at
/// rest by SQLCipher) via [bytes]; external files use [uri]. Storing bytes here
/// keeps the "no plaintext at rest" rule for photos in Block 1; an external
/// encrypted file store is a later optimization.
class Attachments extends Table with SyncColumns {
  TextColumn get parentType => textEnum<ParentType>()();
  TextColumn get parentId => text()();
  TextColumn get kind => textEnum<AttachmentKind>()();
  TextColumn get uri => text().nullable()();
  BlobColumn get bytes => blob().nullable()();
  TextColumn get mimeType => text().nullable()();

  /// Display order among sibling attachments (lower first). The lowest-ordered
  /// photo is the "preferred"/cover — used as the variety avatar and shown
  /// first. New photos append at the end; "set as cover" moves one to the
  /// front. A plain int (not a bool flag) so it generalizes to full reordering.
  IntColumn get sortOrder => integer().withDefault(const Constant(0))();
}

/// A Plantare — a REPRODUCTION commitment (data-model §2.7), the seed-domain
/// name for the generic `Pledge` (`return_kind = similar`). Seed changes hands
/// and the receiver promises to grow it out and return some. NOT a sale.
///
/// Local-first v1: your own honest ledger of commitments (from/to a person by
/// name). The bilateral, cryptographically SIGNED, cross-party form
/// (debtor/creditor keys + both signatures, tied to a shared `Movement`) is a
/// later social-layer phase — those columns are deferred, not invented now.
class Plantares extends Table with SyncColumns {
  /// The seed the commitment is about — what gets reproduced. Nullable so a
  /// commitment can be jotted before it's linked to a catalogued variety.
  TextColumn get varietyId => text().nullable()(); // → Variety

  /// Whose promise it is (I return / owed to me).
  TextColumn get direction => textEnum<PlantareDirection>()();

  /// The other party as a human name (v1). A key/Party link arrives with the
  /// signed cross-party form.
  TextColumn get counterparty => text().nullable()();

  /// What's promised back, in the grower's own words
  /// ("un puñado la próxima temporada").
  TextColumn get owedDescription => text().nullable()();

  /// When the promise was made (ms since epoch).
  IntColumn get madeOn => integer()();

  /// Optional return-by date (ms since epoch) — a gentle reminder, not a deadline.
  IntColumn get dueBy => integer().nullable()();

  TextColumn get status =>
      textEnum<PlantareStatus>().withDefault(const Constant('open'))();

  /// When it was returned or forgiven (ms since epoch).
  IntColumn get settledOn => integer().nullable()();

  TextColumn get note => text().nullable()();
}

/// Any pasted URL (Wikipedia, forum…). Polymorphic parent.
class ExternalLinks extends Table with SyncColumns {
  TextColumn get parentType => textEnum<ParentType>()();
  TextColumn get parentId => text()();
  TextColumn get url => text()();
  TextColumn get title => text().nullable()();
}