relatorios-sivwin 0.2.0__tar.gz

relatorios_sivwin-0.2.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: relatorios-sivwin
+Version: 0.2.0
+Summary: Consultas SQL reutilizaveis para o ecossistema SivWin/Otimiza.
+Keywords: sql,django,sivwin,otimiza,relatorios
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# Relatorios SivWin
+
+Biblioteca Python para centralizar consultas SQL do ecossistema SivWin/Otimiza.
+
+## Instalacao
+
+```bash
+pip install relatorios-sivwin
+```
+
+O nome publicado usa hifen, mas o import Python usa underscore:
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+```
+
+## Objetivo
+
+- Concentrar consultas SQL em um unico lugar.
+- Reduzir duplicacao de regras SQL entre projetos.
+- Facilitar o uso das mesmas consultas em Django, scripts e outros servicos.
+
+## Estrutura
+
+- `relatorios_sivwin.SQLQuery`: contrato padrao para consultas parametrizadas.
+- `relatorios_sivwin.RelatoriosSivWin`: hub principal de acesso aos dominios.
+- `relatorios_sivwin.RelatoriosGeraisQueries`: consultas gerais, como declaracoes e ARTs.
+- `relatorios_sivwin.RelatoriosServicosQueries`: consultas do dominio de servicos e inspecoes.
+- `relatorios_sivwin.dbapi`: helpers opcionais para executar uma `SQLQuery` com um cursor ja aberto.
+
+## Exemplo Rapido
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_art(120000, 120999)
+
+print(consulta.sql)
+print(consulta.params)
+```
+
+Por padrao, a representacao SQL bruta usa `otimiza` como banco:
+
+```python
+relatorios = RelatoriosSivWin(database="sivwin_homolog")
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+print(consulta.to_sql_raw())
+```
+
+## Uso Com Django
+
+```python
+from django.db import connections
+from relatorios_sivwin import RelatoriosSivWin, fetch_all
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+with connections["otimiza"].cursor() as cursor:
+    dados = fetch_all(cursor, consulta)
+```
+
+Nesse formato:
+
+- o Django continua responsavel pela conexao;
+- o pacote so define a consulta;
+- o mesmo objeto pode ser reutilizado em outros contextos.
+
+## Uso Fora Do Django
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_declaracoes(123456)
+
+cursor.execute(consulta.sql, consulta.params)
+linhas = cursor.fetchall()
+```
+
+## Principios Do Pacote
+
+- Sem acoplamento com conexao, `.env` ou credenciais.
+- Sem dependencias pesadas para gerar SQL.
+- Metodos de dominio retornam `SQLQuery`.
+- Queries sempre parametrizadas, sem interpolacao direta de valores.
+- Cada relatorio relevante tem sua propria SQL, escrita de forma explicita.
+- Reaproveitamento existe apenas onde ele realmente simplifica, como constantes SQL e bloco de contato.

relatorios_sivwin-0.2.0/README.md

@@ -0,0 +1,90 @@
+# Relatorios SivWin
+
+Biblioteca Python para centralizar consultas SQL do ecossistema SivWin/Otimiza.
+
+## Instalacao
+
+```bash
+pip install relatorios-sivwin
+```
+
+O nome publicado usa hifen, mas o import Python usa underscore:
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+```
+
+## Objetivo
+
+- Concentrar consultas SQL em um unico lugar.
+- Reduzir duplicacao de regras SQL entre projetos.
+- Facilitar o uso das mesmas consultas em Django, scripts e outros servicos.
+
+## Estrutura
+
+- `relatorios_sivwin.SQLQuery`: contrato padrao para consultas parametrizadas.
+- `relatorios_sivwin.RelatoriosSivWin`: hub principal de acesso aos dominios.
+- `relatorios_sivwin.RelatoriosGeraisQueries`: consultas gerais, como declaracoes e ARTs.
+- `relatorios_sivwin.RelatoriosServicosQueries`: consultas do dominio de servicos e inspecoes.
+- `relatorios_sivwin.dbapi`: helpers opcionais para executar uma `SQLQuery` com um cursor ja aberto.
+
+## Exemplo Rapido
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_art(120000, 120999)
+
+print(consulta.sql)
+print(consulta.params)
+```
+
+Por padrao, a representacao SQL bruta usa `otimiza` como banco:
+
+```python
+relatorios = RelatoriosSivWin(database="sivwin_homolog")
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+print(consulta.to_sql_raw())
+```
+
+## Uso Com Django
+
+```python
+from django.db import connections
+from relatorios_sivwin import RelatoriosSivWin, fetch_all
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+with connections["otimiza"].cursor() as cursor:
+    dados = fetch_all(cursor, consulta)
+```
+
+Nesse formato:
+
+- o Django continua responsavel pela conexao;
+- o pacote so define a consulta;
+- o mesmo objeto pode ser reutilizado em outros contextos.
+
+## Uso Fora Do Django
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_declaracoes(123456)
+
+cursor.execute(consulta.sql, consulta.params)
+linhas = cursor.fetchall()
+```
+
+## Principios Do Pacote
+
+- Sem acoplamento com conexao, `.env` ou credenciais.
+- Sem dependencias pesadas para gerar SQL.
+- Metodos de dominio retornam `SQLQuery`.
+- Queries sempre parametrizadas, sem interpolacao direta de valores.
+- Cada relatorio relevante tem sua propria SQL, escrita de forma explicita.
+- Reaproveitamento existe apenas onde ele realmente simplifica, como constantes SQL e bloco de contato.

