List view
# Plano de Ação setembro/2025 (para Aprovação) — Minex **2D** e **3D** **Temas (prioridades do mês):** (1) **Melhorias da Aba de Resultados** (usabilidade, filtros duplos, tags, favoritos e exportações) (2) **Funcionalidade de Clipping para Meshes** (interação 3D e cortes paramétricos) **Apps no escopo deste plano:** - **Minex 2D:** `geotrixMap` (app Shiny no ShinyProxy/Kubernetes). - **Minex 3D:** `geotrix3Dapp` (app Shiny no ShinyProxy/Kubernetes). --- ## Introdução Este plano contempla as atividades e entregas previstas para **setembro/2025**, com foco explícito em **UX da aba de resultados** (hoje baseada em *tipo de operação + ID*) e na **adição de “clipping” para Meshes** no app 3D. A página de resultados passará a oferecer **filtros duplos** (por **tipo de operação** e, opcionalmente, por **parâmetro** — *data/intervalo, valor > X, nome/processo, tipo de output*), **tags**, **favoritos** e **exportação multi-formato** (HTML, PDF, PPT, CSV). No 3D, o “clipping” permitirá **cortes interativos** (planos múltiplos, caixas e máscaras) para inspecionar volumes e seções de malhas com **performance e precisão**. --- ## 1) Página de Resultados > **Objetivo:** transformar a lista atual (tipo + ID) numa **central de resultados** com filtros inteligentes, cartões informativos e ações rápidas. >  ### Referências Inspiradoras - **Cards informativos** com resumo (data, status, principais parâmetros) e ícones de output. - **Filtros persistentes** (sidebar) + **busca global** no topo. - **Tags e Favoritos** para organização pessoal e recall rápido. - **Exportação 1-clique** (HTML, PDF, PPT, CSV) por card e em massa. - **Preview embutido** (mini-gráficos/estatísticas/logs) antes de abrir o detalhe. ### Proposta Refinada para o Mockup Minex **Layout Principal (Dashboard)** - **Topo:** busca global + **Filtro 1: Tipo de operação** (Correlação, Treino, Aplicação, Kriging, etc.) + **Filtro 2 (opcional): Parâmetro** *(Data/intervalo; “valor > X”; nome/processo; tipo de output)*. - **Sidebar (persistente):** seleção múltipla por **tipo de operação** (com ícones), **faixas numéricas** (sliders), **intervalo de datas**, **nome/processo**, **tipo de output** (mapa, relatório, tabela, log). - **Centro:** **cards agrupados por operação e ID**, com: - Título (**tipo + ID**), data/hora, status (OK/Erro/Em execução). - Ícones de output (🗺️/📊/🧾/📜). - **Ações rápidas:** **★ Favoritar**, **👁️ Preview**, **⬇ Exportar** (HTML/PDF/PPT/CSV), **⋯** mais opções (abrir pasta/artefatos, ver log). - **Barra de tags** (topo dos cards): filtrar por **Tags** (modo **ANY/ALL**) e **mostrar só favoritos**. - **Exportações em massa**: botões globais acima do grid. ### Detalhes Visuais e Usabilidade | Elemento | Motivo | |----------------------------------|------------------------------------------------------------------------| | **Filtro duplo** (tipo + parâmetro) | Reduz cliques e acelera a descoberta do resultado certo. | | **Cards com preview** | Inspeção rápida sem trocar de tela. | | **Tags + Favoritos** | Organização pessoal, repetibilidade e foco. | | **Exportação 1-clique** | Padroniza compartilhamento e relatórios. | | **Sidebar persistente** | Estado de filtro sempre visível; evita “abrir/fechar” modais. | --- ## Justificativa A central de resultados atual exige cliques em cadeia e não oferece **contexto** (status, datas, outputs) nem **organizadores** (tags/favoritos). A evolução proposta: - **Diminui tempo de busca** de execuções (por tipo/ID/parâmetro/intervalo). - **Melhora rastreabilidade** (status, links para artefatos/logs). - **Padroniza exportos** para comunicação com stakeholders. --- ## Referencias - Padrões de UX para **dashboards com filtros persistentes e cards**. - Práticas de **tagging/favoritos** para organização e recall de resultados frequentes. - Fluxos de **exportação multi-formato** e **preview** embutido. --- ## Atividades 1. **UX/UI**: wireframes finais (desktop) + estados (vazio, carregando, erro) + guidelines de ícones. 2. **Server/Query**: endpoints para **filtro duplo**, paginação, ordenação e **quick-search**. 3. **Tags/Favoritos**: modelo simples (por usuário), persistente em DB; filtros **ANY/ALL**. 4. **Preview**: sumarização de outputs (métricas chave, mini-plots ou primeiras linhas de tabelas). 5. **Exportos**: rotas para **HTML, PDF, PPT, CSV** (single e *bulk*), com fila e indicador de progresso. 6. **Telemetria**: eventos de uso (filtros usados, exportações, tempos). 7. **Testes**: unitários (R), integração (shinytest2), *snapshot* de UI, E2E (pod + artefatos). ### Cronograma (1 semana por app) - **Semana 1 — Minex 2D (geotrixMap)** D1 UX/estados • D2 server filtros • D3 UI cards/preview • D4 tags/favoritos • D5 exportos + testes. - **Semana 2 — Minex 3D (geotrix3Dapp)** Replicar/adaptar para 3D + integração com artefatos específicos do 3D. ### Entregáveis (1 por app) - **UI/Server prontos** com **Filtro Duplo**, **Tags/Favoritos**, **Preview** e **Exportos**. - Novos testes focados na usabilidade do painel. - **Relatórios de teste** (rcmd, métricas) e **artefatos** em `production/VERSAO/...`. --- ## 2) Nova Funcionalidade para **Clipping de Meshes** > **Objetivo:** oferecer **cortes interativos** em malhas 3D (e opcionais projeções/resultados derivados) no `geotrix3Dapp`. ### Escopo - **Operadores de clipping**: - **Planar** (1–3 planos; mover/rotacionar/posicionar por UI). - **Volume box** (AABB/OBB), **esfera** e **máscara por atributo** (ex.: litologia). - **Interação/UX**: *gizmos* para mover/rotacionar planos; *snap* a eixos; *reset* de clipes. - **Resultados**: visualização **em tempo real** (corte da mesh) + **curvas/perfis** opcionais na seção. - **Performance**: *throttling* de eventos, cache por posição, simplificação (LOD). - **Exportos**: salvar **estado de clipes** (JSON) e **capturas** (PNG/GLB com clipe aplicado). ### Atividades 1. **API 3D**: funções para aplicação de planos/volumes sobre buffers (GPU-friendly quando disponível). 2. **UI**: painel “Clipping” com presets (XY/YZ/ZX), *snap*, múltiplos planos e histórico (*undo/redo*). 3. **Persistência**: salvar/recuperar clipes por ID da operação. 4. **Testes**: unit (geometrias), integração (render + eventos), snapshot de UI, E2E no pod. ### Cronograma (1 semana — foco 3D) - **D1** arquitetura/estados • **D2–D3** implementação API + UI • **D4** performance/cache • **D5** testes e exportos. ### Entregáveis - Painel **Clipping** no `geotrix3Dapp` com planos múltiplos e volume box. - **Exporto** de estado (JSON) e **capturas** com clipe aplicado. - Novos testes em `backend(geotrix/geotrix3d)`, `pre(geotrix2dpre,geotrix3dpre)` e `app(minex 2d e 3d)` para a funcionalidade. - Testes automatizados e artefatos em `production/VERSAO/...`. --- ## 3) **Apps (UI + server)** — geotrixMap (2D) e geotrix3Dapp (3D) > **Objetivo:** garantir **integração completa** com backend e **reprodutibilidade** das novas features (Resultados + Clipping). | Funcionalidade | Descrição | Teste (`test-*.R`) | |-----------------------------|---------------------------------------------------------|------------------------------------| | **Resultados – Filtro Duplo** | Busca por operação + parâmetro; paginação e ordenação | `test-results.R::filters_search` | | **Tags/Favoritos** | CRUD de tags; estrella/favoritos; filtro ANY/ALL | `test-results.R::tags_favs` | | **Preview/Exportos** | Sumário e exportação (HTML/PDF/PPT/CSV) | `test-results.R::preview_export` | | **Clipping 3D** | Planos/volume; estados; captura | `test-3d.R::clipping_interaction` | | **Logs/Artefatos** | Links para `diff_report`, `manifest`, etc. | `test-results.R::artifacts_links` | **Metas de qualidade (por app):** Cobertura **≥ 90%**, `rcmdcheck` **0/0**, *snapshots* estáveis, artefatos padronizados em `production/VERSAO/...`. ### Cronograma (1 semana por app) - **Semana 3 — geotrixMap (2D):** D1 cenários + snapshots • D2 filtro duplo • D3 tags/favs • D4 preview/exportos • D5 testes/produção. - **Semana 4 — geotrix3Dapp (3D):** Adaptação + cenários de **Clipping** e integração com Resultados. ### Entregáveis (1 por app) - `production/VERSAO/covr/coverage-app.xml` + `index.html` (≥ 90%). - `production/VERSAO/metrics/test_times.csv` (tempos de UI/workflows). - `production/VERSAO/rcmdcheck/last.txt` + *prints*. - Build `*.tar.gz` + `renv.lock`. --- ## Milestones (atualizado) - **Resultados – UX (2D)** — 1 semana - **Resultados – UX (3D)** — 1 semana - **Clipping Meshes (3D)** — 1 semana - **Apps – Testes & Produção (2D e 3D)** — 1 semana > **Observação:** Semanas de apps incluem validação das novas funcionalidades (Resultados/Clipping), artefatos de produção e ajustes de CI. --- ## Estimativa de esforço > Estimativas em **horas** por **atividade** (mês), considerando 1 pessoa desenvolvendo e 2 pessoas focadas em QA/planejamento/documentação. | Bloco | Desenvolvimento | |-------------------------------------------|----------------------:| | **Resultados – UX 2D** | 24 h | | **Resultados – UX 3D** | 24 h | | **Clipping Meshes 3D** | 28 h | | **Apps – Testes & Produção 2D** | 16 h | | **Apps – Testes & Produção 3D** | 16 h | | **CI/Docs/Telemetria (compartilhado)** | 8 h | | **Total estimado** | **116 h** | > **Granularidade por semana** (referência): ~40–48 h/semana de desenvolvimento + 36–40 h/semana somados de QA/planejamento. **Critérios de aceite (globais)** - Resultados: filtro duplo, tags/favs, preview, exportos e telemetria funcionando nos 2 apps. - Clipping: planos/volume com interação fluida, persistência de estado e exporto de captura/JSON. - Qualidade: cobertura **≥ 90%**, `rcmdcheck` **0/0**, artefatos completos em `production/VERSAO/...`. - Desempenho: UI responsiva com paginação; clipping sem *frame drops* perceptíveis em casos médios. --- ## Formato de entrega e organização dos arquivos Os **artefatos finais** seguem o padrão `production/VERSAO_DO_PACOTE/...` (prints, metrics, covr, rcmdcheck, diffs, manifests, builds, manual), mantendo **rastreabilidade e repetibilidade**. Links para **logs, diffs e manifests** devem estar acessíveis a partir da **central de resultados** (cards → “ver artefatos”). --- ## Contato Para dúvidas ou alinhamentos: `[email protected]`.
Due by September 30, 2025## 1) Integração dos resultados dos relatórios nos testes de consistência **Status de base:** os **comparativos já estão prontos** nos relatórios gerados pelas issues **geotrixapp3d\_prod#125** e **geotrixMap#52** (3D estável; 2D ajustado no mês anterior). ### Justificativa Integrar os comparativos **já existentes** à suíte de testes garante regressão contínua e reduz custo operacional. * **Backend (geotrix / geotrix3d):** simplificar testes, trocar projetos reais por **fixtures menores** focados em validar rotinas. * **Pods (jobs com backend + banco):** priorizar **substituição de arquivos/fixtures** e **ajuste de chamadas/pipelines**; novos testes só se estritamente necessários. Entregar CI 2D/3D com relatório automático de diffs. ### Atividades * Mapear testes existentes que consomem artefatos grandes e **trocar por fixtures mínimos** (mantendo mesmas rotinas). * Normalizar outputs (CRS, ordenação, precisão) e aplicar diffs (numérico/geométrico/raster). * Conectar **IDs fixos** já usados nos comparativos para execução E2E em pods. * Adicionar validadores checkmate para os resultados salvos em blob storage. * Publicar **relatório de diffs** como artefato do CI. ### Cronograma (1 semana por app) **Semana 1 — Minex 2D** * **D1:** inventário de testes + seleção de fixtures mínimos * **D2:** substituição de fixtures + ajuste de chamadas (backend) * **D3:** integração E2E (pods) com IDs fixos * **D4:** checkmate para os resultados salvos em blob storage * **D5:** refinamentos + documentação ### Entregáveis (1 por app) * **Backend (geotrix / geotrix3d)** * `tests/backend/cmd_output.txt` com **redução ≥ 60%** no tempo total em relação à execução anterior (fixtures menores). * Relatório de cobertura **covr ≥ 90%**: `coverage-backend.xml` (anexado no CI) + badge atualizado. * **Pods (E2E: backend + banco, ambiente pré)** * Execução com **IDs fixos** dos relatórios (**geotrixapp3d\_prod#125** e **geotrixMap#52**) validando **100% dos comparativos**. * Artefatos anexados no CI: * `pods/cmd_output.txt` com **mensagens de discriminação** dos comparativos (pass/fail por item). * `diff_report.html` (ou `.md`) e `diff_summary.json` com os **diffs detalhados**. * (Se o harness de pods for em R) **covr ≥ 90%** do código do harness: `coverage-pods.xml`. *(Se não houver harness em R, entregar relatório de testes E2E com 100% dos cenários previstos executados.)* * **Integridade e rastreabilidade** * `manifest-checksums.json` (SHA-256) dos resultados **no blob storage** + **verificação automática** no CI (“checksum OK”). * `tests/README-baseline.md` documentando atualização de fixtures, tolerâncias e paths dos artefatos. **Semana 2 — Minex 3D** * Mesma sequência **D1–D5**, replicando o modelo do 2D ### Estimativa de esforço * **2D (Semana 1):** 16–18h * **3D (Semana 2):** 16–18h * **Ajustes CI/relatórios (compartilhado):** 10h (distribuídos nas duas semanas) **Critérios de aceite** * Testes (backend + pods) rodando com fixtures mínimos e **relatório de diffs** no CI para 2D e 3D. * Falhas acima das tolerâncias **quebram o CI**. --- ## 2) covr e backends (restaurar cobertura com `safe_call`) **Escopo:** corrigir a instrumentação de cobertura para **ambos os pacotes** `geotrix` (2D) e `geotrix3d` (3D), hoje impactada pelo split de funções e `safe_call`. ### Justificativa Sem cobertura confiável, regressões passam despercebidas. Ajustar `safe_call` e a configuração do `covr` restaura visibilidade e dá base para metas de cobertura. ### Atividades * Reproduzir o problema e mapear caminhos encobertos por `safe_call`. * Ajustar `safe_call` para **preservar instrumentação** (re-lançar erro após log; evitar closures opacas; remover `nocov` acidental). * Revisar execução `covr::package_coverage()` no CI (exclusões, paths, R CMD check). * Adicionar **gate** de cobertura mínima (temporário) no CI. ### Cronograma (1 semana total para **ambos pacotes**) * **D1:** reproduzir falhas de cobertura nos dois pacotes * **D2–D3:** patches em `safe_call` + validação local (geotrix e geotrix3d) * **D4:** ajustar pipeline de cobertura no CI (ambos) * **D5:** estabilização + documentação de padrão `safe_call` ### Entregáveis (geotrix` (2D) e `geotrix3d` (3D)) * Relatórios de cobertura por pacote: coverage-geotrix.xml e coverage-geotrix3d.xml (anexados no CI) + badge atualizado. * PRs de correção em safe_call (links e changelog), com testes cobrindo rotas de erro e re-lançamento. * Documento técnico docs/testing/safe_call_guidelines.md descrevendo padrão de uso e implicações para cobertura. ### Estimativa de esforço * **Semana única (geotrix + geotrix3d):** 22–30h **Critérios de aceite** * Relatórios `covr` exibem caminhos antes ocultos por `safe_call` em **ambos** os pacotes. * Job de cobertura no CI gerando badge/artefato e **gate** ativado. ---
Overdue by 8 day(s)•Due by August 31, 2025## 1) Integração dos resultados dos relatórios nos testes de consistência **Status de base:** os **comparativos já estão prontos** nos relatórios gerados pelas issues **geotrixapp3d\_prod#125** e **geotrixMap#52** (3D estável; 2D ajustado no mês anterior). ### Justificativa Integrar os comparativos **já existentes** à suíte de testes garante regressão contínua e reduz custo operacional. * **Backend (geotrix / geotrix3d):** simplificar testes, trocar projetos reais por **fixtures menores** focados em validar rotinas. * **Pods (jobs com backend + banco):** priorizar **substituição de arquivos/fixtures** e **ajuste de chamadas/pipelines**; novos testes só se estritamente necessários. Entregar CI 2D/3D com relatório automático de diffs. ### Atividades * Mapear testes existentes que consomem artefatos grandes e **trocar por fixtures mínimos** (mantendo mesmas rotinas). * Normalizar outputs (CRS, ordenação, precisão) e aplicar diffs (numérico/geométrico/raster). * Conectar **IDs fixos** já usados nos comparativos para execução E2E em pods. * Adicionar validadores checkmate para os resultados salvos em blob storage. * Publicar **relatório de diffs** como artefato do CI. ### Cronograma (1 semana por app) **Semana 1 — Minex 2D** * **D1:** inventário de testes + seleção de fixtures mínimos * **D2:** substituição de fixtures + ajuste de chamadas (backend) * **D3:** integração E2E (pods) com IDs fixos * **D4:** checkmate para os resultados salvos em blob storage * **D5:** refinamentos + documentação ### Entregáveis (1 por app) * **Backend (geotrix / geotrix3d)** * `tests/backend/cmd_output.txt` com **redução ≥ 60%** no tempo total em relação à execução anterior (fixtures menores). * Relatório de cobertura **covr ≥ 90%**: `coverage-backend.xml` (anexado no CI) + badge atualizado. * **Pods (E2E: backend + banco, ambiente pré)** * Execução com **IDs fixos** dos relatórios (**geotrixapp3d\_prod#125** e **geotrixMap#52**) validando **100% dos comparativos**. * Artefatos anexados no CI: * `pods/cmd_output.txt` com **mensagens de discriminação** dos comparativos (pass/fail por item). * `diff_report.html` (ou `.md`) e `diff_summary.json` com os **diffs detalhados**. * (Se o harness de pods for em R) **covr ≥ 90%** do código do harness: `coverage-pods.xml`. *(Se não houver harness em R, entregar relatório de testes E2E com 100% dos cenários previstos executados.)* * **Integridade e rastreabilidade** * `manifest-checksums.json` (SHA-256) dos resultados **no blob storage** + **verificação automática** no CI (“checksum OK”). * `tests/README-baseline.md` documentando atualização de fixtures, tolerâncias e paths dos artefatos. **Semana 2 — Minex 3D** * Mesma sequência **D1–D5**, replicando o modelo do 2D ### Estimativa de esforço * **2D (Semana 1):** 16–18h * **3D (Semana 2):** 16–18h * **Ajustes CI/relatórios (compartilhado):** 10h (distribuídos nas duas semanas) **Critérios de aceite** * Testes (backend + pods) rodando com fixtures mínimos e **relatório de diffs** no CI para 2D e 3D. * Falhas acima das tolerâncias **quebram o CI**. --- ## 2) covr e backends (restaurar cobertura com `safe_call`) **Escopo:** corrigir a instrumentação de cobertura para **ambos os pacotes** `geotrix` (2D) e `geotrix3d` (3D), hoje impactada pelo split de funções e `safe_call`. ### Justificativa Sem cobertura confiável, regressões passam despercebidas. Ajustar `safe_call` e a configuração do `covr` restaura visibilidade e dá base para metas de cobertura. ### Atividades * Reproduzir o problema e mapear caminhos encobertos por `safe_call`. * Ajustar `safe_call` para **preservar instrumentação** (re-lançar erro após log; evitar closures opacas; remover `nocov` acidental). * Revisar execução `covr::package_coverage()` no CI (exclusões, paths, R CMD check). * Adicionar **gate** de cobertura mínima (temporário) no CI. ### Cronograma (1 semana total para **ambos pacotes**) * **D1:** reproduzir falhas de cobertura nos dois pacotes * **D2–D3:** patches em `safe_call` + validação local (geotrix e geotrix3d) * **D4:** ajustar pipeline de cobertura no CI (ambos) * **D5:** estabilização + documentação de padrão `safe_call` ### Entregáveis (geotrix` (2D) e `geotrix3d` (3D)) * Relatórios de cobertura por pacote: coverage-geotrix.xml e coverage-geotrix3d.xml (anexados no CI) + badge atualizado. * PRs de correção em safe_call (links e changelog), com testes cobrindo rotas de erro e re-lançamento. * Documento técnico docs/testing/safe_call_guidelines.md descrevendo padrão de uso e implicações para cobertura. ### Estimativa de esforço * **Semana única (geotrix + geotrix3d):** 22–30h **Critérios de aceite** * Relatórios `covr` exibem caminhos antes ocultos por `safe_call` em **ambos** os pacotes. * Job de cobertura no CI gerando badge/artefato e **gate** ativado. ---
Overdue by 8 day(s)•Due by August 31, 2025GEOTRIX 3D - MANUTENCAO JULHO/25 * Manutenção corretiva e evolutiva 3D
Overdue by 1 month(s)•Due by July 31, 2025GEOTRIX 2D - MANUTENCAO JULHO/25 * Manutenção corretiva e evolutiva 2D * LOG e mapeamento de erros * validação de rotinas : optimal grid size , models
Overdue by 1 month(s)•Due by July 31, 2025GEOTRIX 2D e 3D - MANUTENCAO JUNHO/25 * Manutenção corretiva e evolutiva 2D - Inpaiting * Manutenção corretiva e evolutiva 3D
Overdue by 2 month(s)•Due by June 30, 2025GEOTRIX 2D e 3D - MANUTENCAO MAIO/25 Manutenção corretiva e evolutiva 2D e 3D Manutenção evolutiva e evolutiva 2D e 3D
Overdue by 3 month(s)•Due by May 31, 2025GEOTRIX 3D - MANUTENCAO ABRIL/25 Manutenção corretiva e evolutiva 3D
Overdue by 4 month(s)•Due by April 30, 2025GEOTRIX 2D - MANUTENCAO ABRIL/25 Manutenção corretiva e evolutiva 2D
Overdue by 4 month(s)•Due by April 30, 2025- Manutenção corretiva e evolutiva 2D e 3D - Manutenção evolutiva e evolutiva 2D e 3D
Overdue by 5 month(s)•Due by March 31, 2025GEOTRIX 3D - MANUTENCAO FEVEREIRO/25 Realizar manutenções evolutivas e corretivas em projeto mediante chamados Finalizar migração
Overdue by 6 month(s)•Due by February 28, 2025GEOTRIX 3D - MANUTENCAO DEZEMBRO/24 - TERMINAR MIGRAÇÃO PARA R4
Overdue by 8 month(s)•Due by December 20, 2024GEOTRIX 2D - MANUTENCAO DEZEMBRO/24 - TERMINAR MIGRAÇÃO PARA R4
Overdue by 8 month(s)•Due by December 20, 2024- refatorar SAAS e widgets 2D e 3D
Overdue by 7 month(s)•Due by January 31, 2025- Realizar manutenções evolutivas e corretivas em projeto mediante chamados - Finalizar migração
Overdue by 1 year(s)•Due by April 28, 2024Realizar manutenções evolutivas e corretivas em projeto mediante chamados
Overdue by 1 year(s)•Due by March 31, 2024Realizar manutenções evolutivas e corretivas em projeto mediante chamados
Overdue by 1 year(s)•Due by February 29, 2024Realizar manutenções evolutivas e corretivas em projeto mediante chamados
Overdue by 1 year(s)•Due by February 29, 2024Geotrix2D-manutenção-dezembro/23 Realizar manutenções evolutivas e corretivas em projeto mediante chamados
Overdue by 1 year(s)•Due by January 31, 2024Realizar manutenções evolutivas e corretivas em projeto mediante chamados
Overdue by 1 year(s)•Due by December 31, 2023