170 lines
8.4 KiB
Markdown
170 lines
8.4 KiB
Markdown
# Arch Panel
|
|
|
|
Extensao Chrome Manifest V3 que injeta o Arch Panel em paginas Oracle usadas pelo time de arquitetura, incluindo Workload Workbench e HCM FuseWelcome.
|
|
|
|
## Entry points
|
|
|
|
- `manifest.json`: fonte oficial da versao, permissoes e content scripts.
|
|
- `src/shared/config.js`: configuracao centralizada, constantes, IDs, endpoints e chaves de cache.
|
|
- `src/shared/utils.js`: helpers compartilhados de strings, numeros, datas, DOM, escaping e extração de payloads.
|
|
- `src/background/config.js`: configuracao especifica do service worker e URLs usadas pelos proxies de background.
|
|
- `src/content/styles.css`: estilos da UI injetados pelo Manifest V3.
|
|
- `src/content/shell-view.js`: shell visual injetado na pagina, incluindo tema, cores, alvo de insercao e scroll lock.
|
|
- `src/content/templates.js`: templates estaticos de DOM usados pelo content script.
|
|
- `src/content/hcm-page.js`: integracao com FuseWelcome, injecao do tile HCM e captura do token Worklist via iframe.
|
|
- `src/content/modal-events.js`: controller de eventos delegados da modal, incluindo clicks, inputs e navegacao por teclado.
|
|
- `src/content/workbench-controller.js`: controller de Workbench, dataset, refresh, detalhes, actions, forecast e calendario.
|
|
- `src/content/manage-time-controller.js`: controller da modal Manage Time, incluindo carregamento, diff, foco, validacao e gravacao.
|
|
- `src/content/export-html.js`: geracao do relatorio HTML standalone baixado pelo usuario.
|
|
- `src/repositories/workbench-repository.js`: acesso e normalizacao de dados do Workload Workbench e Worklist user API.
|
|
- `src/repositories/comcip-repository.js`: acesso e normalizacao de dados COMCIP, Manage Time e Service Requests.
|
|
- `src/repositories/cache-repository.js`: persistencia dos payloads de dashboard, task types e token Worklist no IndexedDB.
|
|
- `src/domain/ramp-forecast.js`: regras puras de calculo de ramp, delta de forecast e payload de atualizacao de forecast.
|
|
- `src/domain/workload-dataset.js`: regras puras de normalizacao de workloads, snapshots, export payloads e indicadores do dashboard.
|
|
- `src/domain/workload-calendar.js`: regras puras para calendario mensal/semanal de inicio dos workloads.
|
|
- `src/domain/time-management.js`: regras puras de diff, assinatura, payload, validacao e datas do Manage time.
|
|
- `src/domain/time-management-data.js`: normalizacao de payloads, options e DTOs usados pela modal Manage time.
|
|
- `src/services/storage-service.js`: infraestrutura generica de IndexedDB.
|
|
- `src/services/chrome-service.js`: wrappers Promise-based para APIs do Chrome usadas pelo content script.
|
|
- `src/services/preferences-service.js`: persistencia local de preferencias visuais e ultima data selecionada no Manage Time.
|
|
- `src/services/transport-service.js`: camada de transporte, page bridge, iframes autenticados e requests via background.
|
|
- `src/views/render-helpers.js`: helpers reutilizaveis de apresentacao para tabelas, links e resumo do header.
|
|
- `content-script.js`: entrypoint principal da UI e orquestracao de estado, eventos e requests.
|
|
- `page-bridge.js`: bridge executada no contexto da pagina SPA para capturar e reutilizar headers autorizados.
|
|
- `background.js`: service worker responsavel por proxy de requests, descoberta de frames e execucao em frames autenticados.
|
|
- `tools/bump-extension-version.ps1`: script obrigatorio para atualizar a versao da extensao.
|
|
|
|
## Estrutura atual
|
|
|
|
```text
|
|
src/
|
|
background/
|
|
config.js
|
|
content/
|
|
export-html.js
|
|
hcm-page.js
|
|
manage-time-controller.js
|
|
modal-events.js
|
|
shell-view.js
|
|
styles.css
|
|
templates.js
|
|
workbench-controller.js
|
|
domain/
|
|
ramp-forecast.js
|
|
workload-dataset.js
|
|
workload-calendar.js
|
|
time-management.js
|
|
time-management-data.js
|
|
repositories/
|
|
cache-repository.js
|
|
comcip-repository.js
|
|
workbench-repository.js
|
|
views/
|
|
dashboard-view.js
|
|
manage-time-view.js
|
|
render-helpers.js
|
|
workbench-modals-view.js
|
|
services/
|
|
chrome-service.js
|
|
preferences-service.js
|
|
storage-service.js
|
|
transport-service.js
|
|
shared/
|
|
config.js
|
|
utils.js
|
|
background.js
|
|
content-script.js
|
|
page-bridge.js
|
|
manifest.json
|
|
```
|
|
|
|
O `manifest.json` carrega `src/shared/config.js`, services, repositories, domain modules e views antes de `content-script.js`. Esses arquivos expõem namespaces em `globalThis` para manter compatibilidade com content scripts classicos do Manifest V3 sem exigir bundler.
|
|
|
|
O CSS principal fica em `src/content/styles.css` e e injetado diretamente pela propriedade `css` do content script no `manifest.json`.
|
|
|
|
Renderizadores maiores devem ficar em `src/views/`. O dashboard principal fica em `src/views/dashboard-view.js`, os modais de Workbench ficam em `src/views/workbench-modals-view.js` e a modal Manage Time fica em `src/views/manage-time-view.js`, mantendo `content-script.js` como orquestrador.
|
|
|
|
Responsabilidades de shell injetado na pagina, como tema derivado do header Oracle, posicionamento do botao e bloqueio de scroll durante modal aberta, ficam em `src/content/shell-view.js`. A integracao especifica do HCM FuseWelcome fica em `src/content/hcm-page.js`.
|
|
|
|
Regras de negocio puras devem ficar em `src/domain/`. Essa camada nao deve manipular DOM, IndexedDB, Chrome APIs ou executar requests; ela recebe dependencias simples por factory e retorna funcoes deterministicas.
|
|
|
|
Requests, cache especifico da extensao e normalizadores de payload de APIs externas devem ficar em `src/repositories/`. Essa camada monta URLs, centraliza contratos de endpoint e transforma payloads remotos ou persistidos em DTOs consumidos pelo orquestrador.
|
|
|
|
## Fluxos principais
|
|
|
|
- Workload dashboard: carrega usuario, customers, workloads, actions e service requests.
|
|
- HCM tile: adiciona o tile `Arch Panel` dentro de `yourapps_groupNode_my_information` em `FuseWelcome`.
|
|
- Worklist token: captura o token do iframe Worklist SaasUI e persiste em IndexedDB para resolver o usuario atual.
|
|
- SPA Workbench iframe: cria um iframe oculto do Workload Workbench para obter contexto autenticado e executar requests da origem `spa.oracle.com`.
|
|
- COMCIP Time Entry iframe: cria um iframe oculto do Manage Time para requests dependentes da sessao COMCIP.
|
|
- Manage time: permite apontar horas, detectar criacao/alteracao/remocao e gravar via APIs de time entries.
|
|
|
|
## IndexedDB
|
|
|
|
Banco: `arch-panel-extension-db`
|
|
|
|
Store: `datasets`
|
|
|
|
Chaves conhecidas:
|
|
|
|
- `workload-dashboard`: ultimo dataset do dashboard.
|
|
- `time-management-task-types`: cache de task types atualizado apenas em refresh data.
|
|
- `worklist-saasui-token`: token atual extraido do iframe Worklist.
|
|
|
|
## Seguranca operacional
|
|
|
|
- A extensao deve declarar apenas permissoes realmente usadas no `manifest.json`.
|
|
- A bridge de pagina deve trocar mensagens apenas com origins explicitamente permitidos.
|
|
- Tokens e headers de autorizacao nao devem ser logados.
|
|
- Exports HTML devem escapar JSON inline e valores renderizados.
|
|
|
|
## Validacao local
|
|
|
|
```powershell
|
|
node --check content-script.js
|
|
node --check background.js
|
|
node --check page-bridge.js
|
|
node --check src/background/config.js
|
|
node --check src/content/export-html.js
|
|
node --check src/content/hcm-page.js
|
|
node --check src/content/manage-time-controller.js
|
|
node --check src/content/modal-events.js
|
|
node --check src/content/shell-view.js
|
|
node --check src/content/templates.js
|
|
node --check src/content/workbench-controller.js
|
|
node --check src/repositories/workbench-repository.js
|
|
node --check src/repositories/comcip-repository.js
|
|
node --check src/repositories/cache-repository.js
|
|
node --check src/domain/ramp-forecast.js
|
|
node --check src/domain/workload-dataset.js
|
|
node --check src/domain/workload-calendar.js
|
|
node --check src/domain/time-management.js
|
|
node --check src/domain/time-management-data.js
|
|
node --check src/views/dashboard-view.js
|
|
node --check src/views/workbench-modals-view.js
|
|
node --check src/views/manage-time-view.js
|
|
node --check src/views/render-helpers.js
|
|
node --check src/shared/config.js
|
|
node --check src/shared/utils.js
|
|
node --check src/services/storage-service.js
|
|
node --check src/services/chrome-service.js
|
|
node --check src/services/preferences-service.js
|
|
node --check src/services/transport-service.js
|
|
```
|
|
|
|
## Controle de versao
|
|
|
|
A versao oficial da extensao fica em `manifest.json`.
|
|
|
|
Toda alteracao funcional, visual ou tecnica na extensao deve incrementar a terceira casa da versao antes da entrega:
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File tools/bump-extension-version.ps1
|
|
```
|
|
|
|
Quando uma versao especifica for solicitada, informe o valor explicitamente:
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File tools/bump-extension-version.ps1 -Version 1.0.25
|
|
```
|