relatorios_sivwin-0.2.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "relatorios-sivwin"
+version = "0.2.0"
+description = "Consultas SQL reutilizaveis para o ecossistema SivWin/Otimiza."
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["sql", "django", "sivwin", "otimiza", "relatorios"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Intended Audience :: Developers",
+    "Topic :: Database",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "pytest",
+    "twine",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["relatorios_sivwin", "relatorios_sivwin.*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

relatorios_sivwin-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

relatorios_sivwin-0.2.0/src/relatorios_sivwin/__init__.py

@@ -0,0 +1,16 @@
+"""API publica do pacote ``relatorios_sivwin``."""
+
+from .contracts import SQLQuery
+from .core import RelatoriosSivWin
+from .dbapi import execute_sql_query, fetch_all, fetch_one
+from .queries import RelatoriosGeraisQueries, RelatoriosServicosQueries
+
+__all__ = [
+    "RelatoriosSivWin",
+    "RelatoriosGeraisQueries",
+    "RelatoriosServicosQueries",
+    "SQLQuery",
+    "execute_sql_query",
+    "fetch_all",
+    "fetch_one",
+]

relatorios_sivwin-0.2.0/src/relatorios_sivwin/constants.py

@@ -0,0 +1,19 @@
+"""Compatibilidade para constantes SQL historicamente publicas."""
+
+from .queries._shared import (
+    CASE_SITUACAO_DECLARACAO,
+    CASE_SITUACAO_INSPECAO,
+    CASE_TIPO_INSPECAO,
+    CASE_TIPO_SERVICO,
+    _campos_contato,
+    sql_base,
+)
+
+__all__ = [
+    "CASE_SITUACAO_DECLARACAO",
+    "CASE_SITUACAO_INSPECAO",
+    "CASE_TIPO_INSPECAO",
+    "CASE_TIPO_SERVICO",
+    "_campos_contato",
+    "sql_base",
+]

relatorios_sivwin-0.2.0/src/relatorios_sivwin/contracts.py

@@ -0,0 +1,48 @@
+"""Tipos compartilhados para representacao de consultas SQL."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from textwrap import dedent
+from typing import Any
+
+
+@dataclass(frozen=True, slots=True)
+class SQLQuery:
+    """Representacao ordenada de uma consulta SQL pronta para execucao.
+
+    Args:
+        sql: A string da consulta SQL, com placeholders (%s) para os parametros.
+        name: Um nome opcional para a consulta, util para log e depuracao.
+        params: Uma tupla de parametros a serem interpolados na consulta.
+        database: Nome do banco usado ao renderizar a consulta para inspecao.
+    """
+
+    sql: str
+    name: str = ""
+    params: tuple[Any, ...] = field(default_factory=tuple)
+    database: str = "otimiza"
+
+    def __post_init__(self) -> None:
+        """Normaliza o SQL e garante que os parametros sejam uma tupla."""
+        object.__setattr__(self, "sql", dedent(self.sql).strip())
+        object.__setattr__(self, "params", tuple(self.params))
+
+    def to_sql_raw(self, database: str | None = None) -> str:
+        """Retorna a consulta com os parametros interpolados para inspecao."""
+        selected_database = self.database if database is None else database
+        sql = self.sql
+
+        for param in self.params:
+            if param is None:
+                value = "NULL"
+            elif isinstance(param, str):
+                value = "'" + param.replace("'", "''") + "'"
+            elif isinstance(param, bool):
+                value = "1" if param else "0"
+            else:
+                value = str(param)
+
+            sql = sql.replace("%s", value, 1)
+
+        return f"USE [{selected_database}];\n\n{sql}"

relatorios_sivwin-0.2.0/src/relatorios_sivwin/core.py

@@ -0,0 +1,18 @@
+"""Objeto principal de acesso aos relatorios SivWin."""
+
+from __future__ import annotations
+
+from .queries import RelatoriosGeraisQueries, RelatoriosServicosQueries
+
+
+class RelatoriosSivWin:
+    """Centraliza o acesso aos dominios de consulta do pacote."""
+
+    def __init__(self, database: str = "otimiza") -> None:
+        """Inicializa os modulos publicos do pacote."""
+        self.database = database
+        self.gerais = RelatoriosGeraisQueries(database=database)
+        self.servicos = RelatoriosServicosQueries(database=database)
+
+        self.relatorios_gerais = self.gerais
+        self.relatorios_servicos = self.servicos

relatorios_sivwin-0.2.0/src/relatorios_sivwin/dbapi.py

@@ -0,0 +1,54 @@
+"""Helpers opcionais para executar consultas com cursores ja abertos."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .contracts import SQLQuery
+
+
+def execute_sql_query(cursor: Any, query: SQLQuery) -> None:
+    """Executa uma ``SQLQuery`` usando um cursor existente.
+
+    Args:
+        cursor: Cursor DB-API compativel com ``execute(sql, params)``.
+        query: Consulta parametrizada a ser executada.
+    """
+    cursor.execute(query.sql, query.params)
+
+
+def fetch_all(cursor: Any, query: SQLQuery) -> list[dict[str, Any]]:
+    """Executa uma consulta e retorna todas as linhas como dicionario.
+
+    Args:
+        cursor: Cursor DB-API ja associado a uma conexao aberta.
+        query: Consulta parametrizada a ser executada.
+
+    Returns:
+        Lista de dicionarios no formato ``{nome_coluna: valor}``.
+    """
+    execute_sql_query(cursor, query)
+
+    columns = [column[0] for column in cursor.description]
+    return [dict(zip(columns, linha)) for linha in cursor.fetchall()]
+
+
+def fetch_one(cursor: Any, query: SQLQuery) -> dict[str, Any] | None:
+    """Executa uma consulta e retorna a primeira linha como dicionario.
+
+    Args:
+        cursor: Cursor DB-API ja associado a uma conexao aberta.
+        query: Consulta parametrizada a ser executada.
+
+    Returns:
+        Um dicionario com a primeira linha retornada ou ``None`` quando nao ha
+        resultados.
+    """
+    execute_sql_query(cursor, query)
+
+    linha = cursor.fetchone()
+    if linha is None:
+        return None
+
+    columns = [column[0] for column in cursor.description]
+    return dict(zip(columns, linha))

relatorios_sivwin-0.2.0/src/relatorios_sivwin/queries/__init__.py

@@ -0,0 +1,9 @@
+"""Consultas SQL organizadas por dominio."""
+
+from .gerais import RelatoriosGeraisQueries
+from .servicos import RelatoriosServicosQueries
+
+__all__ = [
+    "RelatoriosGeraisQueries",
+    "RelatoriosServicosQueries",
+]

relatorios_sivwin-0.2.0/src/relatorios_sivwin/queries/_shared.py

@@ -0,0 +1,152 @@
+"""Constantes e pequenos utilitarios SQL compartilhados pelo pacote."""
+
+from __future__ import annotations
+from textwrap import dedent
+
+CASE_SITUACAO_INSPECAO = """
+CASE i.SituacaoVeiculo
+    WHEN 0 THEN 'Ativo'
+    WHEN 1 THEN 'Aprovado'
+    WHEN 2 THEN 'Reprovado'
+    WHEN 3 THEN 'Cancelada'
+    WHEN 4 THEN 'Vencida'
+    WHEN 5 THEN 'Em correcao'
+    WHEN 6 THEN 'Corrigida'
+    WHEN 7 THEN 'Reprovada pelo SISCSV'
+    ELSE 'Outros'
+END
+"""
+
+CASE_TIPO_SERVICO = """
+CASE s.TipoServico
+    WHEN 'SR' THEN s.TipoCsvSerproNome
+    WHEN 'LG' THEN s.TipoLaudoNome
+    WHEN 'LS' THEN s.ProjetoSisLitIdentificacao
+    WHEN 'LD' THEN 'Laudo CSV Legado'
+END
+"""
+
+CASE_TIPO_INSPECAO = """
+CASE s.TipoServico
+    WHEN 'SR' THEN 'Laudo CSV'
+    WHEN 'LD' THEN 'Laudo CSV Legado'
+    WHEN 'LG' THEN 'Laudo Geral'
+    WHEN 'LS' THEN 'Laudo SISLIT'
+END
+"""
+
+CASE_SITUACAO_DECLARACAO = """
+CASE i.SituacaoVeiculo
+    WHEN 1 THEN 'APROVADO'
+    WHEN 2 THEN 'REPROVADO'
+END
+"""
+
+def _campos_contato(alias: str, nome: str) -> str:
+    """Retorna um bloco padrao de colunas de contato.
+
+    O bloco atende os cenarios recorrentes de proprietario, contratante e condutor. Os aliases seguem o padrao ``<nome><Campo>``.
+    Por exemplo, para o proprietario, ``proprietarioNome``  e ``proprietarioCidade``. Para o condutor, por exemplo
+    """
+    documento_alias = f"{nome}CPF" if nome == "condutor" else f"{nome}CPFCNPJ"
+
+    colunas = [
+        f"{alias}.Nome_RazaoSocial AS [{nome}Nome]",
+        f"{alias}.UF AS [{nome}UF]",
+        f"{alias}.Municipio AS [{nome}Cidade]",
+        f"{alias}.Bairro AS [{nome}Bairro]",
+        f"{alias}.CEP AS [{nome}CEP]",
+        f"{alias}.Logradouro AS [{nome}Endereco]",
+        f"{alias}.Numero AS [{nome}Numero]",
+        f"{alias}.Complemento AS [{nome}Complemento]",
+        f"{alias}.CPF_CNPJ AS [{documento_alias}]",
+        f"CONCAT({alias}.Telefone1DDD, {alias}.Telefone1) AS [{nome}Telefone]",
+        f"CONCAT({alias}.Telefone2DDD, {alias}.Telefone2) AS [{nome}Celular]",
+        f"{alias}.Email AS [{nome}Email]",
+    ]
+
+    return dedent(",\n".join(colunas)).strip()
+
+
+def sql_base() -> str:
+    """Retorna o SQL base do relatorio completo de servicos."""
+    return f"""
+    SELECT
+        s.ServicoNumero AS [OS],
+        tc.Numero AS [RI],
+        i.Id AS [idInspecao],
+        CONVERT(CHAR, s.AberturaDataHora, 103) AS [dataAberturaOS],
+        i.AberturaDataHora AS [dataAberturaInspecao],
+        s.TipoServico AS [codigoServico],
+        {CASE_TIPO_SERVICO} AS [tipoServico],
+        {CASE_TIPO_INSPECAO} AS [tipoInspecao],
+        CONVERT(VARCHAR(20), i.NumeroCsvSerpro) AS [numeroCSV],
+        esc.Codigo AS [numeroEscopo],
+        esc.Nome AS [nomeEscopo],
+        i.InspecaoEmissaoDataHora AS [dataConclusaoInspecao],
+        i.ConcluidoDataHora AS [dataFinalizacaoInspecao],
+        i.CsvCorrigidoDataHora AS [dataCorrecaoInspecao],
+        i.InspecaoVencimentoData AS [dataVencimentoDocumento],
+        nf.Numero AS [NF],
+        s.ValorBrutoServico AS [valorBruto],
+        s.ValorServico AS [valorLiquido],
+        fdt.Nome AS [formaPagamento],
+        i.CsvPdfArquivoNome AS [csvArquivo],
+        i.SisLitNomeArquivoLaudo AS [sislitArquivo],
+        tp.Portaria AS [portariaInmetro],
+        vw_esc.Descricao AS [descricaoEscopo],
+        {CASE_SITUACAO_INSPECAO} AS [situacaoInspecao],
+        s.Placa AS [placa],
+        s.Chassi AS [chassi],
+        charac.EspecieVeiculo AS [especieVeiculo],
+        charac.TipoVeiculo AS [tipoVeiculo],
+        charac.MarcaModelo AS [marcaModelo],
+        charac.AnoFabricacao AS [anoFabricacao],
+        charac.AnoModelo AS [anoModelo],
+        charac.Carrocaria AS [carrocaria],
+        g.SeloNumero AS [numeroSelo],
+        p.ConfirmadoCpf AS [cpfInspetor],
+        p.ConfirmadoNome AS [nomeInspetor],
+        i.ConfirmadoCpf AS [cpfEngenheiro],
+        i.ConfirmadoNome AS [nomeEngenheiro],
+        ind.Nome_RazaoSocial AS [indicacaoNome],
+        {_campos_contato("prop", "proprietario")},
+        {_campos_contato("cont", "contratante")},
+        {_campos_contato("cond", "condutor")}
+    FROM dbo.Servicos AS s
+    INNER JOIN dbo.Inspecoes AS i
+        ON s.Id = i.ServicoId
+    LEFT JOIN dbo.TabelaCertificado AS tc
+        ON tc.ServicoId = s.Id
+    LEFT JOIN dbo.SivWin_CaracteristicasSerpro AS charac
+        ON s.CaracteristicaAtualSerproId = charac.Id
+    LEFT JOIN dbo.TabelaPortarias AS tp
+        ON s.PortariaId = tp.Id
+    LEFT JOIN dbo.NotasFiscais AS nf
+        ON s.NotaFiscalId = nf.Id
+    LEFT JOIN dbo.Financeiro_Lancamentos AS fl
+        ON s.ServicoNumero = fl.NumeroPedido
+        AND fl.SistemaRemoto = 'SIVWIN'
+    LEFT JOIN dbo.Financeiro_DocumentosTipos AS fdt
+        ON fdt.Id = fl.DocumentoTipo
+    LEFT JOIN dbo.Principal_Indicacoes AS ind
+        ON s.IndicacaoId = ind.Id
+    LEFT JOIN dbo.Gnv AS g
+        ON g.ServicoId = s.Id
+    LEFT JOIN dbo.Processos AS p
+        ON p.Id = i.ProcessoId
+    INNER JOIN dbo.Principal_Contatos AS prop
+        ON s.proprietarioId = prop.Id
+    INNER JOIN dbo.Principal_Contatos AS cont
+        ON s.ClienteId = cont.Id
+    INNER JOIN dbo.Principal_Contatos AS cond
+        ON s.CondutorId = cond.Id
+    LEFT JOIN dbo.SivWin_ProcedimentosEscopoServicoSerpro AS pess
+        ON s.Id = pess.ServicoId
+    LEFT JOIN dbo.SivWin_ProcedimentosEscoposSerpro AS pes
+        ON pess.ProcedimentoEscopoId = pes.Id
+    LEFT JOIN dbo.SivWin_TabelaEscoposSerpro AS esc
+        ON pes.EscopoDenatranId = esc.Id
+    LEFT JOIN dbo.RelatoriosSiv_SivWin_InspecoesPorEscopoInmetro_View AS vw_esc
+        ON s.ServicoNumero = vw_esc.ServicoNumero
+    """

relatorios_sivwin-0.2.0/src/relatorios_sivwin/queries/gerais.py

@@ -0,0 +1,127 @@
+"""Consultas SQL de relatorios gerais do ecossistema SivWin."""
+
+from __future__ import annotations
+
+from ..contracts import SQLQuery
+from ._shared import (
+    CASE_SITUACAO_DECLARACAO,
+    CASE_TIPO_INSPECAO,
+    CASE_TIPO_SERVICO,
+    _campos_contato,
+)
+
+
+class RelatoriosGeraisQueries:
+    """Agrupa relatorios gerais nao concentrados em um unico subdominio."""
+
+    def __init__(self, database: str = "otimiza") -> None:
+        self.database = database
+
+    def relatorio_declaracoes(self, os_numero: int) -> SQLQuery:
+        """Gera a consulta usada na emissao da declaracao por OS."""
+        sql = f"""
+        SELECT
+            s.ServicoNumero AS [OS],
+            tc.Numero AS [RI],
+            CONVERT(VARCHAR(10), s.AberturaDataHora, 103) AS [dataAberturaOS],
+            CONVERT(VARCHAR(10), i.AberturaDataHora, 103) AS [dataAberturaInspecao],
+            i.NumeroCsvSerpro AS [numeroCSV],
+            esc.Codigo AS [numeroEscopo],
+            esc.Nome AS [escopo],
+            {CASE_TIPO_INSPECAO} AS [tipoInspecao],
+            {CASE_TIPO_SERVICO} AS [tipoLaudo],
+            tp.Portaria AS [portariaInmetro],
+            {CASE_SITUACAO_DECLARACAO} AS [situacaoInspecao],
+            s.ValorBrutoServico AS [valorBruto],
+            nf.Numero AS [NF],
+            fdt.Nome AS [formaPagamento],
+            s.Placa AS [placa],
+            s.Chassi AS [chassi],
+            charac.Carrocaria AS [carrocaria],
+            charac.MarcaModelo AS [marcaModelo],
+            charac.EspecieVeiculo AS [especieVeiculo],
+            charac.TipoVeiculo AS [tipoVeiculo],
+            charac.AnoFabricacao AS [anoFabricacao],
+            charac.AnoModelo AS [anoModelo],
+            {_campos_contato("prop", "proprietario")},
+            {_campos_contato("cont", "contratante")},
+            {_campos_contato("cond", "condutor")}
+        FROM dbo.Servicos AS s
+        INNER JOIN dbo.Inspecoes AS i
+            ON s.Id = i.ServicoId
+        LEFT JOIN dbo.TabelaCertificado AS tc
+            ON tc.ServicoId = s.Id
+        LEFT JOIN dbo.SivWin_CaracteristicasSerpro AS charac
+            ON s.CaracteristicaAtualSerproId = charac.Id
+        LEFT JOIN dbo.TabelaPortarias AS tp
+            ON s.PortariaId = tp.Id
+        LEFT JOIN dbo.NotasFiscais AS nf
+            ON s.NotaFiscalId = nf.Id
+        LEFT JOIN dbo.Financeiro_Lancamentos AS fl
+            ON s.ServicoNumero = fl.NumeroPedido
+           AND fl.SistemaRemoto = 'SIVWIN'
+        LEFT JOIN dbo.Financeiro_DocumentosTipos AS fdt
+            ON fdt.Id = fl.DocumentoTipo
+        INNER JOIN dbo.Principal_Contatos AS prop
+            ON s.proprietarioId = prop.Id
+        INNER JOIN dbo.Principal_Contatos AS cont
+            ON s.ClienteId = cont.Id
+        INNER JOIN dbo.Principal_Contatos AS cond
+            ON s.CondutorId = cond.Id
+        LEFT JOIN dbo.SivWin_ProcedimentosEscopoServicoSerpro AS pess
+            ON s.Id = pess.ServicoId
+        LEFT JOIN dbo.SivWin_ProcedimentosEscoposSerpro AS pes
+            ON pess.ProcedimentoEscopoId = pes.Id
+        LEFT JOIN dbo.SivWin_TabelaEscoposSerpro AS esc
+            ON pes.EscopoDenatranId = esc.Id
+        WHERE s.ServicoNumero = %s
+        ORDER BY OS ASC
+        """
+        return SQLQuery(
+            sql=sql,
+            params=(os_numero,),
+            name="relatorio_declaracoes",
+            database=self.database,
+        )
+
+    def relatorio_art(self, os_numero_inicio: int, os_numero_fim: int) -> SQLQuery:
+        """Gera a consulta do relatorio para emissao de ART por faixa de OS."""
+        sql = f"""
+        WITH cte_art AS (
+            SELECT
+                s.ServicoNumero AS [OS],
+                tc.Numero AS [RI],
+                CONVERT(CHAR, s.AberturaDataHora, 103) AS [dataAberturaOS],
+                {CASE_TIPO_SERVICO} AS [tipoLaudo],
+                CONVERT(VARCHAR(20), i.NumeroCsvSerpro) AS [numeroCSV],
+                i.InspecaoEmissaoDataHora AS [dataConclusaoInspecao],
+                s.Placa AS [placa],
+                s.Chassi AS [chassi],
+                ROW_NUMBER() OVER (
+                    PARTITION BY s.ServicoNumero
+                    ORDER BY i.InspecaoEmissaoDataHora ASC, i.Id ASC
+                ) AS rn
+            FROM dbo.Servicos AS s
+            INNER JOIN dbo.Inspecoes AS i
+                ON s.Id = i.ServicoId
+            LEFT JOIN dbo.TabelaCertificado AS tc
+                ON tc.ServicoId = s.Id
+            WHERE 
+                s.ServicoNumero BETWEEN %s AND %s
+                AND s.TipoServico = %s
+                AND i.SituacaoVeiculo IN (1, 2, 6)
+        )
+        SELECT
+            OS, RI, dataAberturaOS, tipoLaudo, numeroCSV, dataConclusaoInspecao, placa, chassi
+        FROM cte_art
+        WHERE rn = 1
+        ORDER BY OS ASC
+        """
+        params = (os_numero_inicio, os_numero_fim, "SR")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="relatorio_art",
+            database=self.database,
+        )
+        

relatorios_sivwin-0.2.0/src/relatorios_sivwin/queries/servicos.py

@@ -0,0 +1,277 @@
+"""Consultas SQL do dominio de servicos e inspecoes."""
+
+from __future__ import annotations
+
+from ..contracts import SQLQuery
+from ._shared import sql_base
+
+
+class RelatoriosServicosQueries:
+    """Agrupa consultas relacionadas ao ciclo de vida dos servicos."""
+
+    def __init__(self, database: str = "otimiza") -> None:
+        self.database = database
+        self._sql_base = sql_base
+
+    def relatorio_completo(self, start: str, end: str) -> SQLQuery:
+        """Gera o relatorio completo de servicos abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com servicos cuja OS foi aberta entre
+            ``startT00:00:00`` e ``endT23:59:59``.
+        """
+        sql = f"""
+        {self._sql_base()}
+        WHERE
+            s.AberturaDataHora BETWEEN %s AND %s
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="relatorio_completo",
+            database=self.database,
+        )
+
+    def cis_emitidos(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de CIs/RIs emitidos para servicos CSV abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro por OS que possui RI,
+            numero CSV e situacao aprovada ou corrigida.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                tc.Numero IS NOT NULL
+                AND s.TipoServico = %s
+                AND i.SituacaoVeiculo IN (1, 6)
+                AND i.NumeroCsvSerpro IS NOT NULL
+                AND s.AberturaDataHora BETWEEN %s AND %s
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = ("SR", f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="cis_emitidos",
+            database=self.database,
+        )
+
+    def servicos_aprovados(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de servicos aprovados pela conclusao da inspecao.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro por OS cuja inspecao
+            foi emitida/concluida entre ``startT00:00:00`` e ``endT23:59:59``
+            e esteja aprovada ou corrigida.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                i.InspecaoEmissaoDataHora BETWEEN %s AND %s
+                AND i.SituacaoVeiculo IN (1, 6)
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="servicos_aprovados",
+            database=self.database,
+        )
+
+    def servicos_reprovados(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de servicos reprovados abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro reprovado por OS cuja
+            abertura ocorreu entre ``startT00:00:00`` e ``endT23:59:59``.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                s.AberturaDataHora BETWEEN %s AND %s
+                AND i.SituacaoVeiculo IN (2)
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="servicos_reprovados",
+            database=self.database,
+        )
+
+    def servicos_inmetro(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de servicos INMETRO/CSV abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro por OS de servicos do
+            tipo ``SR`` abertos no intervalo informado.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                s.AberturaDataHora BETWEEN %s AND %s
+                AND s.TipoServico IN ('SR')
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="servicos_inmetro",
+            database=self.database,
+        )
+
+    def servicos_sislit(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de servicos SISLIT abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro por OS de servicos do
+            tipo ``LS`` abertos no intervalo informado.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                s.AberturaDataHora BETWEEN %s AND %s
+                AND s.TipoServico IN ('LS')
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="servicos_sislit",
+            database=self.database,
+        )
+
+    def servicos_laudo_geral(self, start: str, end: str) -> SQLQuery:
+        """Gera a consulta de servicos de Laudo Geral abertos no periodo.
+
+        Args:
+            start: Data inicial no formato ``YYYY-MM-DD``.
+            end: Data final no formato ``YYYY-MM-DD``.
+
+        Returns:
+            Consulta parametrizada com o ultimo registro por OS de servicos do
+            tipo ``LG`` abertos no intervalo informado.
+        """
+        sql = f"""
+        WITH base AS (
+            {self._sql_base()}
+            WHERE
+                s.AberturaDataHora BETWEEN %s AND %s
+                AND s.TipoServico IN ('LG')
+        )
+        SELECT *
+        FROM (
+            SELECT TOP 1 WITH TIES *
+            FROM base
+            ORDER BY ROW_NUMBER() OVER (
+                PARTITION BY OS
+                ORDER BY
+                    dataConclusaoInspecao DESC,
+                    RI DESC
+            )
+        ) AS consulta
+        ORDER BY OS ASC
+        """
+        params = (f"{start}T00:00:00", f"{end}T23:59:59")
+        return SQLQuery(
+            sql=sql,
+            params=params,
+            name="servicos_laudo_geral",
+            database=self.database,
+        )

relatorios_sivwin-0.2.0/src/relatorios_sivwin.egg-info/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: relatorios-sivwin
+Version: 0.2.0
+Summary: Consultas SQL reutilizaveis para o ecossistema SivWin/Otimiza.
+Keywords: sql,django,sivwin,otimiza,relatorios
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# Relatorios SivWin
+
+Biblioteca Python para centralizar consultas SQL do ecossistema SivWin/Otimiza.
+
+## Instalacao
+
+```bash
+pip install relatorios-sivwin
+```
+
+O nome publicado usa hifen, mas o import Python usa underscore:
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+```
+
+## Objetivo
+
+- Concentrar consultas SQL em um unico lugar.
+- Reduzir duplicacao de regras SQL entre projetos.
+- Facilitar o uso das mesmas consultas em Django, scripts e outros servicos.
+
+## Estrutura
+
+- `relatorios_sivwin.SQLQuery`: contrato padrao para consultas parametrizadas.
+- `relatorios_sivwin.RelatoriosSivWin`: hub principal de acesso aos dominios.
+- `relatorios_sivwin.RelatoriosGeraisQueries`: consultas gerais, como declaracoes e ARTs.
+- `relatorios_sivwin.RelatoriosServicosQueries`: consultas do dominio de servicos e inspecoes.
+- `relatorios_sivwin.dbapi`: helpers opcionais para executar uma `SQLQuery` com um cursor ja aberto.
+
+## Exemplo Rapido
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_art(120000, 120999)
+
+print(consulta.sql)
+print(consulta.params)
+```
+
+Por padrao, a representacao SQL bruta usa `otimiza` como banco:
+
+```python
+relatorios = RelatoriosSivWin(database="sivwin_homolog")
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+print(consulta.to_sql_raw())
+```
+
+## Uso Com Django
+
+```python
+from django.db import connections
+from relatorios_sivwin import RelatoriosSivWin, fetch_all
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.servicos.relatorio_completo("2026-02-01", "2026-02-28")
+
+with connections["otimiza"].cursor() as cursor:
+    dados = fetch_all(cursor, consulta)
+```
+
+Nesse formato:
+
+- o Django continua responsavel pela conexao;
+- o pacote so define a consulta;
+- o mesmo objeto pode ser reutilizado em outros contextos.
+
+## Uso Fora Do Django
+
+```python
+from relatorios_sivwin import RelatoriosSivWin
+
+relatorios = RelatoriosSivWin()
+consulta = relatorios.gerais.relatorio_declaracoes(123456)
+
+cursor.execute(consulta.sql, consulta.params)
+linhas = cursor.fetchall()
+```
+
+## Principios Do Pacote
+
+- Sem acoplamento com conexao, `.env` ou credenciais.
+- Sem dependencias pesadas para gerar SQL.
+- Metodos de dominio retornam `SQLQuery`.
+- Queries sempre parametrizadas, sem interpolacao direta de valores.
+- Cada relatorio relevante tem sua propria SQL, escrita de forma explicita.
+- Reaproveitamento existe apenas onde ele realmente simplifica, como constantes SQL e bloco de contato.

relatorios_sivwin-0.2.0/src/relatorios_sivwin.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+README.md
+pyproject.toml
+src/relatorios_sivwin/__init__.py
+src/relatorios_sivwin/constants.py
+src/relatorios_sivwin/contracts.py
+src/relatorios_sivwin/core.py
+src/relatorios_sivwin/dbapi.py
+src/relatorios_sivwin.egg-info/PKG-INFO
+src/relatorios_sivwin.egg-info/SOURCES.txt
+src/relatorios_sivwin.egg-info/dependency_links.txt
+src/relatorios_sivwin.egg-info/requires.txt
+src/relatorios_sivwin.egg-info/top_level.txt
+src/relatorios_sivwin/queries/__init__.py
+src/relatorios_sivwin/queries/_shared.py
+src/relatorios_sivwin/queries/gerais.py
+src/relatorios_sivwin/queries/servicos.py
+tests/test_public_api.py
+tests/test_queries.py
+tests/test_sql_query.py

relatorios_sivwin-0.2.0/src/relatorios_sivwin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

relatorios_sivwin-0.2.0/src/relatorios_sivwin.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[dev]
+build
+pytest
+twine

relatorios_sivwin-0.2.0/src/relatorios_sivwin.egg-info/top_level.txt

@@ -0,0 +1 @@
+relatorios_sivwin

relatorios_sivwin-0.2.0/tests/test_public_api.py

@@ -0,0 +1,26 @@
+from relatorios_sivwin import (
+    RelatoriosGeraisQueries,
+    RelatoriosServicosQueries,
+    RelatoriosSivWin,
+    SQLQuery,
+)
+
+
+def test_public_api_exports_main_objects() -> None:
+    relatorios = RelatoriosSivWin()
+
+    assert relatorios.database == "otimiza"
+    assert isinstance(relatorios.gerais, RelatoriosGeraisQueries)
+    assert isinstance(relatorios.servicos, RelatoriosServicosQueries)
+
+    assert relatorios.relatorios_gerais is relatorios.gerais
+    assert relatorios.relatorios_servicos is relatorios.servicos
+    assert SQLQuery(sql="SELECT 1").sql == "SELECT 1"
+
+
+def test_public_api_accepts_custom_database() -> None:
+    relatorios = RelatoriosSivWin(database="sivwin_homolog")
+
+    assert relatorios.database == "sivwin_homolog"
+    assert relatorios.gerais.database == "sivwin_homolog"
+    assert relatorios.servicos.database == "sivwin_homolog"

relatorios_sivwin-0.2.0/tests/test_queries.py

@@ -0,0 +1,24 @@
+from relatorios_sivwin import RelatoriosSivWin, SQLQuery
+
+
+def test_servicos_query_returns_parameterized_sql_query() -> None:
+    relatorios = RelatoriosSivWin(database="sivwin_homolog")
+
+    query = relatorios.servicos.relatorio_completo("2026-03-01", "2026-03-31")
+
+    assert isinstance(query, SQLQuery)
+    assert query.name == "relatorio_completo"
+    assert query.database == "sivwin_homolog"
+    assert query.params == ("2026-03-01T00:00:00", "2026-03-31T23:59:59")
+    assert "s.AberturaDataHora BETWEEN %s AND %s" in query.sql
+
+
+def test_gerais_query_returns_parameterized_sql_query() -> None:
+    relatorios = RelatoriosSivWin()
+
+    query = relatorios.gerais.relatorio_art(120000, 120999)
+
+    assert isinstance(query, SQLQuery)
+    assert query.name == "relatorio_art"
+    assert query.params == (120000, 120999, "SR")
+    assert "s.ServicoNumero BETWEEN %s AND %s" in query.sql

relatorios_sivwin-0.2.0/tests/test_sql_query.py

@@ -0,0 +1,37 @@
+from relatorios_sivwin import SQLQuery
+
+
+def test_sql_query_normalizes_sql_and_params() -> None:
+    query = SQLQuery(
+        sql="""
+            SELECT *
+            FROM dbo.Servicos
+            WHERE ServicoNumero = %s
+        """,
+        params=[123],
+        name="servico_por_os",
+    )
+
+    assert query.name == "servico_por_os"
+    assert query.database == "otimiza"
+    assert query.sql.startswith("SELECT *")
+    assert query.params == (123,)
+
+
+def test_sql_query_to_sql_raw_quotes_values_for_inspection() -> None:
+    query = SQLQuery(
+        sql="SELECT * FROM exemplo WHERE nome = %s AND ativo = %s AND valor IS %s",
+        params=("D'Agua", True, None),
+    )
+
+    assert query.to_sql_raw("teste") == (
+        "USE [teste];\n\n"
+        "SELECT * FROM exemplo WHERE nome = 'D''Agua' AND ativo = 1 "
+        "AND valor IS NULL"
+    )
+
+
+def test_sql_query_to_sql_raw_uses_query_database_by_default() -> None:
+    query = SQLQuery(sql="SELECT 1", database="sivwin_homolog")
+
+    assert query.to_sql_raw() == "USE [sivwin_homolog];\n\nSELECT 1"