[PBI] Vincular identidade imutável a workspaces fiscais

[elson-vinicius-lopes]

PBI pai

#195

Problema

Hoje a sessão expõe apenas nome de exibição e o produto não possui workspace durável. Nome/e-mail não podem ser chave de propriedade fiscal.

Hipótese de valor

Amarrar provider + tenant/issuer + subject a um UserId interno permite preservar histórico e memberships mesmo se o e-mail mudar.

Aceite

• BFF remove headers forjados e encaminha principal apenas ao upstream confiável.
• API resolve ExternalIdentity para UserId interno.
• GET /api/workspaces/me cria workspace pessoal idempotente.
• Front possui shell e seletor com loading/vazio/erro/acesso negado.
• Nenhum subject bruto é exposto ao JavaScript ou log.
• Usuário A não acessa workspace B alterando a URL.

Dependência

Contrato cross-repo documentado em docs/contracts/fiscal-workspace-and-mapping-explanation-api.md.

[elson-vinicius-lopes]

Progresso da fundação no consumidor

Implementação inicial concluída no commit local a90f5b2 da branch codex/feat-fiscal-workspaces-foundation:

• BFF preserva provider, subject e tenantId da sessão OIDC;
• remove headers homônimos enviados pelo navegador e os reinsere somente no proxy confiável;
• /api/session não expõe subject;
• tipos e service de workspace/analyses/mapping explanation preparados;
• contratos ainda marcados availability: proposed, sem tela ou persistência local falsa.

Evidência: npm run quality verde — 257 testes React, 70 BFF, builds, auditorias sem vulnerabilidades e contrato 16/16 (3 propostos).

Dependência ativa: LayoutParserApi#225 e #226. O PBI permanece In Progress.

[elson-vinicius-lopes]

Integração do Slice 1 implementada no PR #208. O front agora consome /api/workspaces/me, valida o contrato em runtime, mantém a seleção somente em memória e entrega shell/seletor/estados acessíveis. Gates locais:
pm run quality PASS e E2E 20/20 desktop/mobile. Movido para In Review; aceite final depende dos checks/deployment em development.

[elson-vinicius-lopes]

Validação operacional concluída em development no commit �969984: o primeiro deploy expôs que /api/workspaces/me concorrente bloqueava o E2E real de /api/parse/auto; o hotfix #209 isolou o bootstrap na rota /workspace. Após a correção, o gate MQSeries real passou em 1,9 min e o workflow publicou com sucesso no IIS (run 33435521680). Item movido para In Validation; promoção a produção permanece uma decisão separada.