Skip to content

docs: add relatorio de analise de generalizacao para repositorios abertos#7

Open
profsergiocosta wants to merge 3 commits intomainfrom
jules-generalizacao-etl-13602552557790377385
Open

docs: add relatorio de analise de generalizacao para repositorios abertos#7
profsergiocosta wants to merge 3 commits intomainfrom
jules-generalizacao-etl-13602552557790377385

Conversation

@profsergiocosta
Copy link
Copy Markdown

Adiciona o relatório de análise sobre o potencial do repositório ser generalizado para extrair dados de quaisquer repositórios abertos (portais de transparência, CKAN, etc) e converter para dados conectados (Linked Data / RDF).

O relatório aborda:

  • Arquitetura Atual baseada em Airflow e Simpot
  • Viabilidade e limitações para raspar Portais Genéricos
  • Problemas de rigidez semântica em models.py
  • Recomendações (como RML, Auto-Discovery e GenericRestConsumer)

PR created automatically by Jules for task 13602552557790377385 started by @profsergiocosta

…rtos

This commit introduces a detailed architectural analysis report (`relatorio_analise_generalizacao.md`) assessing the potential of generalizing the current DBAcademic ETL pipeline.

The report evaluates:
- The current Apache Airflow, Pandas, and Simpot-based architecture.
- Strengths and bottlenecks in extracting data from open repositories (e.g., CKAN APIs vs. Generic REST APIs).
- Limitations of hardcoded semantic mapping (`models.py`) for converting arbitrary data to Linked Data/RDF.
- Architectural recommendations including the adoption of RML/YARRRML, SHACL/ShEx, and a generic dynamic discovery pipeline.

Co-authored-by: profsergiocosta <86836+profsergiocosta@users.noreply.github.com>
@google-labs-jules
Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

google-labs-jules bot and others added 2 commits March 5, 2026 18:55
This commit refactors the generalization analysis report (`relatorio_analise_generalizacao.md`) to strongly recommend migrating the Linked Data conversion tool from `simpot` to `rdfmapper`.

Key updates include:
- Explicitly identifying the limitations of `simpot` (lack of dynamic querying, missing SHACL validation, intrusive domain rules).
- Adding a dedicated section (5.1) detailing how `rdfmapper` solves these architectural gaps.
- Highlighting `rdfmapper` features such as automatic SHACL shape generation, dynamic `RDFRepository` queries, and streamlined relationships (One-to-One and One-to-Many).
- Introducing a meta-programming approach in "Mapeamento Semântico Desacoplado" to leverage `rdfmapper` dynamically based on JSON configuration instead of hardcoded Python classes.

Co-authored-by: profsergiocosta <86836+profsergiocosta@users.noreply.github.com>
This commit extracts actionable implementation issues from the previously created generalization analysis report and saves them in `issues_priorizadas.md`.

The issues are prioritized into:
- High Priority (🔴): Refactoring `models.py` from `simpot` to `rdfmapper` (including SHACL validation and decorators) and decoupling semantic mappings to `config.py`.
- Medium Priority (🟡): Building a generic `GenericRestConsumer` to support pagination and configurable headers for open data portals.
- Low Priority (🟢): Implementing a discovery pipeline (`discovery_dag.py`) for automated CKAN dataset listing.

Co-authored-by: profsergiocosta <86836+profsergiocosta@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant