O que é o Fabric Apps (Pré-visualização)?

O Fabric Apps (pré-visualização) ajuda-o a construir aplicações orientadas por dados no Microsoft Fabric, combinando modelos de dados, APIs geradas, autenticação e alojamento num único fluxo de trabalho de desenvolvimento. Defines os teus modelos de dados em TypeScript, e o Fabric Apps usa-os para gerar as peças de backend que a tua aplicação precisa. Fabric Apps suporta TypeScript como linguagem para modelos de dados, código cliente e lógica de aplicação.

Principais características

O Fabric Apps oferece as seguintes capacidades:

• Modelos de dados para APIs – Decorar classes TypeScript com @entity(), @text(), @uuid(), e outros decoradores. O Fabric Apps gera automaticamente esquemas de base de dados e endpoints GraphQL.
• Clientes seguros para tipos – O SDK do cliente valida consultas e mutações antes de chegarem ao backend, detetando erros durante o desenvolvimento.
• Autenticação incorporada – Estão incluídos os fluxos de gestão de sessões, gestão de tokens e autenticação. Configure o Fabric SSO para aplicações implementadas ou use email e palavra-passe durante o desenvolvimento local.
• Alojamento estático – Construa e sirva a sua aplicação frontend juntamente com as APIs backend com um único comando de deployment.
• Desenvolvimento local – Execute o full stack localmente com o Docker para iteração rápida, depois implemente para Microsoft Fabric quando estiver pronto para produção. Crie a estrutura de projetos, desenvolva com o GitHub Copilot e implemente no Fabric com a Rayfin CLI.

Pré-requisitos

Capacidade do tecido

O seu espaço de trabalho deve ter capacidade Fabric atribuída. Ao criar um novo espaço de trabalho, selecione uma capacidade Fabric para lhe associar. Os serviços Fabric Apps consomem unidades de capacidade a partir da capacidade atribuída.

Definições de administrador do locatário

Um administrador de tenant Fabric deve ativar a carga de trabalho Fabric Apps antes de os utilizadores poderem criar itens.

1. Inicie sessão no portal de administração Fabric.
2. Navegue até às definições do Inquilino.
3. Em Fabric Apps (pré-visualização), alterne a definição para Ativado.
4. Escolhe se queres ativar para toda a organização ou para grupos de segurança específicos.
5. Selecione Aplicar.

As alterações podem demorar alguns minutos a propagar-se.

Como funciona

Uma aplicação Fabric funciona como um serviço gerido no Microsoft Fabric com um conjunto de serviços que definem o backend, como alojamento de aplicações, base de dados, APIs GraphQL e autenticação. A Fabric gere o alojamento, a rede e a escalabilidade. A autenticação utiliza exclusivamente Fabric SSO (Microsoft Entra ID single log-on) — não há outros fornecedores de autenticação disponíveis após a implementação.

Quando implementas a tua aplicação com rayfin up, Fabric cria serviços para filhos com base na tua configuração rayfin.yml. Estes serviços de proteção à criança aparecem como itens infantis na aplicação Fabric no portal Fabric.

URL do backend da aplicação

Cada aplicação Fabric tem um único endpoint que fornece acesso a todos os serviços:

https://<your-app>-app.rayfin.windows.net/

O endpoint expõe um caminho para cada serviço:

Gestão no portal Fabric

Após a implementação, pode gerir a sua aplicação Fabric diretamente no portal Fabric.

Visualizar propriedades do item

Abra a aplicação Fabric no portal para ver:

• URL do backend da aplicação — Este endpoint é usado para todos os serviços backend usados pela aplicação.
• URL da aplicação — O URL público onde o seu conteúdo estático está alojado. O Fabric SSO é necessário para aceder à aplicação.

Gerir itens filhos

Selecione a aplicação Fabric para ver os serviços de proteção à criança:

• Base de Dados SQL no Fabric — Abre o item Base de Dados SQL no Fabric para ver o explorador de objetos. Pode executar consultas de leitura sobre os seus dados. As alterações de esquema devem sempre ser feitas no código em pasta rayfin/data . Conflitos de esquema podem ocorrer se o esquema for alterado diretamente na base de dados SQL e podem quebrar a aplicação.

Permissões de item

Os papéis de espaço de trabalho não sobrepõem-se às permissões ao nível do item. Para partilhar uma aplicação com alguém da sua organização, essa pessoa precisa de permissão Run and Interact (Ler e executar) para executar a aplicação e invocar as APIs do backend.

Saiba mais sobre funções no Workspace.

Desenvolvimento com Rayfin CLI

A CLI apoia novos projetos, lança infraestruturas locais, sincroniza alterações de esquemas e implementa para o Fabric. Instale-o com npm create @microsoft/rayfin@latest.

Comandos chave:

Para uma referência completa de comandos, veja referência CLI.

Decoradores de modelos de dados

Defina modelos de dados usando decoradores TypeScript:

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text() user_id!: string;
}

O Fabric Apps analisa estes decoradores e gera:

• Definições de tabelas de bases de dados
• Pontos de extremidade da API GraphQL
• Regras de autorização ao nível da linha
• Métodos de cliente seguros para tipos

Quando usar o Fabric Apps

O Fabric Apps é ideal para:

• Prototipagem rápida – Passe da ideia ao URL em tempo real em minutos com infraestrutura pré-configurada.
• Ferramentas e dashboards internos – Construa interfaces de administração autenticadas sem escrever o boilerplate do backend.
• Exploração e visualização de dados – Consultar dados do Fabric através de GraphQL e exibi-los em interfaces personalizadas.
• IA e aplicações de agentes – Fornecer serviços estruturados de backend para agentes de IA que necessitem de estado persistente.

As aplicações Fabric podem não ser adequadas para:

• Aplicações que requerem transações complexas em múltiplos passos ou procedimentos armazenados.
• Aplicações que exigem fornecedores de autenticação personalizada para além do Fabric SSO e email/palavra-passe.

Responsabilidades de segurança

Fabric fornece: Fabric Single Sign on (Microsoft Entra ID), segurança ao nível da linha através de decoradores @role, HTTPS, PKCE, e permissões de espaço de trabalho e nível de item.

És responsável por:

• Manter segredos, chaves de API e dados sensíveis fora do seu código, dos recursos do frontend e do repositório. O conteúdo estático é servido a partir de uma URL pública.
• O que a tua aplicação expõe através do Fabric SSO controla o início de sessão, já que o teu código controla o que os utilizadores autenticados veem e fazem.
• Concedendo apenas as permissões que os colaboradores precisam para implementar ou gerir a aplicação.
• Responsabilidade legal e de conformidade pelos dados que a sua aplicação recolhe, processa e armazena.

Passos seguintes

• Crie o seu primeiro projeto Fabric Apps
• Defina modelos de dados com decoradores
• Implantar para Microsoft Fabric
• Configurar a autenticação