@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 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" |
@@ -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 ambiente na subida, não
49
- gravados no build (`ARG` virando `ENV` com valor de produção, `environment.prod.ts` com segredo).
50
- Front estático: só o `/dist` no estágio final. FastAPI em produção com `/docs`, `/openapi.json` e
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*`; script `.sh` no
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.6.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 | `--configuration <ambiente>` (build/serve) | `src/core/environments/environment.<ambiente>.ts` (versionados, sem segredo); `environment.ts` = `local` |
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`, `dev`, `start:local`, `start:homol`, `build` (prod), `build:dev`, `build:homol`, `watch`, `test`, `lint:a11y`, `axe:check`, `codegen` |
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`, `environments.spec`, `core.component.spec`, `features.routes.spec` (UUID único, `load()` standalone, documento carregável) + spec de toda tela nova/alterada |
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`), environments dos quatro ambientes com o client/realm do app e o cliente GraphQL `<app>` (`CHANGE_ME` onde a URL deve ser derivada atrás do proxy), `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`, `environments`, `core.component`, `features.routes`) ajustados ao app | angular | angular `references/testes-build.md` |
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` |
@@ -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 build. Use ao criar ou alterar um app Angular, a parte de rotas/estado/dados de uma tela, um serviço de dados ou o build. 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."
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 prod/dev/homol/local/development
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(environment) + bootstrapApplication
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
- **Bootstrap** (`src/core/`)
53
- - `main.ts` chama `applyRuntimeEnvironment(environment)` (de `@trismegisto/spine`) **antes** do
54
- `bootstrapApplication`: deriva `redirectUrl`/`postLogoutRedirectUri` da origem atual e, atrás do
55
- proxy, `authority` e endpoints GraphQL ainda com `CHANGE_ME`. Não grave URL de callback fixa.
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
- - Build de produção: `ng build --configuration prod` (é a `defaultConfiguration`, então `ng build`
95
- basta). Outras: `dev`, `homol`, `local` (troca o `environment.ts` por `fileReplacements`) e
96
- `development` (só para `ng serve`).
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`, `environments`, `features.routes`). Acessibilidade: `lint:a11y` e `axe:check`, com os
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`, environments, `tsconfig`, `angular.json`, convenções de nome e imports.
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 é `prod`; o padrão do `serve` é
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 | apps sem `start:homol`, com `start:prod`, `dev` sem `--configuration=dev` | o mesmo conjunto em todo app (`references/estrutura.md`) |
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` | Ajuste do environment em runtime + `bootstrapApplication(CoreComponent, appConfig)` |
8
- | `src/core/` | `app.config.ts`, `core.providers.ts`, `core.component.ts` (raiz), `environments/`, e o que for global do app (ex.: `app.routes.ts` quando há rota pública, `news.ts` para novidades do shell) |
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
- // Callback/logoff/authority/GraphQL derivados de onde o app está rodando.
52
- const { origin, basePath, behindProxy, unset } = applyRuntimeEnvironment(environment);
53
-
54
- // Só se o app tiver uma URL própria além das que o spine deriva (ex.: uma API REST no mesmo prefixo).
55
- if (behindProxy && unset(environment.minhaApiUrl)) {
56
- environment.minhaApiUrl = `${origin}${basePath}/server`;
57
- }
58
-
59
- bootstrapApplication(CoreComponent, appConfig)
60
- .then(() => document.getElementById('app-loading')?.remove())
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
- environment sempre ganha.
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
- ## Environments
180
+ ## Environment e `src/brand/config/` (imagem única)
157
181
 
158
- Arquivos em `src/core/environments/`:
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` | Base (é o que os imports referenciam) |
164
- | `environment.prod.ts`, `.homol.ts`, `.dev.ts`, `.local.ts` | Trocados por `fileReplacements` na configuração de build homônima |
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
- Campos (só os nomes; os valores são de cada ambiente):
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
- - Um arquivo por ambiente, **só** `local`, `dev`, `homol` e `prod`; `environment.ts` é igual ao `local`.
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
- - Use `CHANGE_ME` em URL que deve ser derivada em runtime atrás do proxy.
187
- - Segredo nunca entra em environment: tudo ali vai para o bundle público.
188
- - Layout antigo `src/environments/` (fora de `core/`) e nomes de campo diferentes (`auth` em vez de
189
- `authorizationServer`) existem em apps mais velhos; não copiar.
190
- - `src/core/environments/environments.spec.ts` confere que os cinco arquivos têm as mesmas chaves, que só o
191
- `prod` é `production`, que `environment.ts` é igual ao `local`, client/realm iguais em todos e nenhuma URL
192
- com barra final.
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": [{ "glob": "**/*", "input": "src/assets", "output": "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" } // só se houver documentação por tela
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
- "prod": { "budgets": [ /* ver testes-build.md */ ], "outputHashing": "all",
237
- "baseHref": "/meu-app/",
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": "prod"
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 --configuration=dev --port 4200 --no-hmr",
263
- "start:local": "ng serve --configuration=local --host 0.0.0.0 --port 4200 --no-hmr",
264
- "start:homol": "ng serve --configuration=homol --host 0.0.0.0 --port 4200 --no-hmr",
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
- Script de serve com configuração inexistente no `angular.json` quebra só quando alguém roda: confira.
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/core/environments/environments.spec.ts` | Mesmas chaves nos cinco arquivos, só `prod` é `production`, `environment.ts` = `local`, client/realm iguais, URLs sem barra final |
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:local` (o `baseHref` da configuração `local`); as rotas
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ê | Environment |
186
- | --- | --- | --- |
187
- | `prod` (**padrão** do `ng build`) | produção: otimizado, `outputHashing: all`, budgets | `environment.prod.ts` |
188
- | `homol` | homologação | `environment.homol.ts` |
189
- | `dev` | ambiente de desenvolvimento em container | `environment.dev.ts` |
190
- | `local` | `ng serve` nativo apontando para serviços locais | `environment.local.ts` |
191
- | `development` | padrão do `ng serve`, sem troca de environment | `environment.ts` |
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
- `ng build --configuration prod` (ou só `ng build`). Saída em `dist/<outputPath>/browser`.
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
- CMD ["./node_modules/.bin/ng", "serve", "--configuration", "dev", "--host", "0.0.0.0", "--no-hmr", "--port", "4200"]
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
- # ARG depois do install: declarado antes, cada ambiente invalidaria o cache do npm ci.
240
- ARG CONFIGURATION=prod
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 $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.