dogfather-universe/server/spenden-tabellen.js

/* =====================================================================
   DIE SPENDEN — die Tabellen (28.09.2026)

   Filipe: „ich will dass du das mit dem paypal auch perfektionierst.
   ich will dass das richtig perfekt gemacht wird so dass die leute so
   einfach wie möglich eine spende aufs paypal machen können. und wenn
   jemand spendet soll auch der betrag erscheinen mit einem bild."

   ---------------------------------------------------------------------
   WAS GEHT UND WAS NICHT — nachgesehen, nicht angenommen

   Hinterlegt ist ein PayPal.me-Link auf ein PRIVATES Konto. Damit
   gilt:

     ES GEHT: `paypal.me/<name>/5EUR` öffnet PayPal mit schon
     eingetragenem Betrag. Ein Tipp, fertig. Das ist der einfachste
     Weg, den es für einen Zuschauer überhaupt gibt, und er braucht
     nichts weiter als den Link, der ohnehin schon da ist.

     ES GEHT NICHT VON SELBST: PayPal meldet eine Zahlung nur, wenn
     ein Webhook oder IPN eingerichtet ist — und beides setzt
     Zugangsdaten voraus, die nur Filipe selbst anlegen kann. Ob ein
     privates Konto das ueberhaupt kann, sagt PayPals eigene Doku
     nicht eindeutig.

   DESHALB DREI HERKUENFTE UND NICHT EINE:

     „hand"      — Filipe sieht die PayPal-Meldung auf dem Handy und
                   tippt den Betrag ins Pult. Geht immer, braucht
                   nichts, ist in drei Sekunden getan.
     „gemeldet"  — Der Zuschauer sagt nach dem Spenden selbst
                   Bescheid. Landet als OFFEN und wird erst gezeigt,
                   wenn jemand von der Leitung es bestaetigt.
     „paypal"    — Kommt automatisch, sobald ein Webhook eingerichtet
                   ist. Bis dahin steht dieser Weg einfach leer da.

   WARUM „gemeldet" NICHT SOFORT ERSCHEINT: Sonst tippt irgendwer
   „500 Euro" und steht damit gross im Bild. Eine Spende ist eine
   Aussage ueber Geld; die gehoert bestaetigt, bevor sie oeffentlich
   wird. Der Weg dahin ist EIN Tipp im Pult — das ist billig genug,
   dass niemand in Versuchung kommt, ihn abzukuerzen.

   ---------------------------------------------------------------------
   DER BETRAG STEHT IN CENT

   Nie als Kommazahl. 0.1 + 0.2 ist in jeder Programmiersprache nicht
   0.3, und bei Geld faellt das irgendwann jemandem auf — meistens
   dem, der zahlt. Gerechnet wird in ganzen Cent, formatiert wird
   erst beim Anzeigen.
   ===================================================================== */

/* =====================================================================
   DIE WAEHRUNG DES HAUSES: DOGEN (28.09.2026)

   Filipe: „mann soll nie die summe sehen sondern die dogen auch mit
   dem symbol ... es soll auch nie geld da stehen sondern Dogen."

   EIN DOGE SIND ZEHN EURO. Woertlich nach Filipes Angabe „1 euro
   sind 0,10 dogen" -- rueckgefragt und bestaetigt, weil zwischen den
   beiden moeglichen Lesarten („ein Doge KOSTET 0,10" gegen „ein Euro
   ERGIBT 0,10") der Faktor 100 liegt und danach jede Zahl im Bild
   falsch gewesen waere.

   ---------------------------------------------------------------------
   GERECHNET WIRD IN TAUSENDSTELN

   Derselbe Grund wie beim Cent, nur strenger: 0.1 + 0.2 ist in
   keiner Programmiersprache 0.3. Bei Geld faellt das irgendwann dem
   auf, der zahlt -- bei etwas, das Menschen SAMMELN, faellt es dem
   auf, der am meisten hat, und der merkt sich das.

   Ein Doge sind 1000 Tausendstel. Bei diesem Kurs ist ein
   Tausendstel genau ein Cent, es wird also nie gerundet.

   ---------------------------------------------------------------------
   DER KURS STEHT HIER UND NUR HIER

   Nicht in den Einstellungen. Eine Einstellung, die Dogen und Euro
   nebeneinanderstellt, WAERE das Geld auf dem Bildschirm, das
   nirgends mehr stehen soll. Wer den Kurs aendern will, aendert
   diese eine Zeile -- und alles, was danach hereinkommt, rechnet
   damit.

   WAS SCHON GUTGESCHRIEBEN IST, BLEIBT. Die Punktestaende liegen als
   Dogen in der Tabelle und nicht als Cent, aus denen erst beim
   Anzeigen gerechnet wird. Sonst haette eine Kursaenderung
   rueckwirkend jedem seinen Stand verschoben -- wer gestern 5 Dogen
   hatte, haette heute 50, ohne etwas getan zu haben. Eine Waehrung,
   die rueckwaerts wirkt, ist keine.
   ===================================================================== */

