Die Umbenennung von Gruppen in "Kategorien" war falsch: Es sind zwei
verschiedene Dinge. Sie ist zurueckgenommen, Kategorien kommen als eigene Ebene
dazu.
GRUPPE zaehlt Bestaende mehrerer Marken zusammen - Mehl von Rewe, Aldi und
Migros ergeben "5 kg Mehl". Dafuer Mindestbestand mit Einheit und EAN-Codes.
KATEGORIE ordnet allein die Artikelliste ("zeig mir alle Suesswaren"), ist
verschachtelbar wie ein Lagerort und hat weder Bestand noch EAN-Codes. Ein
Artikel kann beides, eines oder keines haben.
Die Vermischung war aelter als die Umbenennung: guessGroup in offUtils.js hat
aus der Open-Food-Facts-KATEGORIE eine GRUPPE geraten. Das ist entfernt. Die
OFF-Einordnung steuert jetzt die Kategorie, wo sie hingehoert; eine Gruppe
entsteht nur ueber einen hinterlegten Gruppen-Code oder bewusste Auswahl.
EAN-Codes an der Gruppe: Das war kein Anzeigefehler. Beim Anlegen eines Artikels
wurde ausschliesslich group_id gesetzt - ein Gruppen-Code entstand nie, die
Liste war tatsaechlich leer. Die Meldung "bereits vergeben" kam daher, dass der
Code am Artikel hing. Jetzt pflegt services/group_codes.py den Code mit: beim
Zuordnen kommt er hinzu, beim Gruppenwechsel wandert er mit, beim Entfernen der
Gruppe oder Loeschen des Artikels verschwindet er. Beim Scannen aendert sich
nichts an der Reihenfolge - der Artikel wird weiterhin zuerst gefunden; der
Gruppen-Eintrag ist Beleg in der Verwaltung und Rueckfall. Traegt man denselben
Code von Hand nach, ist das kein Fehler mehr, sondern die Auskunft, dass er ueber
den Artikel bereits dort steht.
Kategorien im Backend: neue Tabelle mit parent_id (Muster von Location),
products.category_id per ADD COLUMN IF NOT EXISTS nachgezogen, deutsche
zweistufige Startliste analog zu den eingebauten Einheiten. Die Startliste wird
nur angelegt, wenn ueberhaupt noch keine Kategorie existiert - wer sie bewusst
leerraeumt, findet sie nicht wieder. Beim Setzen einer Oberkategorie wird
geprueft, dass keine Kategorie sich selbst oder einem eigenen Nachfahren
untergeordnet wird; sonst entstuende ein Ring und jede Baumdarstellung liefe
endlos. Der Produktfilter schliesst Unterkategorien ein, category_id=0 liefert
die Artikel ohne Kategorie. Export und Import fuehren die Kategorie als Pfad
("Suesswaren & Snacks > Schokolade") in einer Spalte, damit die CSV in Excel
bedienbar bleibt.
Web: neue Seite Kategorien mit Baumdarstellung, Filter ueber der Produktliste,
getrennte Auswahlfelder im Produktformular mit je einer Zeile Erklaerung, und
beim Einlagern laesst sich eine Gruppe samt Einheit und Mindestbestand direkt
anlegen, ohne den Vorgang zu verlassen.
iOS: Kategorie-Filter ueber der Produktliste, Unterkategorien eingerueckt. Die
Artikelzeile nennt jetzt das Gebinde und warnt, wenn der Mindestbestand
unterschritten ist (rot) oder weniger als ein Viertel Luft bleibt (orange).
Getrennte Auswahlfelder fuer Kategorie und Gruppe, Gruppe direkt anlegbar.
Ausserdem die Eingabefelder in der App: .textFieldStyle(.roundedBorder) zeichnet
in der dunklen Darstellung einen fast schwarzen Kasten. Ersetzt durch eine
Systemfuellung, die sich Hell und Dunkel anpasst und zurueckhaltend bleibt.
Getestet: 54 pytest-Tests gruen, 14 davon neu (Nachfahren-Sammler, OFF-Zuordnung
inklusive Vorrang der Unterkategorie, und die komplette Codepflege an der
Gruppe). Gegen die laufende API geprueft: Startliste ohne Dubletten, Filter auf
Ober- und Unterkategorie, Ringschutz, Loeschen einer Kategorie laesst Artikel
und Unterkategorien bestehen, Export/Import-Rundlauf mit Kategoriepfad, und der
Durchlauf aus der Meldung - Artikel mit Gruppe anlegen, Code steht danach in der
Gruppe. Web-Build und iOS-Geraetebuild fehler- und warnungsfrei.
Die Oberflaechen habe ich nicht selbst bedient.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
419 lines
12 KiB
Swift
419 lines
12 KiB
Swift
import Foundation
|
|
|
|
// Entspricht den Schemas des Backends (backend/app/schemas.py).
|
|
|
|
struct TokenResponse: Codable {
|
|
let accessToken: String
|
|
let role: String
|
|
let username: String
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case accessToken = "access_token"
|
|
case role, username
|
|
}
|
|
}
|
|
|
|
struct MeResponse: Codable {
|
|
let id: Int
|
|
let username: String
|
|
let role: String
|
|
|
|
var isAdmin: Bool { role == "admin" }
|
|
}
|
|
|
|
struct Unit: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let name: String
|
|
let kind: String
|
|
let factor: Double
|
|
}
|
|
|
|
struct BarcodeEntry: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let code: String
|
|
let note: String?
|
|
}
|
|
|
|
struct Product: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let barcode: String?
|
|
let name: String
|
|
let brand: String?
|
|
let imageUrl: String?
|
|
let baseUnit: String
|
|
let packageSize: Double?
|
|
let packageLabel: String?
|
|
let groupId: Int?
|
|
let minStock: Double?
|
|
let stock: Double
|
|
let expiredCount: Int
|
|
let kind: String
|
|
let unitName: String
|
|
let unitFactor: Double
|
|
let barcodes: [BarcodeEntry]
|
|
/// Welche MHD-Genauigkeit bei diesem Produkt ueblich ist ("day"/"month").
|
|
let datePrecision: String?
|
|
/// Kategorie: reine Ordnungshilfe fuer die Artikelliste (nicht die Gruppe).
|
|
let categoryId: Int?
|
|
let categoryName: String?
|
|
/// Mindestbestand in der erfassten Einheit, fuer die Anzeige.
|
|
let minStockDisplay: Double?
|
|
let minStockUnitLabel: String?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case id, barcode, name, brand, stock, kind, barcodes
|
|
case datePrecision = "date_precision"
|
|
case categoryId = "category_id"
|
|
case categoryName = "category_name"
|
|
case minStockDisplay = "min_stock_display"
|
|
case minStockUnitLabel = "min_stock_unit_label"
|
|
case imageUrl = "image_url"
|
|
case baseUnit = "base_unit"
|
|
case packageSize = "package_size"
|
|
case packageLabel = "package_label"
|
|
case groupId = "group_id"
|
|
case minStock = "min_stock"
|
|
case expiredCount = "expired_count"
|
|
case unitName = "unit_name"
|
|
case unitFactor = "unit_factor"
|
|
}
|
|
|
|
/// Bezeichnung der Artikeleinheit (Gebinde, sonst Produkteinheit).
|
|
var articleUnitLabel: String {
|
|
if let size = packageSize, size > 0 { return packageLabel ?? "Packung" }
|
|
return unitName
|
|
}
|
|
|
|
/// Faktor, um Basiseinheiten in Artikeleinheiten umzurechnen.
|
|
var articleUnitFactor: Double {
|
|
if let size = packageSize, size > 0 { return size }
|
|
return unitFactor == 0 ? 1 : unitFactor
|
|
}
|
|
|
|
var stockInArticleUnits: Double { stock / articleUnitFactor }
|
|
|
|
/// Wie es um den Mindestbestand steht. Beides in Basiseinheiten verglichen.
|
|
enum StockLevel { case none, ok, close, below }
|
|
|
|
var stockLevel: StockLevel {
|
|
guard let minimum = minStock, minimum > 0 else { return .none }
|
|
if stock < minimum { return .below }
|
|
// Weniger als ein Viertel Luft: bald nachkaufen.
|
|
return stock < minimum * 1.25 ? .close : .ok
|
|
}
|
|
}
|
|
|
|
/// Auswahleintrag fuer Einheiten.
|
|
///
|
|
/// Anzeige und uebertragener Wert sind bewusst getrennt: Das Backend kennt
|
|
/// fuer das Gebinde nur das Schluesselwort "package" (siehe
|
|
/// services/conversion.py). Die Bezeichnung "Glas" oder "Dose" ist reine
|
|
/// Anzeige - wird sie mitgeschickt, antwortet der Server
|
|
/// "Unbekannte Einheit: Glas".
|
|
struct UnitOption: Hashable, Identifiable {
|
|
let value: String
|
|
let label: String
|
|
var id: String { value }
|
|
|
|
static let packageValue = "package"
|
|
}
|
|
|
|
struct LookupResult: Codable {
|
|
let found: Bool
|
|
let existingProduct: Product?
|
|
let suggestion: Suggestion?
|
|
/// Gruppe: nur gesetzt, wenn der Code dort ausdruecklich hinterlegt ist.
|
|
let groupId: Int?
|
|
let groupName: String?
|
|
/// Kategorie: aus der Open-Food-Facts-Einordnung vorgeschlagen.
|
|
let categoryId: Int?
|
|
let categoryName: String?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case found, suggestion
|
|
case existingProduct = "existing_product"
|
|
case groupId = "group_id"
|
|
case groupName = "group_name"
|
|
case categoryId = "category_id"
|
|
case categoryName = "category_name"
|
|
}
|
|
|
|
struct Suggestion: Codable {
|
|
let barcode: String?
|
|
let name: String
|
|
let brand: String?
|
|
let imageUrl: String?
|
|
let baseUnit: String?
|
|
let packageSize: Double?
|
|
let quantityText: String?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case barcode, name, brand
|
|
case imageUrl = "image_url"
|
|
case baseUnit = "base_unit"
|
|
case packageSize = "package_size"
|
|
case quantityText = "quantity_text"
|
|
}
|
|
}
|
|
}
|
|
|
|
struct Lot: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let productId: Int
|
|
let quantity: Double
|
|
let bestBefore: String?
|
|
let bestBeforePrecision: String?
|
|
let locationId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case id, quantity
|
|
case productId = "product_id"
|
|
case bestBefore = "best_before"
|
|
case bestBeforePrecision = "best_before_precision"
|
|
case locationId = "location_id"
|
|
}
|
|
}
|
|
|
|
struct StorageLocation: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let name: String
|
|
let parentId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case id, name
|
|
case parentId = "parent_id"
|
|
}
|
|
}
|
|
|
|
struct CheckInLine: Codable {
|
|
let quantity: Double
|
|
let bestBefore: String?
|
|
let bestBeforePrecision: String
|
|
let locationId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case quantity
|
|
case bestBefore = "best_before"
|
|
case bestBeforePrecision = "best_before_precision"
|
|
case locationId = "location_id"
|
|
}
|
|
}
|
|
|
|
struct BatchCheckInRequest: Codable {
|
|
let productId: Int
|
|
let unit: String
|
|
let lines: [CheckInLine]
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case unit, lines
|
|
case productId = "product_id"
|
|
}
|
|
}
|
|
|
|
struct CheckOutRequest: Codable {
|
|
let productId: Int
|
|
let quantity: Double
|
|
let unit: String
|
|
let lotId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case quantity, unit
|
|
case productId = "product_id"
|
|
case lotId = "lot_id"
|
|
}
|
|
}
|
|
|
|
struct StockResponse: Codable {
|
|
let productStock: Double
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case productStock = "product_stock"
|
|
}
|
|
}
|
|
|
|
struct NewProductRequest: Codable {
|
|
let barcode: String?
|
|
let name: String
|
|
let brand: String?
|
|
let imageUrl: String?
|
|
let baseUnit: String
|
|
let packageSize: Double?
|
|
let packageLabel: String?
|
|
let datePrecision: String
|
|
let groupId: Int?
|
|
let categoryId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case barcode, name, brand
|
|
case imageUrl = "image_url"
|
|
case baseUnit = "base_unit"
|
|
case packageSize = "package_size"
|
|
case packageLabel = "package_label"
|
|
case datePrecision = "date_precision"
|
|
case groupId = "group_id"
|
|
case categoryId = "category_id"
|
|
}
|
|
}
|
|
|
|
// MARK: - Listen (Einkaufsliste, bald ablaufend)
|
|
|
|
struct ShoppingItem: Codable, Identifiable {
|
|
let productId: Int
|
|
let name: String
|
|
let baseUnit: String
|
|
let packageSize: Double?
|
|
let stock: Double
|
|
let minStock: Double
|
|
let deficit: Double
|
|
|
|
var id: Int { productId }
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case name, stock, deficit
|
|
case productId = "product_id"
|
|
case baseUnit = "base_unit"
|
|
case packageSize = "package_size"
|
|
case minStock = "min_stock"
|
|
}
|
|
}
|
|
|
|
struct GroupShoppingItem: Codable, Identifiable {
|
|
let groupId: Int
|
|
let name: String
|
|
let stock: Double
|
|
let minStock: Double
|
|
let deficit: Double
|
|
let unitName: String
|
|
let productCount: Int
|
|
|
|
var id: Int { groupId }
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case name, stock, deficit
|
|
case groupId = "group_id"
|
|
case minStock = "min_stock"
|
|
case unitName = "unit_name"
|
|
case productCount = "product_count"
|
|
}
|
|
}
|
|
|
|
struct ExpiringItem: Codable, Identifiable {
|
|
let lotId: Int
|
|
let productId: Int
|
|
let productName: String
|
|
let quantity: Double
|
|
let baseUnit: String
|
|
let bestBefore: String
|
|
let bestBeforePrecision: String?
|
|
let daysLeft: Int
|
|
let packageSize: Double?
|
|
let packageLabel: String?
|
|
let unitName: String
|
|
let unitFactor: Double
|
|
|
|
var id: Int { lotId }
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case quantity
|
|
case lotId = "lot_id"
|
|
case productId = "product_id"
|
|
case productName = "product_name"
|
|
case baseUnit = "base_unit"
|
|
case bestBefore = "best_before"
|
|
case bestBeforePrecision = "best_before_precision"
|
|
case daysLeft = "days_left"
|
|
case packageSize = "package_size"
|
|
case packageLabel = "package_label"
|
|
case unitName = "unit_name"
|
|
case unitFactor = "unit_factor"
|
|
}
|
|
}
|
|
|
|
// MARK: - Aenderungen
|
|
|
|
/// Die Felder, die das Produktformular der App besitzt (PATCH).
|
|
///
|
|
/// Bewusst mit eigener Kodierung: Swift laesst `nil`-Optionals sonst einfach
|
|
/// weg, und das Backend wertet nur mitgeschickte Felder aus. Leeren waere damit
|
|
/// unmoeglich - "keine Kategorie" oder eine geloeschte Marke wuerden stumm
|
|
/// verpuffen. Felder, die die App nicht bearbeitet (etwa der Mindestbestand),
|
|
/// stehen deshalb gar nicht erst hier drin.
|
|
struct ProductUpdateRequest: Encodable {
|
|
var name: String?
|
|
var brand: String?
|
|
var packageSize: Double?
|
|
var packageLabel: String?
|
|
var datePrecision: String?
|
|
var groupId: Int?
|
|
var categoryId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case name, brand
|
|
case packageSize = "package_size"
|
|
case packageLabel = "package_label"
|
|
case datePrecision = "date_precision"
|
|
case groupId = "group_id"
|
|
case categoryId = "category_id"
|
|
}
|
|
|
|
func encode(to encoder: Encoder) throws {
|
|
var container = encoder.container(keyedBy: CodingKeys.self)
|
|
try container.encode(name, forKey: .name)
|
|
try container.encode(brand, forKey: .brand)
|
|
try container.encode(packageSize, forKey: .packageSize)
|
|
try container.encode(packageLabel, forKey: .packageLabel)
|
|
try container.encode(datePrecision, forKey: .datePrecision)
|
|
try container.encode(groupId, forKey: .groupId)
|
|
try container.encode(categoryId, forKey: .categoryId)
|
|
}
|
|
}
|
|
|
|
struct LotUpdateRequest: Codable {
|
|
var quantity: Double?
|
|
var bestBefore: String?
|
|
var bestBeforePrecision: String?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case quantity
|
|
case bestBefore = "best_before"
|
|
case bestBeforePrecision = "best_before_precision"
|
|
}
|
|
}
|
|
|
|
/// Ein Eintrag aus /settings (Schluessel/Wert).
|
|
struct SettingEntry: Codable {
|
|
let key: String
|
|
let value: String
|
|
}
|
|
|
|
/// Gruppe: fasst Bestaende mehrerer Marken zusammen (z.B. "Mehl").
|
|
struct GroupItem: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let name: String
|
|
}
|
|
|
|
/// Kategorie: ordnet nur die Artikelliste, verschachtelbar (Suesswaren -> Schokolade).
|
|
struct CategoryItem: Codable, Identifiable, Hashable {
|
|
let id: Int
|
|
let name: String
|
|
let parentId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case id, name
|
|
case parentId = "parent_id"
|
|
}
|
|
}
|
|
|
|
/// Neue Gruppe anlegen (nur fuer Administratoren).
|
|
struct NewGroupRequest: Codable {
|
|
let name: String
|
|
let minStock: Double?
|
|
let minStockUnitId: Int?
|
|
|
|
enum CodingKeys: String, CodingKey {
|
|
case name
|
|
case minStock = "min_stock"
|
|
case minStockUnitId = "min_stock_unit_id"
|
|
}
|
|
}
|