Fabric Apps projektstruktur

Fabric Apps projekterer separate backend-konfigurationer, datamodeller og frontend-kode. Den præcise opbygning afhænger af skabelonen. Standardskabelonen blankapp løser til Universal App, et npm-arbejdsområde med separate frontend-, data- og delte pakker.

Mappelayout

Standard Universal App-stilladset har følgende struktur:

your-project/
├── rayfin/
│   ├── .env
│   ├── rayfin.yml
│   └── tsconfig.json
├── packages/
│   ├── frontend/
│   │   ├── src/
│   │   └── package.json
│   ├── data/
│   │   └── src/index.ts
│   └── shared/
│       └── src/index.ts
├── package.json
├── tsconfig.json
└── README.md

Data er deaktiveret i basisstilladset. Aktiver det, når din app har brug for vedvarende poster:

npm run pack:add -- data-modeling

Kapaciteten tilføjer en starterenhed og en delt kontrakt og muliggør dataservicen. For entitetsforfatterskab og MSSQL-dialektkonfiguration, se Definér datamodeller.

Flad-skabelon alternativ

Nogle skabeloner og eksisterende apps bruger et fladt layout med frontend-kode i root src/, entities i rayfin/data/, og et skema-type map i rayfin/data/schema.ts. Denne opbygning er stadig gyldig. Flyt ikke filer eller lav dubletter af pakker bare for at matche en anden skabelon. Læs servicevejene ind rayfin/rayfin.yml for at finde de mapper, dit projekt faktisk bygger.

Nøglekonfigurationsfiler

Rayfin/rayfin.yml

rayfin/rayfin.yml-filen er hovedkonfigurationsfilen for din Fabric Apps backend. Den styrer, hvilke tjenester der kører under lokal udvikling, og understøtter interpolation af miljøvariabler for dynamiske konfigurationsværdier.

Standardarbejdsområdet bruger eksplicitte servicestier. Følgende eksempel viser de stier med Data aktiveret for en app, der har brug for en database:

id: my-app
name: my-app
version: 1.0.0
services:
  auth:
    enabled: true
    allowedRedirectUris:
      - http://localhost:5173
    fabric:
      enabled: true
      externalEntraExchange: true
    password:
      enabled: false
  data:
    enabled: true
    dialect: mssql
    path: packages/data
    buildCommand: npm run build
  staticHosting:
    enabled: true
    path: packages/frontend
    folder: dist
    buildCommand: npm run build:fabric
    indexDocument: index.html
    assetAccess: protected

Serviceværdier path er relative til projektets rod. Byg-kommandoer kører fra den løste servicemappe. Funktionsinitialisering registrerer services.functions.path også, når den vælger en arbejdsområdepakke såsom packages/functions. Flade projekter kan bruge den eksisterende rayfin/functions placering. Se Brug funktioner.

Konfigurationen inkluderer disse nøglefelter:

Topniveau-felter

services.data

services.auth

services.auth.password

services.auth.fabric

services.staticHosting

rayfin/.env

Filen rayfin/.env indeholder de aktive runtime- og deployment-værdier og leverer værdier til rayfin.yml gennem interpolation. CLI'en skriver framework-neutrale RAYFIN_PUBLIC_* værdier for den aktive backend. Kun variabler med det præfiks projiceres ind i genererede frontend-miljøfiler. Læg aldrig hemmeligheder i RAYFIN_PUBLIC_* variabler.

Hold dig rayfin/.env ude af kildekodekontrol. Brug rayfin/.env.example den til at dokumentere forventede variable med pladsholdere.

Rayfin/.deployments.json

Implementeringsregistret registrerer backend-URL'er, hosting-URL'er, item-ID'er og arbejdsområde-ID'er for dit projekts deployments. Det er ikke en frontend-miljøfil. Hold det ude af versionskontrol. Brug npx rayfin up list til at liste registrerede udrulninger og npx rayfin up switch <name> til at skifte den aktive udrulning og gengenerere dens miljøværdier.

Rayfin/tsconfig.json

Skabeloner giver TypeScript-konfiguration til deres layout. Workspace-pakker har deres egne konfigurationer og projektreferencer; flade skabeloner kan kompilere enheder gennem rayfin/tsconfig.json. Bevar stillingens referencer og brug dens build- og type-check-scripts i stedet for at antage en enkelt root-kompilering.

Datamodelfiler

Hold kørselsregistrering og kundeorienterede typer tilpasset dit valgte layout.

Workspace-enheder og delte kontrakter

I Universal App definerer filer under packages/data/src/ dekorerede entitetsklasser. Registrer runtime-klasserne i arrayet, der schema eksporteres af packages/data/src/index.ts.

Behold matchende record-interfaces og UniversalAppSchema typen i packages/shared/src/index.ts. Frontenden importerer denne kontrakt fra @rayfin-app/shared i stedet for at importere dekorerede backend-klasser.

Flad-skabelon-enheder

I en flad skabelon rayfin/data/*.ts definerer entiteter og rayfin/data/schema.ts afbilder entitetsnavne til typer for client.data.<Entity>. Følg registreringsmekanismen, som den skabelon giver.

Genererede artefakter

rayfin/.temp/

Mappen rayfin/.temp/ indeholder genererede backend-artefakter, der oprettes, når du kører udviklingsserveren. Hvis backenden ser ud til at bruge forældet skema eller konfiguration, stop og genstart udviklingsstakken for at generere disse filer.

Frontendstruktur

Standardfrontenden er i packages/frontend/src/. Flade skabeloner kan bruge root src/. Indstillingen services.staticHosting.path identificerer frontend-pakken.

Aktiv miljø- og rammekortlægning

rayfin dev og rayfin up generere rammeværksspecifikke .env.local værdier fra rayfin/.env. For en indlejret frontend skrives filen under services.staticHosting.path, såsom packages/frontend/.env.local; flade projekter bruger projektets rod.

Rediger kildeværdierne i rayfin/.env, ikke den genererede fil. For at regenerere uden at udrulle:

npx rayfin env --framework vite

Brug --framework nextjs eller --framework plain for andre understøttede mappinger. Brug --output <dir> til at vælge en outputmappe eller --show til at inspicere den offentlige mapping uden at skrive. Hold genererede .env.local filer ude af versionskontrol.

Migrer et ældre miljølayout

Ældre projekter kan indeholde .env.fabric filer eller .env.fabric-<workspace> filer. Disse filer er ikke de aktive miljøfiler i det nuværende layout. Kør npx rayfin up for at bruge det nuværende miljøworkflow. Gennemgå eventuelle migrationsmeddelelser, og kopier brugerdefinerede værdier efter rayfin/.env behov. Deployeringsregistret erstatter filerne for miljøer pr. arbejdsområde. Konfigurer ikke nye apps til at være afhængige af dem.

Relateret indhold

• Opret dit første Fabric Apps-projekt
• Rayfin CLI-reference