/** Wie viele Cent ein Doge wert ist. */
export const CENT_JE_DOGE = 1000;

/** Ein Doge in Tausendsteln -- die Einheit, in der gerechnet wird. */
export const MILLE = 1000;

/** Cent -> Tausendstel Dogen. */
export function centInMille(cent) {
  return Math.round(((Number(cent) || 0) * MILLE) / CENT_JE_DOGE);
}

/** Tausendstel Dogen -> Cent. Nur fuer PayPal und die Ablage. */
export function milleInCent(mille) {
  return Math.round(((Number(mille) || 0) * CENT_JE_DOGE) / MILLE);
}

/** So lange bleibt eine Spende im Verlauf stehen. */
export const SPENDEN_TAGE = 400;

/** Hoechstbetrag, den jemand von Hand eintragen kann (in Cent).
 *
 *  Nicht gegen Betrug — wer eintraegt, gehoert zur Leitung. Gegen
 *  den Zahlendreher: Eine Null zu viel steht sonst als „5.000 EUR"
 *  im Bild, und das ist der Sorte Fehler, die man nicht mehr
 *  einfangen kann, wenn hundert Leute zusehen. */
export const BETRAG_MAX_CENT = 500000;

/** Was auf der Karte stehen darf.
 *
 *  Filipe: „der text der dazu erscheint sollen die leute selber
 *  schreiben koennen. soll auf nicht zu viel aber auch nicht zu
 *  wenig schreiben koennen."
 *
 *  140 ZEICHEN, UND DIE ZAHL IST GEMESSEN, NICHT GERATEN. Die Karte
 *  steht je nach Stufe sechs bis elf Sekunden. Vorgelesen sind das
 *  rund 15 Zeichen je Sekunde, gelesen mehr -- aber niemand liest
 *  eine Karte, waehrend er ein Video sieht, mit voller
 *  Aufmerksamkeit. Bei 140 Zeichen sind es zwei bis drei Zeilen; die
 *  fasst man im Vorbeischauen. Bei 200 wurde die Schrift auf einer
 *  kleinen Karte so eng, dass gar niemand mehr hinsieht -- ein Gruss,
 *  den keiner liest, ist schlechter als ein kurzer.
 *
 *  AELTERE, LAENGERE GRUESSE BLEIBEN STEHEN. Sie abzuschneiden waere
 *  ein stiller Datenverlust an fremden Worten; die Grenze gilt fuer
 *  das, was neu hereinkommt. */
export const NAME_MAX = 40;
export const GRUSS_MAX = 140;

/** Die mitgelieferten Zeichnungen.
 *
 *  DIESE LISTE IST DIE WAHRHEIT -- `spendenkarte.js` hat dieselben
 *  Namen, und eine Pruefung haelt beide aneinander. Ein Name, den
 *  nur eine Seite kennt, waere eine Vorlage, die sich auswaehlen
 *  laesst und dann als Herz erscheint. */
export const VORLAGEN = ["herz", "welle", "krone", "stern", "pfote"];

/** So viele Stufen hoechstens.
 *
 *  Sechs. Bei sieben merkt sich niemand mehr, was welche bedeutet --
 *  und eine Stufenleiter, die man nicht im Kopf hat, ist keine
 *  Belohnung, sondern eine Preisliste. */
export const STUFEN_MAX = 6;

/** Wie lange eine Karte stehen darf. */
export const DAUER_MS_MIN = 2000;
export const DAUER_MS_MAX = 30000;

