Scala-Platform-NG

Biblioteca de componentes Angular com regras de negócio da Senior Sistemas — camada de plataforma construída sobre o Design System Scala-NG.

Desenvolvido e mantido pelo time SDS (Senior Design System).

Desenvolvedores

Eduardo Franz · Moacir Zimermann

O que é

Scala-Platform-NG é a camada de componentes Angular orientados ao domínio de negócio da Senior Sistemas. Diferente do Scala-NG (que fornece primitivos visuais agnósticos), esta lib encapsula:

• Componentes conectados a APIs da plataforma Senior (consultas, formulários, listagens)
• Regras de negócio recorrentes nos produtos da Senior
• Integrações com serviços internos (autenticação, permissões, i18n, etc.)
• Smart components que combinam lógica de domínio com os componentes visuais do Scala-NG

Relação com Scala-NG

Scala-Platform-NG  →  consome  →  Scala-NG (Design System)
       ↓                               ↓
  Regras de negócio            Primitivos visuais
  Consultas a APIs             Tokens de design
  Domínio Senior               Componentes base

Suporte

| Tecnologia | Versão mínima | | ------------ | ------------- | | Angular | 18 | | Tailwind CSS | 3.4 |

Instalação

ng add @seniorsistemas/scala-platform-ng

O schematics cuida automaticamente de:

• Instalar o Tailwind CSS e suas dependências
• Configurar o preset @seniorsistemas/scala-tailwind-config com os tokens do design system
• Registrar os estilos globais da lib no angular.json

Uso

Importe o componente desejado no seu componente standalone:

import { ExemploComponent } from "@seniorsistemas/scala-platform-ng";

@Component({
  imports: [ExemploComponent],
  // ...
})
export class AppComponent {}

<sds-exemplo />

Desenvolvimento local

Pré-requisitos

• Node.js 20+
• npm 10+

Setup

npm install

Servidor de desenvolvimento (showcase)

npm start

Acesse http://localhost:4200 para visualizar os componentes no showcase.

Build da lib

npm run build

Testes

# Todos os testes
npm test

# Com cobertura
npm run test:coverage

Lint

npm run lint
npm run lint:fix

Formatação

npm run format
npm run format:check

Estrutura do projeto

projects/
├── scala-platform-ng/      # Código-fonte da lib
│   ├── src/
│   │   ├── lib/            # Componentes, serviços e diretivas
│   │   └── public-api.ts   # Exports públicos da lib
│   ├── schematics/         # ng-add schematic
│   └── styles.scss         # Estilos globais
└── showcase/               # Aplicação de demonstração dos componentes

Licença

Propriedade da Senior Sistemas S.A. — uso interno.