feat(git): mehrere Repositories je Projekt

Ein Vorhaben besteht oft aus Frontend und Backend - zwei Repositories, aber
eine Karte. Die Git-Felder wandern deshalb vom Projekt in eine eigene
Tabelle, der Snapshot haengt jetzt am Repository.

Das erste Repository ist das fuehrende. Wo nur eines dargestellt werden
kann - Karte, Kanban -, ist es dieses. Ein Abgleichsfehler an *irgendeinem*
erscheint aber trotzdem auf der Karte, sonst bliebe er unbemerkt.

Der Merkstand fuer Benachrichtigungen liegt nun am Repository. Am Projekt
verdeckte ein rotes Frontend die rote Pipeline des Backends. Stillstand
bleibt dagegen eine Aussage ueber das Vorhaben und bemisst sich am juengsten
Commit ueber alle Repos: an einem Projekt wird gearbeitet, sobald an einem
seiner Teile gearbeitet wird.

Der Zeitgeber zaehlt und begrenzt jetzt Repositories statt Projekte. Sonst
zoege ein Projekt mit fuenf Repos fuenfmal so viele Anfragen nach sich, wie
sein Platz im Kontingent hergibt. "Alle abgleichen" laeuft nacheinander -
ein Schwung gleichzeitiger Anfragen an denselben Anbieter ist genau das,
worauf Rate-Limits reagieren.

Die Issue-Nummer allein reicht als Dublettenschutz nicht mehr: Frontend und
Backend haben beide ein Issue 5, und das sind zwei Aufgaben. Die Herkunft
gehoert deshalb mit in die Eindeutigkeit. In Postgres nachgewiesen: dieselbe
Nummer in zwei Repos geht durch, zweimal im selben Repo nicht, mehrere
Aufgaben ohne Herkunft bleiben erlaubt.

Die Projekt-API nimmt die Git-Felder weiterhin an und setzt damit das
fuehrende Repository - so kommt man mit einem Aufruf zu Projekt und Repo,
und der Import muss von der neuen Tabelle nichts wissen.

Die Exportdatei zaehlt auf 2 hoch und traegt eine Liste. Version 1 bleibt
lesbar: dort stand genau ein Repository flach am Projekt.

Die Datenmigration ist von Hand geschrieben - migrate diff kennt nur den
Zielzustand und haette die Spalten samt Snapshots ersatzlos geloescht.
Gegen eine Kopie mit echten Daten geprueft: Verknuepfung, Verbindung,
Fehlerzaehler und Snapshot kommen vollstaendig mit, Projekte ohne Repo
bekommen keine leere Zeile.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-26 13:23:53 +02:00
co-authored by Claude Opus 5
parent 2bff6faf3d
commit a843f08211
29 changed files with 1207 additions and 268 deletions
+42 -2
View File
@@ -18,7 +18,11 @@ import { z } from "zod";
*/
export const EXPORT_KIND = "nebula.projects";
export const EXPORT_VERSION = 1;
/**
* 2 seit den mehreren Repositories je Projekt. Dateien der Version 1 werden
* weiter gelesen: ihre einzelnen Repo-Felder werden zum ersten Repository.
*/
export const EXPORT_VERSION = 2;
const STATUS = ["IDEA", "OPEN", "PLANNING", "IN_DEVELOPMENT", "DONE", "ARCHIVED"] as const;
const PROVIDERS = ["GITHUB", "GITLAB", "GITEA"] as const;
@@ -46,6 +50,16 @@ export const exportedConnectionSchema = z.object({
baseUrl: z.string().max(300),
});
export const exportedRepositorySchema = z.object({
label: z.string().max(80).nullable().optional(),
repoUrl: z.string().max(500).nullable().optional(),
repoOwner: z.string().max(200).nullable().optional(),
repoName: z.string().max(200).nullable().optional(),
autoSync: z.boolean().optional().default(true),
/** Nur zur Wiedererkennung – ohne Token. */
connection: exportedConnectionSchema.nullable().optional(),
});
export const exportedProjectSchema = z.object({
name: z.string().min(1).max(120),
slug: z.string().max(60).optional(),
@@ -57,11 +71,17 @@ export const exportedProjectSchema = z.object({
accent: z.string().max(20).optional().default("violet"),
tags: z.array(z.string().max(30)).max(12).optional().default([]),
favorite: z.boolean().optional().default(false),
/** Seit Version 2. */
repositories: z.array(exportedRepositorySchema).max(20).optional(),
/**
* Version 1 kannte genau ein Repository und schrieb es flach ans Projekt.
* Die Felder bleiben lesbar, damit aeltere Dateien weiter importierbar
* sind; geschrieben werden sie nicht mehr.
*/
autoSync: z.boolean().optional().default(true),
repoUrl: z.string().max(500).nullable().optional(),
repoOwner: z.string().max(200).nullable().optional(),
repoName: z.string().max(200).nullable().optional(),
/** Nur zur Wiedererkennung – ohne Token. */
connection: exportedConnectionSchema.nullable().optional(),
notes: z.array(exportedNoteSchema).max(500).optional().default([]),
tasks: z.array(exportedTaskSchema).max(1000).optional().default([]),
@@ -78,6 +98,26 @@ export const exportFileSchema = z.object({
});
export type ExportedProject = z.infer<typeof exportedProjectSchema>;
export type ExportedRepository = z.infer<typeof exportedRepositorySchema>;
/**
* Die Repositories einer Exportdatei – gleich, ob sie aus Version 2 stammt
* oder aus der Zeit mit genau einem Repo je Projekt.
*/
export function repositoriesOf(project: ExportedProject): ExportedRepository[] {
if (project.repositories?.length) return project.repositories;
if (!project.repoUrl && !(project.repoOwner && project.repoName)) return [];
return [
{
label: null,
repoUrl: project.repoUrl ?? null,
repoOwner: project.repoOwner ?? null,
repoName: project.repoName ?? null,
autoSync: project.autoSync,
connection: project.connection ?? null,
},
];
}
export type ExportFile = z.infer<typeof exportFileSchema>;
/** Dateiname ohne Sonderzeichen, mit Datumsstempel. */