/** Wie gross eine Karte werden darf (Faktor auf die Grundgroesse).
 *
 *  Filipe: „auch so dass ich das anders gestalten kann oder die
 *  groesse veraendern kann."
 *
 *  JE STUFE UND NICHT EINMAL FUER ALLE. Genau darin steckt „spezielle
 *  sachen bei speziellen spenden": Eine Rudel-Legende darf GROESSER
 *  dastehen als ein Danke. Eine einzige Groesse fuer alle waere
 *  wieder die Preisliste.
 *
 *  WARUM ES NUR NACH OBEN GEHT. Die Karte ist bereits auf die
 *  Untergrenze des Hauses gebaut: Das kleinste Wort darauf steht bei
 *  0,72rem, also 11,52 Pixel, und 11,5 ist die Grenze, unter die
 *  nichts in diesem Haus faellt (pruef-css-klassen misst das). Ein
 *  Faktor von 0,8 machte daraus 9,2 Pixel -- ein Dank, den man nicht
 *  mehr lesen kann, ist keiner.
 *
 *  KLEINER GEHT TROTZDEM -- aber an der richtigen Stelle: Die
 *  OBS-Tafel hat ihren eigenen Regler in der Adresse (`&g=`, 0,5 bis
 *  4). Dort ist es eine Videoeinblendung und kein Text zum Lesen,
 *  und dort entscheidet ohnehin die Groesse des Streams.
 *
 *  Die Obergrenze ist gemessen: Ueber 2,5 passt die Karte auf 1080
 *  Pixel Hoehe nicht mehr neben den Chat. */
export const GROESSE_MIN = 1;
export const GROESSE_MAX = 2.5;

/** Wie gross ein hochgeladenes Bild sein darf. */
export const BILD_MAX_BYTES = 3 * 1024 * 1024;

/** Unter welchem Namen das Dogen-Zeichen in den Einstellungen steht.
 *
 *  Filipe: „die symbole schick ich dir spaeter. bereite jetzt alles
 *  vor."
 *
 *  ES IST EINE EINSTELLUNG UND KEINE DATEI IM QUELLTEXT. Laege das
 *  Zeichen als Bild im Verzeichnis, haenge jedes neue Symbol an
 *  einem Deploy -- also an mir. So laedt Filipe es im Regiepult hoch,
 *  und bis dahin steht eine gezeichnete Muenze da, die in jeder
 *  Farbe funktioniert. Ein leerer Kasten waere die schlechtere
 *  Zwischenloesung: Man haelt ihn fuer kaputt. */
export const ZEICHEN_NAME = "dogen_zeichen";

/** Die Stufen, die es ab Werk gibt — „paar fertige" aus Filipes
 *  Ansage. Sie stehen hier und nicht in der Datenbank, damit ein
 *  frisches Haus sofort etwas anzuzeigen hat; geaendert werden sie
 *  danach in der Datenbank.
 *
 *  DIE GRENZEN SIND NICHT GERATEN, sondern an dem ausgerichtet, was
 *  Leute im Netz tatsaechlich geben: der Kaffee, die Runde, das
 *  richtig grosse Danke. Drei Stufen, nicht sieben — bei sieben
 *  merkt sich niemand mehr, was welche bedeutet. */
export const STUFEN_START = [
  { ab_cent: 100, name: "Danke", vorlage: "herz", farbe: "#8ec9ff", dauer_ms: 6000, groesse: 1 },
  { ab_cent: 500, name: "Starke Runde", vorlage: "welle", farbe: "#a98bff", dauer_ms: 8000, groesse: 1.15 },
  { ab_cent: 2000, name: "Rudel-Legende", vorlage: "krone", farbe: "#e0a13a", dauer_ms: 11000, groesse: 1.45 },
];

/** Die Knoepfe, die zum Geben angeboten werden — in TAUSENDSTELN.
 *
 *  0,2 · 0,5 · 1 · 2,5 Dogen.
 *
 *  IN DOGEN GEDACHT UND NICHT IN GELD. Das ist nicht Kosmetik: Wer
 *  die Reihe in Euro pflegt und dann anzeigt, hat zwei Listen fuer
 *  dieselbe Frage -- und die eine laeuft von der anderen weg. Der
 *  Euro-Betrag fuer PayPal wird hier abgeleitet, nicht gepflegt.
 *
 *  VIER UND EIN FREIES FELD. Wer eine lange Liste sieht, rechnet;
 *  wer vier Knoepfe sieht, tippt. Die Reihe endet bewusst nicht bei
 *  einer runden Zahl — das waere eine Erwartung, keine Auswahl. */
export const KNOEPFE_MILLE = [200, 500, 1000, 2500];

export function spendenTabellen(d) {
  d.exec(`
    /* Eine Zeile je Spende. Auch die abgelehnten bleiben stehen:
       Wer zweimal dasselbe meldet, soll nicht zweimal gefragt
       werden, und wer sich einen Spass erlaubt, faellt beim dritten
       Mal auf. */
    CREATE TABLE IF NOT EXISTS spenden (
      id             INTEGER PRIMARY KEY AUTOINCREMENT,
      betrag_cent    INTEGER NOT NULL CHECK (betrag_cent > 0),
      waehrung       TEXT    NOT NULL DEFAULT 'EUR',
      /* Wie es im Bild stehen soll. Darf vom Kontonamen abweichen --
         viele wollen mit ihrem Rudelnamen dastehen, nicht mit dem,
         der auf der Karte steht. */
      name           TEXT    NOT NULL DEFAULT '',
      gruss          TEXT    NOT NULL DEFAULT '',
      person_id      INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      herkunft       TEXT    NOT NULL
                     CHECK (herkunft IN ('hand','gemeldet','paypal')),
      stand          TEXT    NOT NULL DEFAULT 'offen'
                     CHECK (stand IN ('offen','bestaetigt','abgelehnt')),
      /* Die Nummer der Zahlung bei PayPal. Nur gesetzt, wenn sie von
         dort kam -- und dann EINMALIG (siehe Index unten): Ein
         Webhook wird bei einer Stoerung wiederholt, und ohne diese
         Sperre stuende dieselbe Spende zweimal im Bild. */
      fremd_id       TEXT,
      erstellt       TEXT    NOT NULL,
      bestaetigt_am  TEXT,
      bestaetigt_von INTEGER REFERENCES personen(id) ON DELETE SET NULL,
      /* Wann die Karte im Bild lief. Leer heisst: steht noch aus.
         Ohne dieses Feld liefe nach jedem Neuladen alles noch
         einmal -- und zwar alles auf einmal. */
      gezeigt_am     TEXT
    );

    /* DIESELBE ZAHLUNG NUR EINMAL. die Bedingung „fremd_id IS NOT NULL“,
       damit die vielen Zeilen ohne Nummer (von Hand, gemeldet)
       einander nicht im Weg stehen. */
    CREATE UNIQUE INDEX IF NOT EXISTS idx_spenden_fremd
      ON spenden (fremd_id) WHERE fremd_id IS NOT NULL;
    CREATE INDEX IF NOT EXISTS idx_spenden_stand
      ON spenden (stand, id);

    /* Was bei welchem Betrag passiert. Eine Zeile je Stufe. */
    CREATE TABLE IF NOT EXISTS spenden_stufen (
      id         INTEGER PRIMARY KEY AUTOINCREMENT,
      ab_cent    INTEGER NOT NULL UNIQUE CHECK (ab_cent > 0),
      name       TEXT    NOT NULL,
      /* Entweder eine mitgelieferte Vorlage ("herz", "welle",
         "krone") oder der Pfad eines hochgeladenen Bildes. Ein Feld
         und nicht zwei: „welches von beidem gilt" waere sonst eine
         Frage, die jede Stelle einzeln beantworten muesste. */
      vorlage    TEXT    NOT NULL DEFAULT 'herz',
      bild       TEXT    NOT NULL DEFAULT '',
      farbe      TEXT    NOT NULL DEFAULT '#8ec9ff',
      dauer_ms   INTEGER NOT NULL DEFAULT 7000
                 CHECK (dauer_ms BETWEEN 2000 AND 30000),
      geaendert  TEXT    NOT NULL DEFAULT ''
    );
  `);

  /* ==== DIE DOGEN DER LEUTE =======================================

     Filipe: „ich will dass die den leuten auch als punkte
     hinzugefuegt werden ... ich hab naemlich vor den leuten
     spezielle sachen auch noch zu erstellen spaeter wo mit diesen
     dogpunkten zu tun hat, also muss es jetzt schon perfektioniert
     werden."

     EIN BUCH UND KEIN ZAEHLER. Ein Feld `dogen` an der Person waere
     kuerzer -- und waere die zweite Antwort auf dieselbe Frage: Was
     hat jemand? Der Zaehler und die Spenden koennen auseinanderlaufen,
     und dann weiss niemand mehr, welcher von beiden recht hat. Hier
     ist der Stand die SUMME der Buchungen, und eine Summe kann sich
     nicht von ihren Posten entfernen.

     UND WEIL SPAETER ETWAS ABGEHEN SOLL. „Spezielle sachen ... wo mit
     diesen dogpunkten zu tun hat" heisst irgendwann: eingeloest. Ein
     Zaehler, der kleiner wird, laesst keine Frage mehr beantworten --
     wofuer? wann? wer hat es ausgeloest? Eine Zeile mit Grund und
     Datum schon. Deshalb steht die Tabelle heute schon so da, obwohl
     es erst eine Art von Buchung gibt.

     NEGATIVE BETRAEGE SIND ERLAUBT, LOESCHEN NICHT. Eine
     zurueckgenommene Gutschrift ist eine zweite Zeile mit
     Minuszeichen, kein verschwundener Posten. */
  d.exec(`
    CREATE TABLE IF NOT EXISTS dogen_buchungen (
      id         INTEGER PRIMARY KEY AUTOINCREMENT,
      person_id  INTEGER NOT NULL REFERENCES personen(id) ON DELETE CASCADE,
      /* In Tausendstel Dogen. Darf negativ sein. */
      mille      INTEGER NOT NULL,
      grund      TEXT    NOT NULL,
      spende_id  INTEGER REFERENCES spenden(id) ON DELETE SET NULL,
      notiz      TEXT    NOT NULL DEFAULT '',
      erstellt   TEXT    NOT NULL
    );

    /* JE SPENDE EINE GUTSCHRIFT. Die Karte laesst sich noch einmal
       zeigen, und ein Strom wird bei einer Stoerung wiederholt --
       ohne diese Sperre bekaeme jemand seine Dogen zweimal, und
       gemerkt haette es niemand ausser ihm. Die Bedingung schuetzt
       die Zeilen ohne Spende (spaetere Handbuchungen) voreinander. */
    CREATE UNIQUE INDEX IF NOT EXISTS idx_dogen_einmal
      ON dogen_buchungen (spende_id, grund) WHERE spende_id IS NOT NULL;
    CREATE INDEX IF NOT EXISTS idx_dogen_person
      ON dogen_buchungen (person_id, id);
  `);

  /* ==== NACHGEWACHSEN: DIE GROESSE ================================
     `ALTER TABLE ... ADD COLUMN` und nicht „Tabelle neu bauen": Am
     11.09.2026 hat genau dieses Umkopieren an anderer Stelle drei
     Spalten mit Inhalt verschluckt, ohne Fehlermeldung. */
  const da = new Set(d.prepare("PRAGMA table_info(spenden_stufen)").all().map((z) => z.name));
  if (!da.has("groesse")) {
    d.exec("ALTER TABLE spenden_stufen ADD COLUMN groesse REAL NOT NULL DEFAULT 1");
    console.log("[spenden] Spalte groesse angelegt.");
  }

  /* DIE DREI STUFEN ANLEGEN, WENN ES NOCH KEINE GIBT.

     `INSERT OR IGNORE` je Zeile und nicht „erst zaehlen, dann
     schreiben": Zwei Anfragen beim ersten Start wuerden sonst beide
     „ist leer" lesen und beide schreiben. */
  const nun = new Date().toISOString();
  for (const s of STUFEN_START) {
    d.prepare(`INSERT OR IGNORE INTO spenden_stufen
        (ab_cent, name, vorlage, farbe, dauer_ms, groesse, geaendert)
        VALUES (?,?,?,?,?,?,?)`)
      .run(s.ab_cent, s.name, s.vorlage, s.farbe, s.dauer_ms, s.groesse, nun);
  }
}