/**
 * Die Adressen, die aus dem Programm herausfuehren - an EINER Stelle.
 *
 * Sie stehen hier und nicht im Hauptprozess, weil beide Seiten sie brauchen,
 * aber zu verschiedenem: Der Hauptprozess OEFFNET sie, die Oberflaeche NENNT
 * eine davon im Text. Artikel 3 der EUPL verlangt, dass der Vermerk auf den
 * Quellcode lesbar dasteht - also muss die Oberflaeche die Adresse kennen.
 * Stuende sie dort ein zweites Mal, liefen beide Staende auseinander, und eine
 * falsche Adresse waere schlimmer als keine.
 *
 * DASS DIE OBERFLAECHE SIE KENNT, IST KEIN SICHERHEITSPROBLEM. Der Kanal
 * `IPC.oeffneVerweis` nimmt einen SCHLUESSEL entgegen und keine Adresse; was
 * geoeffnet wird, entscheidet allein der Hauptprozess anhand dieser Tafel. Der
 * Unterschied ist der springende Punkt: Die Oberflaeche darf die Adresse
 * lesen, aber nicht bestimmen. Naehme der Kanal eine Adresse entgegen, koennte
 * ueber jeden Weg, der Projektdaten in die Oberflaeche traegt, eine fremde
 * Datei bestimmen, was `shell.openExternal` startet - und genau so liess sich
 * im Altbestand beliebiger Kode ausfuehren.
 *
 * KEINE VERFOLGUNGSPARAMETER, keine Kennung, kein `?ref=`. Wer einen dieser
 * Verweise anklickt, teilt dem Ziel nichts mit, das er nicht ohnehin mitteilte,
 * indem er die Adresse eintippt. Bewacht von
 * `tests/tools/verweiseNachDraussen.test.ts`.
 */

import type { Verweisziel } from './ipc';

export const VERWEISADRESSEN: Readonly<Record<Verweisziel, string>> = {
  /**
   * Die Seite des Programms - dieselbe wie im Hilfemenue: seine Akte auf der
   * Internetseite des Herausgebers, mit Fassung, Paketen, Lizenz, Quelltext
   * und Datenschutzhinweisen. Seit 5.43.1.
   */
  internetseite: 'https://olaf-willerding.de/projekte/lsa-planer-professional',
  /**
   * Der Quellcode. Artikel 3 der EUPL verlangt bei der Weitergabe von
   * ausfuehrbarem Kode entweder den Quellcode selbst oder einen Vermerk auf
   * einen Speicherort. Der Vermerk steht im "Über"-Fenster, im Abschnitt
   * "Rechtliches" der README und in QUELLCODE.txt neben der Programmdatei -
   * und alle drei nennen DIESE Adresse.
   */
  quellcode: 'https://www.olaf-willerding.de',
  /** Die Unterstuetzungsseite - freiwillig, siehe das "Über"-Fenster. */
  unterstuetzung: 'https://ko-fi.com/olafwillerding',
};

/**
 * Die Kontaktadresse des Herausgebers - an EINER Stelle im Programm.
 *
 * Das "Über"-Fenster nennt sie in der Kontaktzeile. Sie steht nicht in
 * `VERWEISADRESSEN`: Das ist die Tafel dessen, was der Hauptprozess im
 * Browser OEFFNET, und dort ist nur https zugelassen
 * (`tests/tools/verweiseNachDraussen.test.ts`). Dieselbe Adresse fuehrt
 * package.json als `author.email`.
 */
export const KONTAKTADRESSE = 'olaf@olaf-willerding.de';