Discussão geral

[jeanpimentel]

Levantamos alguns campos e cenários e chegamos nas seguintes informações necessárias:

Data: DIA/MES ou (móvel) [obrigatório]
Nome: Nome do Feriado [obrigatório]
Descrição: Descrição
Tipo: Feriado ou Ponto facultativo ou Data comemorativa [obrigatório]
Horário de Início: HH:MM:SS (caso diferente de 00:00:00)
Horário de Término: HH:MM:SS (caso diferente de 23:59:59)
Regulamentação: número da lei e link (caso necessário)

Inicialmente pensamos em mapear os feriados somente, e depois prosseguir com pontos facultativos e datas comemorativas, para não poluirmos demais nos esforços iniciais.

A idéia inicial é mapearmos através de issues. Enquanto isso, vamos discutindo qual o melhor formato pra disponibilizar os dados.

Podemos pensar em JSON, SQL, XML etc, ou até todos esses se houver necessidade.

[filhodanuvem]

Certo @dadosbr/owners

Apoio JSON como formato principal e primário, por sua fácil integração com linguagens de programação e já ser um tipo bem aceito no retorno de API's, o que pode vir a se tornar um segundo passo para o @dadosbr .

Fico um pouco em dúvida se nossas chaves deveriam ser em pt-br, já que é muito comum criarmos sistemas em inglês. Estaríamos indo contra a maré. De qualquer forma abaixo mostra o rascunho baseado nas informações necessárias:

{
    "data" :  "Y/m" ,
    "nome" : "Confraternização universal",
    "descricao" : "Início do ano civil, Dia Mundial da Paz, além de Dia da Fraternidade Universal, sendo assim, um feriado internacional, adotado por quase todas as nações do planeta.",
    "tipo" : "feariado", 
    "HoraInicio" : "H:i:s",
    "HoraFim" : "H:i:s",
    "numberoLei" : "10.607",
    "linkLei" : "http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
    "dataCriacao" : "Y-m-d" 
}

Achei melhor isolar as informações de criação da lei decretada. O que vocês acham?

[jeanpimentel]

@cloudson Eu não quis separar o campo de regulamentação porque as vezes podem ser N campos. Pode ser que tenha mais de uma lei sobre o assunto, ou um artigo de uma constituição, etc.

[luads]

Qual a idéia em relação aos feriados móveis? Manter dados anuais?

[jeanpimentel]

@hisamu eu inicialmente pensei em disponibilizar em secundário.

podemos colocar uma propriedade a mais, com uma lista, exemplo:

carnaval:

"data": "",
"nome": "Terça-feira de Carnaval",
"descrição": "",
"tipo": "Feriado",
"datasMoveis" : {
  "2014": "12/02",
  "2015": "23/02",
  "2016": "27/02",
}

aí precisaremos desenvolver um script que calcule isso e gere o json corretinho.

[filhodanuvem]

Entendi @jeanpimentel , mas você defente um campo só pra esses dados? Sei que parece difícil estruturar, mas vejo o (s) link pra lei e seu número como uma informação sensível demais pra se estar num texto puro.

E sobre as chaves serem em inglês?

[jeanpimentel]

O que acham disso?

Não quis colocar um campo a mais pra indicar se é fixo ou móvel pois isso pode ser verificado através de date. Se for vazio, basta procurar em variableDates.

[
    {
        "date": "01/01",
        "title": "Confraternização Universal",
        "description": "Início do ano civil, Dia Mundial da Paz, além de Dia da Fraternidade Universal, sendo assim, um feriado internacional, adotado por quase todas as nações do planeta.",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "",
        "title": "Sexta-Feira da Paixão",
        "description": "Data cristã na qual a morte de Cristo é lembrada.",
        "legislation": "Lei nº 9.093, de 12 de setembro de 1995 - http://www.planalto.gov.br/ccivil_03/Leis/L9093.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {
            "2015": "03/04",
            "2016": "25/03",
            "2017": "14/04",
            "2018": "30/03",
            "2019": "19/04",
            "2020": "10/04"
        }
    },
    {
        "date": "21/04",
        "title": "Tiradentes",
        "description": "Homenagem ao mártir da Inconfidência Mineira",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "01/05",
        "title": "Dia do Trabalhador",
        "description": "Dia Internacional dos Trabalhadores, adotado por muitos países.",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "variableDates": {}
    },
    {
        "date": "07/09",
        "title": "Independência",
        "description": "Data do chamado Grito do Ipiranga, que iniciou o processo de Independência do Brasil.",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "12/10",
        "title": "Nossa Senhora Aparecida",
        "description": "Padroeira do Brasil",
        "legislation": "Lei nº 6.802, de 30 de junho de 1980 - http://www.planalto.gov.br/ccivil_03/Leis/L6802.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "02/11",
        "title": "Finados",
        "description": "Dia de memória aos mortos",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "15/11",
        "title": "Proclamação da República",
        "description": "Derrubada da Monarquia e instalação da República.",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    },
    {
        "date": "25/12",
        "title": "Natal",
        "description": "Celebração cristã do nascimento de Cristo",
        "legislation": "Lei nº 10.607, de 19 de dezembro de 2002 - http://www.planalto.gov.br/ccivil_03/leis/2002/L10607.htm",
        "type": "feriado",
        "startTime": "",
        "endTime": "",
        "variableDates": {}
    }
]

[alexandre-mbm]

Sugiro uma olhada em gammasoft / brasil / lib / dados.

[alexandre-mbm]

Afinal, qual será a sintaxe dos JSON? Como indicar ponto-facultativo?

O que me incomoda é saber que os termos de uso não permitem usá-lo para dados!

[jeanpimentel]

@alexandre-mbm opa Alexandre, td bem? Apesar de ter começado esse repositório, acabei ficando sem tempo para mantê-lo por todo esse tempo.

Quais são suas sugestões? Eu não tinha me atentado pros termos de uso realmente.

[alexandre-mbm]

Quais são suas sugestões? Eu não tinha me atentado pros termos de uso realmente.

Continuar o repositório, mas sem propor acesso direto aos arquivos dele. Para não corrermos o risco de sermos punidos.

Eu gostaria de saber exatamente a lógica da sintaxe. Poderíamos usar o wiki. Pretendo colaborar em algum momento, mas estou sem tempo. Gostaria de já encontrar padrões, quando vier.