How batistadaniel/concurso-ti-bb works
Project Type and Purpose
• This is a single‐module, command‐line/Colab Python application.
• Purpose: ingest raw contest results (manually pasted), parse and classify candidates, and present tabular outputs (overall ranking and cutoffs by category).
Main Components
a. Data Source
• Static PDF files in “ANALISE DOS RESULTADOS PDF’s/” (Classificados BB TI 21 DOU.pdf, etc.).
• In practice, data are copied manually from these PDFs into a string constant in the code.
b. Data Ingestion
• User‐driven “Paste PDF data” step.
• Variable dados inside app.py.
c. Processing Module
• Class ResultadoFinal in app.py.
• Methods:
» resultado_final(): sorts and displays full ranking.
» ultima_pessoa_sem_cota(), ultima_pessoa_cota_pcd(), ultima_pessoa_cota_ppp(): compute cutoffs.
d. Output
• Console/table output in local terminal or interactive Colab notebook.
• Formatted as markdown‐style tables.
e. Execution Environment
• Python runtime (local or Google Colab).
• Optional libraries: none external (everything is pure Python).
Relationships and Data Flows
• PDF Files → (manual copy) → Data Ingestion step (dados variable).
• dados → ResultadoFinal (constructor).
• ResultadoFinal → parsing routines → in‐memory data structures (lists of candidates).
• Processing → sorted lists and cutoff rules.
• Processed data → console/Colab output (tabular display).
Architectural Patterns / Design Principles
• Single‐class core logic: keeps parsing and business rules encapsulated.
• Manual ETL (Extract/Transform/Load) step due to simplicity.
• Clear separation of concerns between ingestion, processing, and presentation.