@acropole/skills 1.6.1 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/agents/revisor-deploy.md +9 -4
- package/package.json +1 -1
- package/skills/acropole/references/arquitetura.md +3 -3
- package/skills/acropole/references/fluxos/app-novo.md +2 -2
- package/skills/angular/SKILL.md +32 -14
- package/skills/angular/references/armadilhas.md +13 -3
- package/skills/angular/references/estrutura.md +118 -50
- package/skills/angular/references/testes-build.md +25 -17
- package/skills/docker/SKILL.md +17 -7
- package/skills/docker/references/modelos.md +23 -9
- package/skills/docker/references/porques.md +19 -6
- package/skills/hefesto/SKILL.md +46 -24
- package/skills/hefesto/references/conceitos.md +16 -8
- package/skills/hefesto/references/diagnostico.md +11 -2
- package/skills/hefesto/references/fluxo.md +51 -29
- package/skills/hefesto/references/mcp-roteiros.md +4 -2
- package/skills/hefesto/references/preparar-app.md +22 -6
- package/skills/trismegisto/references/angular-api.md +2 -2
- package/skills/trismegisto/references/angular-exports.md +1 -1
- package/skills/trismegisto/references/spine-api.md +11 -6
- package/skills/trismegisto/references/spine-recipes.md +44 -14
- package/skills/trismegisto/references/spine.md +25 -8
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ Cada skill cobre uma parte da stack e elas se complementam (a `orquestracao` enc
|
|
|
14
14
|
| Skill | Assunto | Exemplo de pedido que a dispara |
|
|
15
15
|
| --- | --- | --- |
|
|
16
16
|
| `acropole` | Porta de entrada e padrão arquitetural dos apps (pastas, ambientes, saúde, segurança, dependências, scripts, testes); fluxos `app-novo`, `tela-nova`, `endpoint-novo`, `revisar`, `doctor`, `atualizar-libs` | `/acropole`, "cria a estrutura do app novo", "esse app segue o padrão?" |
|
|
17
|
-
| `angular` | Estrutura dos apps Angular, bootstrap com o spine, telas por `router_id`, serviços GraphQL, signals, testes, build | "cria a tela de pedidos no app de vendas" |
|
|
17
|
+
| `angular` | Estrutura dos apps Angular, bootstrap com o spine, ambiente em runtime (`config.json`, imagem única por versão), telas por `router_id`, serviços GraphQL, signals, testes, build | "cria a tela de pedidos no app de vendas" |
|
|
18
18
|
| `trismegisto` | Interface com o design system (`@trismegisto/*`, componentes `hm-*`, tokens `--hm-*`, tema, ícones, a11y) e o shell spine | "troca essa tabela por um data grid", "o botão some no tema escuro" |
|
|
19
19
|
| `orfeu` | SDK Orfeu: login/sessão no front, operações e níveis no backend, auditoria, `traceparent`, propagação entre serviços | "protege essa rota", "o usuário toma 403", "audita a exclusão" |
|
|
20
20
|
| `apollo` | Servidores GraphQL (Apollo Server): schema, resolvers, envelope `{ status, message, data }`, subscriptions | "expõe uma mutation para cancelar pedido" |
|
package/agents/revisor-deploy.md
CHANGED
|
@@ -45,12 +45,17 @@ pista: abra o arquivo e confirme.
|
|
|
45
45
|
5. **Healthcheck e porta.** Endpoint de saúde que o serviço realmente expõe; `EXPOSE`/porta coerente
|
|
46
46
|
com a que o processo escuta e com a configuração do deploy. Serviço que sobe sem o Orfeu conectado
|
|
47
47
|
(startup em segundo plano) responde 503 no `/health` até conectar.
|
|
48
|
-
6. **Configuração em runtime.** URL, segredo e ambiente lidos de variável de
|
|
49
|
-
gravados no build (`ARG` virando `ENV` com valor de produção
|
|
50
|
-
|
|
48
|
+
6. **Configuração em runtime; uma imagem por versão.** URL, segredo e ambiente lidos de variável de
|
|
49
|
+
ambiente na subida, não gravados no build (`ARG` virando `ENV` com valor de produção). Front Angular:
|
|
50
|
+
build sempre `--configuration production`, sem `ARG CONFIGURATION` escolhendo ambiente, sem
|
|
51
|
+
`fileReplacements`/`environment.<amb>.ts`; o ambiente vem do `config.json` (`src/brand/config/<amb>.json`
|
|
52
|
+
no build, nenhum `config.json` no `/dist`, `src/config.json` no `.dockerignore`, nada de segredo nesses
|
|
53
|
+
JSON — vão ao navegador). Service que serve a UI lê `brand/config/${APP_ENV}.json` na subida. Front
|
|
54
|
+
estático: só o `/dist` no estágio final. FastAPI em produção com `/docs`, `/openapi.json` e
|
|
51
55
|
`/redoc` desligados; TLS do autorizador desligado só fora de produção.
|
|
52
56
|
7. **Higiene.** Multi-stage quando há build; imagem base com versão fixa; `npm ci`/`pip install -r`
|
|
53
|
-
com lockfile; `.dockerignore` cobrindo `node_modules`, `.git`, `dist`, `.env
|
|
57
|
+
com lockfile; `.dockerignore` cobrindo `node_modules`, `.git`, `dist`, `.env*` (e `src/config.json` no
|
|
58
|
+
Angular); script `.sh` no
|
|
54
59
|
repositório com `.gitattributes` `*.sh text eol=lf`.
|
|
55
60
|
|
|
56
61
|
## 3. Julgamento
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@acropole/skills",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "Skills e revisores para Claude Code: Angular, Apollo, Express, FastAPI, Trismegisto, Orfeu, Docker, deploy no Hefesto, documentação das telas e os MCPs do auto-serviço do Argos e de deploy do Hefesto. Instale com: npx @acropole/skills",
|
|
5
5
|
"bin": { "acropole-skills": "bin/install.js" },
|
|
6
6
|
"files": ["bin", "skills", "agents"],
|
|
@@ -93,7 +93,7 @@ Só **`local`**, **`dev`**, **`homol`** e **`prod`** — em toda camada, com o m
|
|
|
93
93
|
|
|
94
94
|
| Camada | Escolha do ambiente | Arquivos |
|
|
95
95
|
| --- | --- | --- |
|
|
96
|
-
| angular |
|
|
96
|
+
| angular | em runtime: `config.json` (deploy: `config_env` no site, `APP_ENV` no service; local: `npm run start:<ambiente>`) | `src/core/environments/environment.ts` único + `src/brand/config/<ambiente>.json` (versionados, sem segredo, só o que muda); build sempre `production`, uma imagem para todos os ambientes |
|
|
97
97
|
| graphql | `NODE_ENV` (`cross-env` nos scripts) | `src/settings/environment/.env.<ambiente>` (não versionados) + `.env.example` |
|
|
98
98
|
| server | `APP_ENV` (comando, `poe start:<ambiente>` ou `src/.env`) | `src/settings/environment/.env.<ambiente>` (não versionados) + `.env.example` |
|
|
99
99
|
| database | `-x env=<ambiente>` / `poe migrate <ambiente>` (padrão `local`) | `env/.env.<ambiente>` (não versionados) + `env/.env.example` |
|
|
@@ -158,7 +158,7 @@ do Dockerfile falha com `package.json` e lock divergentes.
|
|
|
158
158
|
|
|
159
159
|
| Camada | Scripts (mesmo conjunto em todo app) |
|
|
160
160
|
| --- | --- |
|
|
161
|
-
| angular | `start
|
|
161
|
+
| angular | `start` (= `local`), `start:dev`, `start:homol`, `start:prod` (todos `scripts/use-config.mjs <amb>` + `ng serve`), `build` (production), `watch`, `test`, `lint:a11y`, `axe:check`, `codegen` |
|
|
162
162
|
| graphql | `dev`, `start`, `start:local`, `start:homol`, `build` (typecheck + esbuild), `typecheck`, `start:prod`, `test` |
|
|
163
163
|
| server | `poe start:local`, `poe start:dev`, `poe start:homol`, `poe test` |
|
|
164
164
|
| database | `poe migrate <ambiente>`, `poe status <ambiente>`, `poe nova "<descrição>"`, `poe bootstrap <ambiente>`, `poe seed <ambiente>`, `poe seed-regerar <ambiente>`, `poe test` |
|
|
@@ -167,7 +167,7 @@ do Dockerfile falha com `package.json` e lock divergentes.
|
|
|
167
167
|
|
|
168
168
|
| Camada | Obrigatório |
|
|
169
169
|
| --- | --- |
|
|
170
|
-
| angular | `app.config.spec`, `core.providers.spec`, `
|
|
170
|
+
| angular | `app.config.spec`, `core.providers.spec`, `brand/config.spec`, `core.component.spec`, `features.routes.spec` (UUID único, `load()` standalone, documento carregável) + spec de toda tela nova/alterada |
|
|
171
171
|
| graphql | `builder.test` (subida, path, CORS, introspecção desligada, lote, 400 de sintaxe, 401/403 antes do resolver, encerramento), `builder-falha.test` (Orfeu fora → 503 → 200; campo sem `operation()` não sobe), `builder-padroes.test`, `shutdown.test` (teto → 1), `resolvers.test` (tabela campo → chamada REST) |
|
|
172
172
|
| server | `test_health`, `test_api_docs` (só `local`; `API_DOCS` força), testes de domínio com SQLite em memória |
|
|
173
173
|
| database | suíte compartilhada: migrations do zero, de novo sem efeito, `stamp`, migration nova numerada, confirmação em prod, seed (idempotente, regerar estável) — num Postgres em memória (PGlite por socket) |
|
|
@@ -17,8 +17,8 @@ app de origem — e depois remova o que for específico dele. Copiar do zero de
|
|
|
17
17
|
| # | Passo | Skill | Onde |
|
|
18
18
|
| --- | --- | --- | --- |
|
|
19
19
|
| 1 | **Esqueleto** `angular/`, `graphql/`, `server/`, `database/` + `.gitignore` da raiz, copiados da base sem artefatos nem domínio | acropole | `arquitetura.md` §1 |
|
|
20
|
-
| 2 | **Front**: nome do projeto no `angular.json` (`outputPath`, `buildTarget`), `baseHref` `/<app>/`, porta nos scripts, `package.json` (nome, versão `0.1.0`),
|
|
21
|
-
| 3 | **Specs fixos do front** (`app.config`, `core.providers`, `
|
|
20
|
+
| 2 | **Front**: nome do projeto no `angular.json` (`outputPath`, `buildTarget`), `baseHref` `/<app>/`, porta nos scripts, `package.json` (nome, versão `0.1.0`), `environment.ts` único com o client/realm do app e o cliente GraphQL `<app>` (URL vazia onde deve ser derivada atrás do proxy), `src/brand/` da instalação com `config/<ambiente>.json` de cada ambiente (só o que muda), `scripts/use-config.mjs` e `src/config.json` no `.gitignore`/`.dockerignore`, `features.routes.ts` vazio com o exemplo comentado, `styles.scss` mínimo, título/`lang="pt-BR"` no `index.html`, `axe-routes.config.json` com a porta e o caminho base. Tire dependências que só a base usava (editor, gráficos) | angular + trismegisto | angular `references/estrutura.md`, `references/testes-build.md` |
|
|
21
|
+
| 3 | **Specs fixos do front** (`app.config`, `core.providers`, `brand/config`, `core.component`, `features.routes`) ajustados ao app | angular | angular `references/testes-build.md` |
|
|
22
22
|
| 4 | **Gateway**: `AppModules` e `ExtendedSchema` vazios (base `_health` público, `_noop` privado em Mutation **e** Subscription — o GraphQL não aceita tipo raiz vazio), porta, `GRAPHQL_PATH`, prefixo `<app>:` nos canais, conexões Redis nomeadas por papel (`<app>-graphql-publisher`/`-subscriber`, `REDIS_CLIENT_NAME`), mensagens do `response.ts`, `.env.example` com o app do gateway no Argos | apollo + orfeu | apollo `references/estrutura-bootstrap.md` |
|
|
23
23
|
| 5 | **Testes do gateway**: manter os genéricos (subida, autorização com `_noop`, falha de subida, padrões, encerramento), tabela de rotas REST vazia, tirar os de domínio | apollo | apollo `references/testes-build.md` |
|
|
24
24
|
| 6 | **Server**: settings só com Argos, Postgres, Redis (com `redis_client_name` = `<app>-server`, `client_name` no `ConnectionPool`) e `api_docs` (`api_prefix` `/<app>/server`, porta), `AppSettings`/base declarativa do schema `<app>`, router raiz só com `/health`, `main.py` sem tarefas da base, `.env.example` com o app do server, `pyproject.toml` (poe) com a porta | fastapi + orfeu | fastapi `references/estrutura.md` |
|
package/skills/angular/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: angular
|
|
3
|
-
description: "Arquitetura de apps Angular da plataforma (22+, standalone, shell spine): estrutura de pastas, bootstrap, registro de tela por router_id, serviços GraphQL/REST com unwrap, signals, formulários, testes e
|
|
3
|
+
description: "Arquitetura de apps Angular da plataforma (22+, standalone, shell spine): estrutura de pastas, bootstrap, registro de tela por router_id, serviços GraphQL/REST com unwrap, signals, formulários, testes, build e ambiente em runtime (imagem única por versão, config.json de src/brand/config). Use ao criar ou alterar um app Angular, a parte de rotas/estado/dados de uma tela, um serviço de dados, o build ou a configuração por ambiente. A parte visual da tela (componentes hm-*, tokens, tema, ícones) é da skill trismegisto — numa tela nova use as duas; login/sessão/token é da orfeu."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# angular
|
|
@@ -28,16 +28,18 @@ Ainda não coberto por nenhuma skill: React, Strawberry, Fastify, Django, Flask.
|
|
|
28
28
|
|
|
29
29
|
```
|
|
30
30
|
meu-app/
|
|
31
|
-
├── angular.json # builder @angular/build:application, configs
|
|
31
|
+
├── angular.json # builder @angular/build:application, só configs production/development
|
|
32
32
|
├── codegen.ts # graphql-codegen (tipos + TypedDocumentNode), roda à mão
|
|
33
|
-
├── Dockerfile # estágios dev / build / site (só o /dist estático)
|
|
33
|
+
├── Dockerfile # estágios dev / build / site (só o /dist estático); build sempre production
|
|
34
|
+
├── scripts/use-config.mjs # ng serve: copia src/brand/config/<amb>.json para src/config.json (fora do git)
|
|
34
35
|
├── eslint.a11y.config.js # regras de acessibilidade de template (angular-eslint)
|
|
35
36
|
├── tsconfig.json # strict, paths src/* e package.json (sem baseUrl), resolveJsonModule
|
|
36
37
|
└── src/
|
|
37
|
-
├── main.ts # applyRuntimeEnvironment
|
|
38
|
+
├── main.ts # loadRuntimeConfig -> applyRuntimeEnvironment -> import dinâmico -> bootstrap
|
|
38
39
|
├── index.html # lang="pt-BR", favicon, tela #app-loading
|
|
39
40
|
├── styles.scss # só estilos globais do app, com tokens --hm-*
|
|
40
|
-
├── core/ # app.config.ts, core.providers.ts, core.component.ts, environments/
|
|
41
|
+
├── core/ # app.config.ts, core.providers.ts, core.component.ts, environments/ (um environment.ts)
|
|
42
|
+
├── brand/ # a instalação: brand.ts, theme.ts/.scss, assets/, config/<amb>.json (não sincronizada)
|
|
41
43
|
├── app/
|
|
42
44
|
│ ├── features/ # uma pasta por tela + features.routes.ts (mapa router_id -> tela lazy)
|
|
43
45
|
│ └── services/ # <dominio>/<dominio>.graphql|.service.ts|.models.ts|.generated.ts
|
|
@@ -49,10 +51,19 @@ Detalhes e exemplos completos: [references/estrutura.md](references/estrutura.md
|
|
|
49
51
|
|
|
50
52
|
## Regras essenciais
|
|
51
53
|
|
|
52
|
-
**
|
|
53
|
-
-
|
|
54
|
-
|
|
55
|
-
|
|
54
|
+
**Imagem única e bootstrap** (`src/main.ts`, `src/core/`, `src/brand/`)
|
|
55
|
+
- **Uma imagem por versão** (build `production` do master), a mesma em homol e prod: nada de environment
|
|
56
|
+
por ambiente no build. Um `environment.ts` base (o que não muda + URLs vazias); o que varia fica em
|
|
57
|
+
`src/brand/config/<ambiente>.json` (**só** o que muda; mesclado chave a chave, arrays/valores simples
|
|
58
|
+
substituem), publicado em `brand/config/`. Em runtime o app lê o `config.json` ao lado do `index.html`.
|
|
59
|
+
- `main.ts`: `loadRuntimeConfig(environment, { required: !isDevMode() })` (de `@trismegisto/spine`, que
|
|
60
|
+
reexporta o do `@trismegisto/primitives`) **antes de tudo**; no `.then`, `applyRuntimeEnvironment(environment)`
|
|
61
|
+
(deriva `redirectUrl`/`postLogoutRedirectUri` da origem e, atrás do proxy, `authority`/GraphQL vazios) e só
|
|
62
|
+
então `import()` dinâmico de `app.config`/componente raiz e `bootstrapApplication`. Sem top-level await
|
|
63
|
+
(Zone.js); `required: !isDevMode()`, não `environment.production` (ele só fica certo depois do config.json).
|
|
64
|
+
Não grave URL de callback fixa.
|
|
65
|
+
- `src/brand/` é a **instalação** (marca, tema, `providers.ts` quando há, assets, `config/`): cada instalação
|
|
66
|
+
tem a sua e o sync entre instalações não a copia.
|
|
56
67
|
- `app.config.ts`: `provideZoneChangeDetection({ eventCoalescing: true })` (uma vez só),
|
|
57
68
|
`provideRouter(APP_ROUTES)`, `...CORE_PROVIDERS`, `provideUi(spineConfig)`, `provideAuth(...)`,
|
|
58
69
|
`provideAutoService(...)` se o client usa auto-serviço, `provideShell({ appComponents, packageInfo })`.
|
|
@@ -91,13 +102,17 @@ Detalhes e exemplos completos: [references/estrutura.md](references/estrutura.md
|
|
|
91
102
|
sequência). Ver [references/dados.md](references/dados.md).
|
|
92
103
|
|
|
93
104
|
**Build e qualidade**
|
|
94
|
-
-
|
|
95
|
-
|
|
96
|
-
`
|
|
105
|
+
- `angular.json` só com as configurações `production` (padrão do `ng build`) e `development` (padrão do
|
|
106
|
+
`ng serve`), **sem `fileReplacements`**; `assets` publica `src/brand/config/*.json` em `brand/config/` e
|
|
107
|
+
`src/config.json` na raiz. A imagem sempre `ng build --configuration production`; o `dist` leva todos os
|
|
108
|
+
`brand/config/*.json` e nenhum `config.json` (quem escolhe é o deploy).
|
|
109
|
+
- Rodar local: `npm start` (= `local`), `start:dev`, `start:homol`, `start:prod` — cada um roda
|
|
110
|
+
`node scripts/use-config.mjs <amb>` (copia para `src/config.json`, no `.gitignore` e no `.dockerignore`)
|
|
111
|
+
e depois `ng serve`.
|
|
97
112
|
- `angular.json` > `styles`: `src/styles.scss`, `@trismegisto/tokens/tokens.css`,
|
|
98
113
|
`@trismegisto/core/core.css`.
|
|
99
114
|
- Testes: Karma + Jasmine (`@angular/build:karma`, `ng test`), com specs fixos do core (`app.config`,
|
|
100
|
-
`core.providers`, `
|
|
115
|
+
`core.providers`, `brand/config`, `features.routes`). Acessibilidade: `lint:a11y` e `axe:check`, com os
|
|
101
116
|
mesmos arquivos em todo app. Ver [references/testes-build.md](references/testes-build.md).
|
|
102
117
|
- Padrão do app inteiro (pastas do repo, portas, ambientes, scripts, saúde dos backends):
|
|
103
118
|
skill `acropole` (`references/arquitetura.md`).
|
|
@@ -139,13 +154,16 @@ Detalhes e exemplos completos: [references/estrutura.md](references/estrutura.md
|
|
|
139
154
|
- **`tsconfig.app.json` com `files: ["src/main.ts"]`**: só compila o que é alcançável a partir das
|
|
140
155
|
rotas. Tela fora do `features.routes.ts` não quebra o build — e apodrece em silêncio.
|
|
141
156
|
- **`.npmrc` copiado no Dockerfile** grava credencial na imagem; os pacotes vêm do npm público.
|
|
157
|
+
- **Import estático de `app.config`/componente raiz no `main.ts`**: o módulo lê o `environment` ao carregar,
|
|
158
|
+
antes do `config.json` chegar, e fica com as URLs vazias. Importe depois do `loadRuntimeConfig`.
|
|
159
|
+
- **Segredo em `src/brand/config/*.json`**: o arquivo é servido ao navegador. Só endereços e flags públicas.
|
|
142
160
|
|
|
143
161
|
Lista completa com contexto: [references/armadilhas.md](references/armadilhas.md).
|
|
144
162
|
|
|
145
163
|
## Referências
|
|
146
164
|
|
|
147
165
|
- [references/estrutura.md](references/estrutura.md) — pastas, `main.ts`, `app.config.ts`,
|
|
148
|
-
`core.providers.ts`,
|
|
166
|
+
`core.providers.ts`, environment + `src/brand/config`, `tsconfig`, `angular.json`, scripts, convenções.
|
|
149
167
|
- [references/features.md](references/features.md) — registro no shell, rotas próprias/públicas,
|
|
150
168
|
documentação por tela, anatomia de componente, signals, templates, formulários, a11y, i18n.
|
|
151
169
|
- [references/dados.md](references/dados.md) — GraphQL (`injectGraphqlClient`, `unwrap`, envelope,
|
|
@@ -18,6 +18,15 @@
|
|
|
18
18
|
- **Reescrever `environment` depois do bootstrap** ou esperar que uma mutação feita em um lugar seja
|
|
19
19
|
vista por serviços de chunks lazy. Derive tudo no `main.ts` antes do bootstrap; valor dinâmico de
|
|
20
20
|
verdade vai num `InjectionToken`.
|
|
21
|
+
- **Ler o `environment` antes do `config.json`**: import estático de `app.config`/componente raiz no
|
|
22
|
+
`main.ts` (o módulo lê `clientId`/URLs ao carregar) ou `required: environment.production` (o `production`
|
|
23
|
+
ainda é o do build). Bootstrap dentro do `.then` do `loadRuntimeConfig`, com `import()` dinâmico e
|
|
24
|
+
`required: !isDevMode()`. Top-level await não serve (Zone.js).
|
|
25
|
+
- **Configuração de ambiente no build** (`environment.<amb>.ts`, `fileReplacements`, `--configuration homol`):
|
|
26
|
+
gera uma imagem por ambiente e impede a promoção da mesma imagem de homol para prod.
|
|
27
|
+
- **Segredo em `src/brand/config/*.json`**: é servido ao navegador como `config.json`.
|
|
28
|
+
- **`src/config.json` commitado ou dentro da imagem**: o deploy precisa escolher o ambiente; ele fica no
|
|
29
|
+
`.gitignore` e no `.dockerignore`.
|
|
21
30
|
- **`provideZoneChangeDetection` duplicado** (no `bootstrapApplication` e no `appConfig`). Um só, no
|
|
22
31
|
`appConfig`, com `eventCoalescing: true`.
|
|
23
32
|
- **Remover `zone.js`** "porque tudo é OnPush". Zoneless exige migração dedicada e testada; libs de
|
|
@@ -71,8 +80,8 @@
|
|
|
71
80
|
### Build e entrega
|
|
72
81
|
- **Achar que `@defer` resolve o aviso de budget `initial`.** Não resolve (é CSS global + shell/auth).
|
|
73
82
|
- **Copiar `.npmrc` / credencial de registry no Dockerfile.**
|
|
74
|
-
- **`ng build` esperando configuração de dev**: o padrão do build é `
|
|
75
|
-
`development`.
|
|
83
|
+
- **`ng build` esperando configuração de dev**: o padrão do build é `production`; o padrão do `serve` é
|
|
84
|
+
`development`. Ambiente local é o `config.json` (`npm run start:<amb>`), não uma configuração do build.
|
|
76
85
|
|
|
77
86
|
## Divergências encontradas entre os apps (e o padrão recomendado)
|
|
78
87
|
|
|
@@ -83,9 +92,10 @@
|
|
|
83
92
|
| Change detection global | `provideZoneChangeDetection` uma vez x repetido no `main.ts` | uma vez, em `app.config.ts`, com `eventCoalescing` |
|
|
84
93
|
| Auth | `provideAuth(environment.authorizationServer)` x `AUTH_CONFIG` + `APP_INITIALIZER` | `provideAuth` |
|
|
85
94
|
| Environment | `src/core/environments/` com `authorizationServer` x `src/environments/` com `auth` | `src/core/environments/`, `authorizationServer` tipado como `AuthConfig` do `@orfeu/angular`, `GraphqlEndpoint` do spine |
|
|
95
|
+
| Ambiente no build | `environment.<amb>.ts` + `fileReplacements` + configuração `homol`/`prod` no `angular.json` (uma imagem por ambiente) | imagem única: um `environment.ts` base, `src/brand/config/<amb>.json` e `loadRuntimeConfig` no `main.ts` |
|
|
86
96
|
| Campos de login | interface própria com `silentRenew`/`useRefreshToken`/`postLogoutRedirectUri`/`responseType` | só o `AuthConfig` (os outros a lib não lê) |
|
|
87
97
|
| Imports absolutos | `baseUrl: "./"` (+ `ignoreDeprecations: "6.0"`) x `paths` | `paths` com `src/*` e `package.json`, sem `baseUrl` |
|
|
88
|
-
| Scripts |
|
|
98
|
+
| Scripts | `ng serve --configuration=<amb>`, `build:<amb>`, conjuntos diferentes por app | `start`, `start:dev`, `start:homol`, `start:prod` com `scripts/use-config.mjs` (`references/estrutura.md`) |
|
|
89
99
|
| Ferramentas de a11y | `@angular-eslint/*` avulsos, `@axe-core/puppeteer`, três `axe-check` diferentes | `angular-eslint` + `axe-core` com versão exata; `axe-check.js` e `eslint.a11y.config.js` idênticos |
|
|
90
100
|
| Ajuste de URL em runtime | `applyRuntimeEnvironment` x cálculo manual no `main.ts` | `applyRuntimeEnvironment` (+ só o específico do app) |
|
|
91
101
|
| Services | `src/app/services/<dominio>/` x dentro de `features/` | `src/app/services/<dominio>/` |
|
|
@@ -4,8 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
| Pasta | Conteúdo |
|
|
6
6
|
| --- | --- |
|
|
7
|
-
| `src/main.ts` |
|
|
8
|
-
| `src/core/` | `app.config.ts`, `core.providers.ts`, `core.component.ts` (raiz), `environments
|
|
7
|
+
| `src/main.ts` | `config.json` do ambiente (`loadRuntimeConfig`) + ajuste do environment em runtime + import dinâmico e `bootstrapApplication(CoreComponent, appConfig)` |
|
|
8
|
+
| `src/core/` | `app.config.ts`, `core.providers.ts`, `core.component.ts` (raiz), `environments/` (interface + **um** `environment.ts`), e o que for global do app (ex.: `app.routes.ts` quando há rota pública, `news.ts` para novidades do shell) |
|
|
9
|
+
| `src/brand/` | A **instalação**: `brand.ts` (nome, título, logos, favicon), `theme.ts`/`theme.scss`, `providers.ts` (quando o app tem provedores de login a exibir), `assets/` (publicados em `brand/`) e `config/<ambiente>.json`. Não é sincronizada entre instalações: cada uma tem a sua |
|
|
9
10
|
| `src/app/features/<tela>/` | Uma pasta por tela (componente principal, subcomponentes, modais, `README.md` de uso) |
|
|
10
11
|
| `src/app/features/features.routes.ts` | O mapa `router_id` -> tela lazy (ver `features.md`) |
|
|
11
12
|
| `src/app/services/<dominio>/` | Contrato de dados do domínio: `<dominio>.graphql`, `<dominio>.service.ts`, `<dominio>.models.ts`, `<dominio>.generated.ts` |
|
|
@@ -13,6 +14,7 @@
|
|
|
13
14
|
| `src/shared/` | Componentes, pipes e utilitários usados por mais de uma tela do app |
|
|
14
15
|
| `src/assets/` | `images/logo.svg`, `images/favicon.svg`, `favicon.ico`, fontes e tema próprio (`assets/theme/`) |
|
|
15
16
|
| `src/testing/` | Helpers de spec (envelopes falsos, nome da operação) |
|
|
17
|
+
| `scripts/use-config.mjs` | Escolhe o ambiente do `ng serve` (copia `src/brand/config/<amb>.json` para `src/config.json`) |
|
|
16
18
|
|
|
17
19
|
Regras:
|
|
18
20
|
- **Services de dados ficam em `src/app/services/`**, não dentro da pasta da tela — a tela importa o
|
|
@@ -36,37 +38,59 @@ Regras:
|
|
|
36
38
|
## `main.ts`
|
|
37
39
|
|
|
38
40
|
```ts
|
|
41
|
+
import { isDevMode } from '@angular/core';
|
|
39
42
|
import { bootstrapApplication } from '@angular/platform-browser';
|
|
40
43
|
import { registerLocaleData } from '@angular/common';
|
|
41
44
|
import localePt from '@angular/common/locales/pt';
|
|
42
|
-
import { applyRuntimeEnvironment } from '@trismegisto/spine';
|
|
45
|
+
import { applyRuntimeEnvironment, loadRuntimeConfig } from '@trismegisto/spine';
|
|
43
46
|
|
|
44
|
-
import { CoreComponent } from 'src/core/core.component';
|
|
45
|
-
import { appConfig } from 'src/core/app.config';
|
|
46
47
|
import { environment } from 'src/core/environments/environment';
|
|
47
48
|
|
|
48
49
|
// Necessário se alguma tela usa DatePipe/CurrencyPipe com 'pt-BR' (senão NG0701).
|
|
49
50
|
registerLocaleData(localePt);
|
|
50
51
|
|
|
51
|
-
//
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
52
|
+
// Imagem única: o ambiente vem do config.json ao lado do index.html (cópia de src/brand/config/<amb>.json,
|
|
53
|
+
// feita pelo deploy ou pelo scripts/use-config.mjs). Obrigatório no build de produção; no ng serve só avisa.
|
|
54
|
+
loadRuntimeConfig(environment, { required: !isDevMode() })
|
|
55
|
+
.then(async () => {
|
|
56
|
+
// Callback/logoff/authority/GraphQL derivados de onde o app está rodando.
|
|
57
|
+
const { origin, basePath, behindProxy, unset } = applyRuntimeEnvironment(environment);
|
|
58
|
+
|
|
59
|
+
// Só se o app tiver uma URL própria além das que o spine deriva (ex.: uma API REST no mesmo prefixo).
|
|
60
|
+
if (behindProxy && unset(environment.minhaApiUrl)) {
|
|
61
|
+
environment.minhaApiUrl = `${origin}${basePath}/server`;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// Import dinâmico: app.config/CoreComponent leem o environment ao carregar; um import estático rodaria
|
|
65
|
+
// antes do config.json chegar.
|
|
66
|
+
const [{ CoreComponent }, { appConfig }] = await Promise.all([
|
|
67
|
+
import('src/core/core.component'),
|
|
68
|
+
import('src/core/app.config'),
|
|
69
|
+
]);
|
|
70
|
+
await bootstrapApplication(CoreComponent, appConfig);
|
|
71
|
+
document.getElementById('app-loading')?.remove();
|
|
72
|
+
})
|
|
61
73
|
.catch((err) => console.error(err));
|
|
62
74
|
```
|
|
63
75
|
|
|
76
|
+
- `loadRuntimeConfig(environment, { file?, required? })` (do `@trismegisto/primitives`, reexportado pelo
|
|
77
|
+
`@trismegisto/spine`) busca `config.json` (ou `file`) relativo ao `<base href>` e o mescla no objeto
|
|
78
|
+
`environment`: objetos chave a chave, arrays e valores simples substituem. Com `required`, falta ou JSON
|
|
79
|
+
inválido rejeita a promise (o app não sobe: erro de deploy); sem, só avisa no console.
|
|
80
|
+
- `required: !isDevMode()`, **não** `environment.production`: o `production` também vem do `config.json`, então
|
|
81
|
+
só está certo depois dele.
|
|
82
|
+
- **Sem top-level await** no `main.ts`: o Angular não o aceita com Zone.js. Encadeie com `.then`.
|
|
83
|
+
- **Import dinâmico** de `app.config` e do componente raiz quando algum módulo lê o `environment` no carregamento
|
|
84
|
+
(ex.: `clientId`/URL num provider montado no topo do arquivo). Se nenhum lê, import estático é seguro — mas o
|
|
85
|
+
primeiro que passar a ler quebra em silêncio (fica com o valor vazio do build); prefira o dinâmico.
|
|
64
86
|
- `applyRuntimeEnvironment` sempre reescreve `redirectUrl` (`<origem><prefixo>/callback`) e
|
|
65
87
|
`postLogoutRedirectUri` (`.../logoff`). Atrás de proxy (URL sem porta) também deriva `authority` e
|
|
66
88
|
cada endpoint GraphQL **ainda sem valor real** (vazio ou contendo `CHANGE_ME`). URL explícita no
|
|
67
|
-
|
|
89
|
+
`config.json` sempre ganha. Chame **depois** do `loadRuntimeConfig`.
|
|
68
90
|
- Mexa no objeto `environment` **só aqui, antes do bootstrap**. Valor que precisa ser recalculado
|
|
69
91
|
depois e lido por serviços em chunks lazy vai num `InjectionToken`, não em mutação do environment.
|
|
92
|
+
- App sem o shell (ex.: uma tela de login que é o próprio provedor OAuth) importa `loadRuntimeConfig` direto do
|
|
93
|
+
`@trismegisto/primitives` e não usa `applyRuntimeEnvironment` (que deriva a config de um client OAuth).
|
|
70
94
|
- A remoção do `#app-loading` (definido no `index.html`) é opcional, mas recomendada.
|
|
71
95
|
|
|
72
96
|
## `src/core/app.config.ts`
|
|
@@ -153,17 +177,39 @@ export class CoreComponent {}
|
|
|
153
177
|
Não monte modal/side panel/notificação do shell aqui: o layout do spine já os renderiza. O título da
|
|
154
178
|
aba vem do `index.html` (ou `Title` no componente, se precisar mudar em runtime).
|
|
155
179
|
|
|
156
|
-
##
|
|
180
|
+
## Environment e `src/brand/config/` (imagem única)
|
|
157
181
|
|
|
158
|
-
|
|
182
|
+
A imagem é **uma por versão** (build `production` do master), a mesma em homologação e produção. Nada de
|
|
183
|
+
environment por ambiente no build:
|
|
159
184
|
|
|
160
185
|
| Arquivo | Uso |
|
|
161
186
|
| --- | --- |
|
|
162
|
-
| `environment.config.ts` | Interface `Environment` |
|
|
163
|
-
| `environment.ts` |
|
|
164
|
-
| `
|
|
187
|
+
| `src/core/environments/environment.config.ts` | Interface `Environment` |
|
|
188
|
+
| `src/core/environments/environment.ts` | **Único**: o que é igual em toda parte (`clientId`, `realmId`, `scope`, `production: false`) e URLs vazias |
|
|
189
|
+
| `src/brand/config/<ambiente>.json` | **Só o que muda** naquele ambiente (URLs, `production: true` em homol/prod), mesclado em runtime |
|
|
190
|
+
| `src/config.json` | Cópia local do ambiente escolhido para o `ng serve` (`scripts/use-config.mjs`); no `.gitignore` e no `.dockerignore` |
|
|
191
|
+
|
|
192
|
+
Exemplo de `src/brand/config/homol.json` (só o que difere do `environment.ts`):
|
|
193
|
+
|
|
194
|
+
```json
|
|
195
|
+
{
|
|
196
|
+
"production": true,
|
|
197
|
+
"adminApi": "https://homol.exemplo.com/argos/admin/api",
|
|
198
|
+
"authorizationServer": { "authority": "https://homol.exemplo.com/argos" },
|
|
199
|
+
"graphql": {
|
|
200
|
+
"pedidos": { "http": "https://homol.exemplo.com/app-exemplo/graphql", "ws": "wss://homol.exemplo.com/app-exemplo/graphql" }
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
```
|
|
165
204
|
|
|
166
|
-
|
|
205
|
+
Quem escolhe o arquivo:
|
|
206
|
+
- **Deploy de site**: o talos copia `brand/config/<ambiente>.json` para `config.json` no site publicado.
|
|
207
|
+
- **Front servido por um servidor do app** (service com UI): o container recebe `APP_ENV=<ambiente>` e o servidor
|
|
208
|
+
serve `<prefixo>/config.json` a partir de `brand/config/${APP_ENV}.json` (lido e validado na subida; em produção,
|
|
209
|
+
`APP_ENV` ausente ou arquivo inexistente derruba a subida).
|
|
210
|
+
- **`ng serve`**: `node scripts/use-config.mjs <ambiente>` (os scripts `start*` já chamam).
|
|
211
|
+
|
|
212
|
+
Campos da interface (só os nomes):
|
|
167
213
|
|
|
168
214
|
```ts
|
|
169
215
|
import type { AuthConfig } from '@orfeu/angular'; // não redeclarar
|
|
@@ -180,16 +226,21 @@ export interface Environment {
|
|
|
180
226
|
- O tipo do login é o `AuthConfig` da própria lib. Campos que ela não lê (`silentRenew`, `useRefreshToken`,
|
|
181
227
|
`postLogoutRedirectUri`, `responseType`) não entram no environment: são configuração morta — a renovação
|
|
182
228
|
é automática e o `applyRuntimeEnvironment` cuida de callback/logoff.
|
|
183
|
-
-
|
|
184
|
-
|
|
229
|
+
- Ambientes da instalação = arquivos em `src/brand/config/` (`local`, `dev`, `homol`, `prod`, os que existirem).
|
|
230
|
+
Nome em minúsculas, `a-z0-9-` (vira nome de arquivo no deploy).
|
|
231
|
+
- `config/<ambiente>.json` traz **só** o que varia. `clientId`, `realmId`, `scope`, `redirectUrl` e `namedClient`
|
|
232
|
+
ficam no `environment.ts`.
|
|
185
233
|
- A chave de `graphql` e o `namedClient` costumam ser o mesmo nome (`pedidos: { namedClient: 'pedidos', ... }`).
|
|
186
|
-
-
|
|
187
|
-
|
|
188
|
-
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
234
|
+
- URL vazia (ou `CHANGE_ME`) no `environment.ts` = derivada em runtime atrás do proxy; URL explícita no
|
|
235
|
+
`config.json` sempre ganha.
|
|
236
|
+
- Segredo nunca entra em environment nem em `config/*.json`: tudo ali vai para o navegador.
|
|
237
|
+
- Layouts antigos (`environment.<amb>.ts` trocados por `fileReplacements`, `src/environments/` fora de `core/`,
|
|
238
|
+
`auth` em vez de `authorizationServer`) existem em apps mais velhos; não copiar. Migrar: um `environment.ts`
|
|
239
|
+
base, o que diferia vira `src/brand/config/<amb>.json`, apague os `environment.<amb>.ts` e as configurações
|
|
240
|
+
de ambiente do `angular.json`.
|
|
241
|
+
- `src/brand/config.spec.ts` confere que todos os `config/*.json` têm as mesmas chaves, que nada fixo do build
|
|
242
|
+
(`clientId`, `realmId`, `scope`, `redirectUrl`) aparece neles, que `production` só é `true` em homol/prod e
|
|
243
|
+
que nenhuma URL tem barra final.
|
|
193
244
|
|
|
194
245
|
## `tsconfig.json`
|
|
195
246
|
|
|
@@ -224,30 +275,41 @@ declare module '*.md' {
|
|
|
224
275
|
"browser": "src/main.ts",
|
|
225
276
|
"polyfills": ["zone.js"],
|
|
226
277
|
"inlineStyleLanguage": "scss",
|
|
227
|
-
"assets": [
|
|
278
|
+
"assets": [
|
|
279
|
+
{ "glob": "**/*", "input": "src/assets", "output": "assets" },
|
|
280
|
+
{ "glob": "**/*", "input": "src/brand/assets", "output": "brand" },
|
|
281
|
+
{ "glob": "*.json", "input": "src/brand/config", "output": "brand/config" },
|
|
282
|
+
{ "glob": "config.json", "input": "src", "output": "/" } // só existe no ng serve (use-config)
|
|
283
|
+
],
|
|
228
284
|
"styles": [
|
|
229
285
|
"src/styles.scss",
|
|
230
286
|
"@trismegisto/tokens/tokens.css",
|
|
231
287
|
"@trismegisto/core/core.css"
|
|
232
288
|
],
|
|
233
|
-
"loader": { ".md": "text" }
|
|
289
|
+
"loader": { ".md": "text" }, // só se houver documentação por tela
|
|
290
|
+
"baseHref": "/meu-app/"
|
|
291
|
+
},
|
|
292
|
+
"configurations": {
|
|
293
|
+
"production": { "budgets": [ /* ver testes-build.md */ ], "outputHashing": "all" },
|
|
294
|
+
"development": { "optimization": false, "extractLicenses": false, "sourceMap": true }
|
|
234
295
|
},
|
|
296
|
+
"defaultConfiguration": "production"
|
|
297
|
+
},
|
|
298
|
+
"serve": {
|
|
299
|
+
"builder": "@angular/build:dev-server",
|
|
235
300
|
"configurations": {
|
|
236
|
-
"
|
|
237
|
-
|
|
238
|
-
"fileReplacements": [{ "replace": "src/core/environments/environment.ts",
|
|
239
|
-
"with": "src/core/environments/environment.prod.ts" }] },
|
|
240
|
-
"homol": { "...": "idem com environment.homol.ts" },
|
|
241
|
-
"dev": { "optimization": false, "sourceMap": true, "...": "environment.dev.ts" },
|
|
242
|
-
"local": { "optimization": false, "sourceMap": true, "...": "environment.local.ts" },
|
|
243
|
-
"development": { "optimization": false, "sourceMap": true }
|
|
301
|
+
"production": { "buildTarget": "meu-app:build:production" },
|
|
302
|
+
"development": { "buildTarget": "meu-app:build:development" }
|
|
244
303
|
},
|
|
245
|
-
"defaultConfiguration": "
|
|
304
|
+
"defaultConfiguration": "development"
|
|
246
305
|
},
|
|
247
|
-
"serve": { "builder": "@angular/build:dev-server", "defaultConfiguration": "development" },
|
|
248
306
|
"test": { "builder": "@angular/build:karma" }
|
|
249
307
|
```
|
|
250
308
|
|
|
309
|
+
- **Só `production` e `development`**, sem `fileReplacements`: o ambiente não é decidido no build. Um
|
|
310
|
+
`--configuration homol` (ou `ARG CONFIGURATION=homol`) é resto do modelo antigo.
|
|
311
|
+
- O `dist` leva `brand/config/*.json` de todos os ambientes e **nenhum** `config.json` (o `src/config.json` do
|
|
312
|
+
`ng serve` fica fora da imagem pelo `.dockerignore`).
|
|
251
313
|
- Use o builder `@angular/build:*`; `@angular-devkit/build-angular:*` é o formato antigo.
|
|
252
314
|
- `baseHref` = prefixo sob o qual o app é servido (o `applyRuntimeEnvironment` lê de `document.baseURI`).
|
|
253
315
|
- `cli.cache.environment: "all"` liga o cache do CLI também no build (útil no Docker).
|
|
@@ -258,13 +320,11 @@ Os mesmos scripts, na mesma ordem, em todo app (só a porta muda):
|
|
|
258
320
|
|
|
259
321
|
```json
|
|
260
322
|
"ng": "ng",
|
|
261
|
-
"start": "ng serve --port 4200",
|
|
262
|
-
"dev": "ng serve --
|
|
263
|
-
"start:
|
|
264
|
-
"start:
|
|
323
|
+
"start": "node scripts/use-config.mjs local && ng serve --host 0.0.0.0 --port 4200 --no-hmr",
|
|
324
|
+
"start:dev": "node scripts/use-config.mjs dev && ng serve --host 0.0.0.0 --port 4200 --no-hmr",
|
|
325
|
+
"start:homol": "node scripts/use-config.mjs homol && ng serve --host 0.0.0.0 --port 4200 --no-hmr",
|
|
326
|
+
"start:prod": "node scripts/use-config.mjs prod && ng serve --host 0.0.0.0 --port 4200 --no-hmr",
|
|
265
327
|
"build": "ng build",
|
|
266
|
-
"build:dev": "ng build --configuration dev",
|
|
267
|
-
"build:homol": "ng build --configuration homol",
|
|
268
328
|
"watch": "ng build --watch --configuration development",
|
|
269
329
|
"test": "ng test",
|
|
270
330
|
"lint:a11y": "eslint --config eslint.a11y.config.js \"src/**/*.html\"",
|
|
@@ -274,6 +334,14 @@ Os mesmos scripts, na mesma ordem, em todo app (só a porta muda):
|
|
|
274
334
|
|
|
275
335
|
Ferramentas com versão exata nos `devDependencies`, iguais entre os apps: `angular-eslint`, `eslint`,
|
|
276
336
|
`typescript-eslint`, `axe-core`, `puppeteer` (nada de `@angular-eslint/*` avulsos nem `@axe-core/puppeteer`).
|
|
277
|
-
|
|
337
|
+
Nada de `build:<amb>` nem `--configuration=<amb>`: o build é um só. `start:<amb>` só funciona se a instalação tiver
|
|
338
|
+
`src/brand/config/<amb>.json` (o `use-config` falha listando os que existem).
|
|
339
|
+
|
|
340
|
+
### `scripts/use-config.mjs`
|
|
341
|
+
|
|
342
|
+
Recebe o ambiente (argumento; sem ele, `APP_ENV`; sem ele, `local`), valida o nome (`[\w-]+`), confere que
|
|
343
|
+
`src/brand/config/<amb>.json` existe e é um objeto JSON e o copia para `src/config.json`, que o `angular.json`
|
|
344
|
+
publica como `config.json`. É o mesmo arquivo que o deploy usa, então o `ng serve` roda com os endereços reais do
|
|
345
|
+
ambiente escolhido. `src/config.json` vai no `.gitignore` e no `.dockerignore`.
|
|
278
346
|
|
|
279
347
|
Cada app usa uma porta fixa própria no dev-server para não colidir com os outros.
|
|
@@ -47,7 +47,7 @@ describe('features.routes', () => {
|
|
|
47
47
|
| --- | --- |
|
|
48
48
|
| `src/core/app.config.spec.ts` | Monta os providers num `createEnvironmentInjector` filho do TestBed (sem bootstrap; filtra o `CORE_PROVIDERS[0]`, as animações) e lê os tokens: `SPINE_CONFIG` (clientId, appName, logo), `ROUTES` contém `APP_ROUTES`, `AUTH_CONFIG` = `environment.authorizationServer` e `AUTH_OPTIONS.eagerInit`, `AUTO_SERVICE_CONFIG`/`SPINE_ADMIN_API`, `COMPONENT_ROUTES` com as telas do app + `BASE_COMPONENTS`, `APP_PACKAGE_INFO` |
|
|
49
49
|
| `src/core/core.providers.spec.ts` | São três (animações, HttpClient, GraphQL); `ANIMATION_MODULE_TYPE` = `BrowserAnimations`; o HttpClient passa pelos interceptors do DI; um cliente Apollo por endpoint do environment (`PLATFORM_ID` = `server` para não abrir WebSocket) |
|
|
50
|
-
| `src/
|
|
50
|
+
| `src/brand/config.spec.ts` | Todos os `src/brand/config/*.json` com as mesmas chaves, nada fixo do build neles (`clientId`, `realmId`, `scope`, `redirectUrl`), `production` só em homol/prod, URLs absolutas e sem barra final, `ws` = `http` com `ws(s)://` |
|
|
51
51
|
| `src/core/core.component.spec.ts` | Título da aba |
|
|
52
52
|
| `src/app/features/features.routes.spec.ts` | Ids UUID únicos (sem diferenciar maiúsculas), todo `load()` standalone, documentação carregável |
|
|
53
53
|
|
|
@@ -175,22 +175,25 @@ avisa das que não têm. As URLs vêm do Argos em runtime: o `routeIdToPath` é
|
|
|
175
175
|
}
|
|
176
176
|
```
|
|
177
177
|
|
|
178
|
-
- `baseUrl` = origem **e** caminho base do `start
|
|
178
|
+
- `baseUrl` = origem **e** caminho base do `npm start` (o `baseHref` do `angular.json`); as rotas
|
|
179
179
|
são resolvidas a partir dele (`/login` → `…/meu-app/login`). Sem o caminho base, o axe audita a página 404.
|
|
180
180
|
- Rotas logadas exigem `AXE_STORAGE_STATE=<json com cookies/localStorage>`; sem ele, o que redireciona para
|
|
181
181
|
`/login` é relatado como "sem auth", não como violação. `AXE_FAIL_ON` (padrão `serious`) define a saída 1.
|
|
182
182
|
|
|
183
183
|
## Build
|
|
184
184
|
|
|
185
|
-
| Configuração | Para quê |
|
|
186
|
-
| --- | --- |
|
|
187
|
-
| `
|
|
188
|
-
| `
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
185
|
+
| Configuração | Para quê |
|
|
186
|
+
| --- | --- |
|
|
187
|
+
| `production` (**padrão** do `ng build`) | a imagem: otimizado, `outputHashing: all`, budgets. Uma só para todos os ambientes |
|
|
188
|
+
| `development` | padrão do `ng serve`: sem otimização, com source map |
|
|
189
|
+
|
|
190
|
+
Não há configuração por ambiente nem `fileReplacements`: o ambiente vem em runtime do `config.json`
|
|
191
|
+
(`src/brand/config/<amb>.json`, ver `estrutura.md`). `ng build` (= `--configuration production`); saída em
|
|
192
|
+
`dist/<outputPath>/browser`, com `brand/config/*.json` de todos os ambientes e **sem** `config.json`.
|
|
192
193
|
|
|
193
|
-
|
|
194
|
+
Conferir o build como o deploy o usa: copie `dist/<outputPath>/browser/brand/config/homol.json` para
|
|
195
|
+
`.../browser/config.json` e sirva a pasta sob o `baseHref`. Sem o `config.json`, o app de produção não sobe e
|
|
196
|
+
o console mostra o erro do `loadRuntimeConfig` — é o comportamento esperado.
|
|
194
197
|
|
|
195
198
|
### Budgets
|
|
196
199
|
|
|
@@ -228,7 +231,9 @@ RUN --mount=type=cache,target=/root/.npm,sharing=locked \
|
|
|
228
231
|
timeout -k 10 600 npm ci --prefer-offline --no-audit --no-fund
|
|
229
232
|
COPY . .
|
|
230
233
|
EXPOSE 4200
|
|
231
|
-
|
|
234
|
+
# Ambiente do ng serve em runtime: APP_ENV (padrão dev) escolhe src/brand/config/<APP_ENV>.json.
|
|
235
|
+
ENV APP_ENV=dev
|
|
236
|
+
CMD ["sh", "-c", "node scripts/use-config.mjs \"$APP_ENV\" && exec ./node_modules/.bin/ng serve --host 0.0.0.0 --no-hmr --port 4200"]
|
|
232
237
|
|
|
233
238
|
FROM node:22-slim AS build
|
|
234
239
|
WORKDIR /app
|
|
@@ -236,12 +241,13 @@ COPY package.json package-lock.json ./
|
|
|
236
241
|
RUN --mount=type=cache,target=/root/.npm,sharing=locked \
|
|
237
242
|
timeout -k 10 600 npm ci --prefer-offline --no-audit --no-fund
|
|
238
243
|
COPY . .
|
|
239
|
-
#
|
|
240
|
-
|
|
244
|
+
# Imagem única: sempre production, sem ARG CONFIGURATION (um --build-arg antigo só gera aviso de argumento
|
|
245
|
+
# não usado). O ambiente vem em runtime do config.json que o deploy gera.
|
|
241
246
|
RUN --mount=type=cache,target=/app/.angular/cache,sharing=locked \
|
|
242
|
-
timeout -k 10 300 ./node_modules/.bin/ng build --configuration
|
|
247
|
+
timeout -k 10 300 ./node_modules/.bin/ng build --configuration production
|
|
243
248
|
|
|
244
|
-
# Imagem só para extrair o site (docker create + docker cp): o build estático em /dist
|
|
249
|
+
# Imagem só para extrair o site (docker create + docker cp): o build estático em /dist, com
|
|
250
|
+
# brand/config/<amb>.json de todos os ambientes e nenhum config.json (o talos gera no deploy).
|
|
245
251
|
FROM scratch AS site
|
|
246
252
|
COPY --from=build /app/dist/meu-app/browser /dist
|
|
247
253
|
CMD ["unused"]
|
|
@@ -250,8 +256,10 @@ CMD ["unused"]
|
|
|
250
256
|
- `timeout -k` em passo que baixa/compila: build travado não fica rodando para sempre.
|
|
251
257
|
- **Não copie `.npmrc`** nem passe credencial por `ARG`/`ENV`: fica gravado na imagem. Os pacotes
|
|
252
258
|
`@trismegisto/*` e `@orfeu/*` vêm do npm público.
|
|
253
|
-
- `.dockerignore` com `node_modules`, `dist`, `.angular
|
|
259
|
+
- `.dockerignore` com `node_modules`, `dist`, `.angular` e `src/config.json` (o do `ng serve` nunca entra
|
|
260
|
+
na imagem).
|
|
254
261
|
- Para servir com nginx (ou outro servidor estático): copie `/dist` para o `root`, sirva sob o mesmo
|
|
255
262
|
prefixo do `baseHref` e faça fallback de SPA para o `index.html`
|
|
256
263
|
(`try_files $uri $uri/ /<prefixo>/index.html;`). Arquivos com hash podem ter cache longo;
|
|
257
|
-
`index.html` sem cache.
|
|
264
|
+
`index.html` e `config.json` sem cache. Quem serve também precisa gerar o `config.json` do ambiente
|
|
265
|
+
(copiar `brand/config/<amb>.json`), como o talos faz.
|