204 lines
7.3 KiB
Text
204 lines
7.3 KiB
Text
---
|
|
type: rule
|
|
name: estilos-design-system
|
|
description: Define os dois design systems do ecossistema e-licencie — Floreta (iniciativa privada) e Betha (governo) — e quando usar cada um
|
|
scope: global
|
|
trigger: always
|
|
updatedAt: "2026-07-02"
|
|
---
|
|
|
|
# Regra: Estilos e Design Systems do Ecossistema
|
|
|
|
O ecossistema e-licencie opera com **dois design systems distintos**, selecionados conforme o público-alvo da aplicação.
|
|
|
|
## 1. Estilo Floreta — Iniciativa Privada
|
|
|
|
Usado em: `e-licencie`, `e-licencie.qualifica`, `e-licencie.gee` e todos os módulos voltados a empresas privadas.
|
|
|
|
### Características
|
|
|
|
- **Framework UI:** Vuetify (Vue 3)
|
|
- **Cores:** paleta própria definida no tema Vuetify do projeto
|
|
- **Tipografia:** controlada pelo tema Vuetify
|
|
- **Componentes:** componentes Vuetify (`v-btn`, `v-card`, `v-data-table`, etc.)
|
|
- **Estilo visual:** moderno, tech, voltado a usabilidade corporativa
|
|
|
|
### Quando aplicar
|
|
|
|
- Todo código em pacotes `*-front` dos produtos e-licencie voltados ao mercado privado
|
|
- Landing pages e painéis públicos de empresas
|
|
|
|
---
|
|
|
|
## 2. Estilo Betha — Governo / Setor Público
|
|
|
|
Usado em: aplicações integradas à plataforma Betha (gestão municipal, e-Gov).
|
|
|
|
**Documentação oficial:** https://design.plataforma.betha.cloud/doc/index.html
|
|
|
|
### Cores
|
|
|
|
| Cor | Hex | Classe bg | Classe tx |
|
|
|-------------|-----------|--------------------|--------------------|
|
|
| **Brand** | `#0761FF` | `.bg__brand` | `.tx__brand` |
|
|
| **Blue** | `#3374DB` | `.bg__blue` | `.tx__blue` |
|
|
| **Aqua** | `#46AFD2` | `.bg__aqua` | `.tx__aqua` |
|
|
| **Yellow** | `#E8B730` | `.bg__yellow` | `.tx__yellow` |
|
|
| **Red** | `#DD413C` | `.bg__red` | `.tx__red` |
|
|
| **Green** | `#3EC18F` | `.bg__green` | `.tx__green` |
|
|
| **Orange** | `#E87D30` | `.bg__orange` | `.tx__orange` |
|
|
| **Purple** | `#9F62B2` | `.bg__purple` | `.tx__purple` |
|
|
| **Pink** | `#CB528F` | `.bg__pink` | `.tx__pink` |
|
|
| **Gray** | `#BFBFC0` | `.bg__gray` | `.tx__gray` |
|
|
|
|
**Variações tonais:**
|
|
- Dark (mais escura): sufixos `--d10`, `--d20`, `--d30`, `--d40`
|
|
- Light (mais clara): sufixos `--l10`, `--l20`, `--l30`, `--l40`
|
|
- Exemplo: `.bg__blue--d20`, `.tx__red--l30`
|
|
|
|
**Cores de produtos Betha:**
|
|
| Produto | Hex |
|
|
|--------------------------------------|-----------|
|
|
| Gestão Municipal | `#9A8B7D` |
|
|
| Planejamento e Contabilidade | `#A6B8FF` |
|
|
| Arrecadação e Fiscalização | `#00BD7E` |
|
|
| Atendimento | `#A5A6A7` |
|
|
| Gestão de Compras e Contratos | `#FF7F7A` |
|
|
| Pessoal e Recursos Humanos | `#00B0FF` |
|
|
| Saúde e Assistência Social | `#A7C27E` |
|
|
| Educação e Gestão Escolar | `#F9B02E` |
|
|
| Gestão de Leis Municipais | `#F4812E` |
|
|
| Componentes genéricos / Perf. Corp. | `#263E81` |
|
|
|
|
### Tipografia
|
|
|
|
- **Fonte:** Open Sans (Regular, Semibold, Bold)
|
|
- **Tamanhos:** H1=36px, H2=30px, H3=20px, H4=18px, H5=14px, H6=12px
|
|
|
|
### Componentes (classes CSS)
|
|
|
|
#### Botões
|
|
- `.btn-default` — ação secundária
|
|
- `.btn-primary` — ação principal (`#337AB7`)
|
|
- `.btn-success` — ação positiva/adicionar
|
|
- `.btn-danger` — ação destrutiva/crítica
|
|
- `.btn-warning` — ação que requer atenção
|
|
- `.btn-info` — ação principal discreta
|
|
- `.btn-link` — estilo link
|
|
- Tamanhos: `.btn-lg`, `.btn` (padrão), `.btn-sm`, `.btn-xs`
|
|
|
|
#### Grid
|
|
- 12 colunas responsivas (Bootstrap 3)
|
|
- Container fixo: max-width `1360px`
|
|
- Gutter: `8px`
|
|
- Classes: `.col-xs-*`, `.col-sm-*`, `.col-md-*`, `.col-lg-*`
|
|
|
|
### Integração (CDN)
|
|
|
|
```html
|
|
<!-- CSS -->
|
|
<link rel="stylesheet" href="https://cdn.betha.cloud/base/g4/design/4.0.0/bth-design.css" />
|
|
|
|
<!-- JS -->
|
|
<script src="https://cdn.betha.cloud/base/g4/front-end/2.7/js/base.js"></script>
|
|
<script src="https://cdn.betha.cloud/base/g4/design/4.0.0/bth-design.js"></script>
|
|
```
|
|
|
|
### Quando aplicar
|
|
|
|
- Módulos integrados à plataforma Betha de gestão municipal
|
|
- Interfaces que operam dentro do ecossistema e-Gov Betha
|
|
- Aplicações web com `body class="suite-pla iv"`
|
|
|
|
### Tokens Reais — Ecossistema GOV (React/MUI)
|
|
|
|
Os frontends React (QUIPO-FRONT, QUIPO-PORTAL3, AUTENTICACAO-FRONT) usam estes tokens via MUI ThemeProvider:
|
|
|
|
| Token | Hex | Uso |
|
|
|-------|-----|-----|
|
|
| primary | `#007bff` | botões, links, destaques |
|
|
| primary dark | `#0069d9` | hover de botões primários |
|
|
| secondary | `#6c757d` | ações secundárias |
|
|
| dark (header) | `#343a40` | header de telas, DialogTitle, navbar |
|
|
| body bg | `#EBEDF0` | background da aplicação |
|
|
| light bg | `#f8f9fa` | DialogActions, cards neutros |
|
|
| border | `#dee2e6` | bordas de separadores |
|
|
| text | `#212529` | texto principal |
|
|
| text muted | `#495057` | texto secundário/labels |
|
|
| success | `#28a745` | status positivo |
|
|
| danger | `#dc3545` | erro/exclusão |
|
|
| warning | `#ffc107` | alerta |
|
|
| info | `#17a2b8` | informação |
|
|
| e-licencie primary | `#688c00` | substituição de primary quando marca e-licencie ativa |
|
|
|
|
**Seleção de itens (cartões interativos):**
|
|
- Selecionado: `#cce5ff` / hover: `#b8daff`
|
|
- Não selecionado: `#f8f9fa` / hover: `#e9ecef`
|
|
|
|
### Vue 3 + Vuetify — QUIPO-CONSOLE
|
|
|
|
O QUIPO-CONSOLE usa Vue 3 + Vuetify 3. Configuração do tema em `src/plugins/vuetify.ts`:
|
|
|
|
```typescript
|
|
theme: {
|
|
defaultTheme: "bethaTema",
|
|
themes: {
|
|
bethaTema: {
|
|
dark: false,
|
|
colors: {
|
|
primary: "#007bff",
|
|
secondary: "#6c757d",
|
|
background: "#EBEDF0",
|
|
surface: "#ffffff",
|
|
error: "#dc3545",
|
|
warning: "#ffc107",
|
|
success: "#28a745",
|
|
info: "#17a2b8",
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
- **Navbar** (`App.vue`): `<v-app-bar flat color="#343a40" theme="dark">`
|
|
- **Botões:** sempre `color="primary"` para usar o token do tema
|
|
|
|
---
|
|
|
|
## 3. Branding Dinâmico — eBetha() nos Footers
|
|
|
|
Todos os footers do ecossistema usam a função `eBetha()` para determinar a identidade da empresa exibida:
|
|
|
|
```typescript
|
|
import { eBetha } from "p-ambiente";
|
|
|
|
// eBetha() == true → Betha Sistemas Ltda, CNPJ 00.456.865/0001-67, Criciúma-SC
|
|
// eBetha() == false → Azteca Software LTDA, CNPJ 29.979.144/0001-13, Içara-SC
|
|
```
|
|
|
|
**Arquivos de footer por frontend:**
|
|
|
|
| Frontend | Arquivo |
|
|
|----------|---------|
|
|
| QUIPO-FRONT | `src/components/Footer.tsx` e `src/pages/Portal/PortalFooter.tsx` |
|
|
| QUIPO-PORTAL3 | `src/components/Footer/Footer.tsx` |
|
|
| AUTENTICACAO-FRONT | sem footer próprio |
|
|
|
|
- O footer exibe sempre a versão da API e do frontend
|
|
- O logotipo é condicional: logotipo diferente por marca
|
|
|
|
---
|
|
|
|
## Decisão: Como identificar qual estilo usar
|
|
|
|
1. **Pergunte o contexto:** se o operador não especificar, pergunte se o módulo é para iniciativa privada (Floreta/Vuetify) ou governo (Betha)
|
|
2. **Nunca misture:** um módulo usa UM estilo — nunca combine Vuetify com Betha Design
|
|
3. **Header identifica:** header `#343a40` com logo = Betha; barra lateral com menu Vuetify customizado = Floreta
|
|
|
|
## Referências
|
|
|
|
- Betha Design System: https://design.plataforma.betha.cloud/doc/index.html
|
|
- Framework Design CDN: https://cdn.betha.cloud/base/g4/design/4.0.0/
|
|
- Rule: `css-global-betha` (variáveis --bth-*)
|
|
- Rule: `theme-provider-mui-betha` (arquitetura ThemeProvider)
|
|
- Rule: `modal-dialog-padrao-betha` (estrutura de modais)
|