#Projektstruktur und Technologie-Stack

Den größten Teil der täglichen Entwicklung können Sie der KI überlassen. Wenn Sie die Struktur der Vorlage kennen, können Sie aber beurteilen, ob die KI ihren Code an der richtigen Stelle abgelegt hat, und Probleme lassen sich leichter eingrenzen.

#Technologie-Stack

Die Portal-Vorlage basiert auf @nocobase/portal-template-default, der Quellcode liegt unter nocobase/portal-template-default.

Diese Kombination ist der Frontend-Stack, den KI aktuell am besten kennt – entsprechend genauer fällt aus, was sie schreibt.

Das Portal ist derzeit ein reines Frontend-Projekt; die Geschäftslogik wird über die API von NocoBase, Standardkomponenten und Ähnliches abgedeckt. Unterstützung dafür, dass der AI Agent auch den Backend-Code des Portals schreibt, folgt später.

#Verzeichnisstruktur

src/
├── app/            Routing und Laden der Erweiterungen
├── pages/          Anmeldung, Registrierung, Passwort vergessen und Weiteres
├── components/     Komponenten
│   ├── ui/         shadcn/ui-Komponentenbasis
│   ├── app-shell/  Layout, Navigation, Ladezustände
│   ├── auth/       Komponenten rund um die Authentifizierung
│   └── ...
├── extensions/     Erweiterungen, nach dem Ablegen sofort aktiv
├── lib/            NocoBase-Client-Kapselung und ACL-Logik
├── providers/      Die verschiedenen Provider von Refine
├── hooks/          Eigene Hooks
└── locales/        Texte für die Internationalisierung

Einige zentrale Stellen:

• src/app/routes.tsx – die Routenstruktur. Routen für angemeldete und nicht angemeldete Nutzer sind getrennt, und von Erweiterungen bereitgestellte Routen werden automatisch eingehängt
• src/app/extensions.tsx – die Logik zum Laden der Erweiterungen, die per import.meta.glob src/extensions/*/extension.tsx durchsucht
• src/providers/data.ts – der data provider von Refine, der die Abfragesyntax von Refine in NocoBase-API-Parameter übersetzt
• src/lib/nocobase/client.ts – NocoBaseClient, die zugrunde liegende Kapselung sämtlicher Anfragen
• src/components/ui/ – über 60 shadcn/ui-Komponenten, direkt einsatzbereit

Geschäftsseiten liegen üblicherweise unter src/extensions/, ein Verzeichnis je Funktionsmodul. Details siehe Standardkomponenten und Erweiterungen.

#Zentrale Dateien

#Umgebungsvariablen

Diese Variablen schreiben nb portal dev und nb portal deploy automatisch, sodass Sie in der Regel nichts von Hand ändern müssen. Nur wenn die Art der Authentifizierungsspeicherung serverseitig angepasst wurde, müssen die letzten drei abgeglichen werden.

Steht in NOCOBASE_API_URL während der Entwicklung eine absolute Adresse, richtet Vite automatisch einen Proxy ein, der die Anfragen weiterleitet – um CORS müssen Sie sich also nicht selbst kümmern.

#Gängige Befehle

Für die tägliche Entwicklung brauchen Sie nur diese wenigen Befehle; Installation der Abhängigkeiten, Aktualisierung der Umgebungsvariablen und Builds erledigt die CLI im Hintergrund:

Die vollständigen Parameter jedes Befehls finden Sie in der nb portal Befehlsreferenz.

#Wo der Entwicklungs-Workspace liegt

Der Entwicklungs-Workspace eines Portals landet standardmäßig in dem Verzeichnis, in dem Sie nb portal create oder nb portal pull ausgeführt haben:

./<portal>

Beim Erstellen oder Ziehen können Sie mit --path einen anderen Ort angeben. Die gebauten Deployment-Artefakte liegen an anderer Stelle, nämlich im storage der Zielanwendung; nb portal deploy hält sie synchron, und im Alltag müssen Sie sich nicht darum kümmern.

Wenn Sie nicht sicher sind, wo der Entwicklungs-Workspace eines Portals liegt, fragen Sie ihn einfach ab:

nb portal info main

#Verwandte Links

• Schnellstart Aufbau mit AI Portal – bringen Sie Ihren ersten von der KI geschriebenen Frontend-Einstieg zum Laufen
• Standardkomponenten und Erweiterungen – die shadcn/ui-Komponentenbasis und der Erweiterungsmechanismus
• Deployment und Quellcodeverwaltung – der Build- und Deployment-Ablauf sowie source storage
• Aufbau mit einem AI Agent – Seiten in natürlicher Sprache von der KI schreiben lassen
• nb portal info – nachsehen, wo der Entwicklungs-Workspace eines Portals liegt