banderas.json

/*
Cada regla lleva una categoría, un nombre, un tipo y parámetros del tipo.

Tipo: check-fields-bool
Descripción: verifica que los campos existan, tengan valor, y su valor no sea "---" o "null".
Parámetros:
fields: array de nombres de campo a verificar

Tipo: check-fields-inverse
Descripción: verifica que los campos NO existan o NO tengan valor.
Parámetros:
fields: array de nombres de campo a verificar

Tipo: check-schema-bool
Descripción: valida que el schema de todo el documento sea válido. Incluye los schemas de las extensiones.

Tipo: check-sections-bool
Descripción: Valida que cada una de las secciones principales de cada release y del compiledRelease contengan al menos un campo lleno. Si falla en algún caso, da false.

Tipo: date-difference-bool
Descripción: Calcula la diferencia en días entre las fechas
Parámetros:
fields.from fecha inicial que se resta de la siguiente
fields.to fecha final a la que se le resta la fecha inicial
difference.minimum: cantidad de días mínimos. si la resta es menor, da false.
difference.maximum: cantidad de días máximos. si la resta es mayor, da false.

Tipo: field-equality-bool
Descripción: Compara el valor de dos campos, si son diferentes da false.
Parámetros:
fields: array de campos a comparar.

Tipo: check-dates-bool
Descripción: Evalúa si las fechas de fields coinciden con las fechas de date. Si es así da false.
Parámetros:
fields: Array de campos a verificar.
dates: Array de fechas a verificar. TODO: Falta especificarlas mejor.

Tipo: check-field-value-bool
Descripción: Compara el valor de un campo a un conjunto de valores. Si coincide da false.
Parámetros:
fields: Array de campos a comprar.
values: Array de valores a comparar con el de los campos.

Tipo: check-url-field
Descripción: Chequea que el campo tenga una url
Parámetros:
fields: Array de campos a verificar

Tipo: comprensibility
Descripción: Aplica esta función: http://gitlab.rindecuentas.org/ivan/luigi_pipelines/blob/master/RedFlagsDocumentations.py#L263
Parámetros:
fields: Array de campos a verificar.

Cada campo de parámetros puede ser un array que soporta condiciones y operaciones.

Condiciones
-----------
Si las condiciones se cumplen, se aplica el value de esa condición.
El campo es un array. Cada elemento es un objeto con las siguientes propiedades:
- conditions, que es un objeto con campos y valores. Cada valor puede ser un objeto con un miembro and u or, y dentro de ese miembro un array de valores posibles para el campo.
- value: el valor que toma el campo si se cumplen las condiciones

Si no se cumple ninguna de las condiciones, el campo queda sin valor. Si ningún campo tiene valor, la regla da false.

Ejemplo:
"minimum": [
  {
    "conditions": {
      "country": "MX",
      "Tender.procurementMethodCaracterMxCnet": {
        "or": [
          "Nacional",
          "undefined"
        ]
      }
    },
    "value": 15
  }
]

Operaciones
-----------
Sobre cada field se puede aplicar una opcieación, la operación se define como nombre:valor
El único nombre soportado es substr y el valor de esta operación es un array de parámetros, desde qué caracter y cuántos caracteres.


Ejemplo:
{
  "value":"contract.amount.value",
  "operation": {
  "substr":[-5]
  }
}


*/
[
  {
    "category": "Transparencia",
    "name": "OCDS válido",
    "type": "check-schema-bool"
  },
  {
    "category": "Transparencia",
    "name": "Campos completos",
    "type": "check-all-fields-rate"
  },
  {
    "category": "Transparencia",
    "name": "Secciones completas",
    "type": "check-sections-bool"
  },
  {
    "category": "Temporalidad",
    "name": "Campos fundamentales para la temporalidad",
    "type": "check-fields-bool",
    "fields": [
      "award.date",
      "tender.period.endDate",
      "tender.period.startDate",
      "contract.date",
      "contract.period.startDate"
    ]
  },
  {
    "category": "Temporalidad",
    "name": "Tiempo insuficiente de preparación de oferta",
    "type": "date-difference-bool",
    "difference":{
      "minimum": [
        {
          "conditions": {
            "country": "MX",
            "Tender.procurementMethodCaracterMxCnet": {
              "or": [
                "Nacional",
                "undefined"
              ]
            }
          },
          "value": 15
        },
        {
          "conditions": {
            "country": "MX",
            "Tender.procurementMethodCaracterMxCnet": "Internacional"
          },
          "value": 20
        }
      ]
    },
    "fields":{
      "from":"Tender.period.startDate",
      "to": "Tender.period.endDate"
      }
  },
  {
    "category": "Temporalidad",
    "name": "Fechas sospechosas",
    "type": "check-dates-bool",
    "fields": [
      "award.date",
      "tender.period.endDate",
      "tender.period.startDate",
      "contract.date",
      "contract.period.startDate"
    ],
    "dates": [
          "1/1",
          "5/2",
          "tercer lunes de marzo",
          "19/3",
          "29/3",
          "30/3",
          "semana santa",
          "1/5",
          "1/7 (cada 6 años)",
          "16/9",
          "2/10",
          "tercer lunes de noviembre",
          "1/12",
          "12/12",
          "25/12",
          "domingo"
    ]
  },
  {
    "category": "Temporalidad",
    "name": "Duraciones larga",
    "type": "date-difference-bool",
    "difference":{
      "maximum": 1000
    },
    "fields":{
      "from":"contract.period.startDate",
      "to": "contract.period.endDate"
    }
  },
  {
    "category": "Competitividad",
    "name": "campos fundamentales para la competitividad",
    "type": "check-fields-bool",
    "fields": [
      {
          "value":"parties.name",
          "conditions": {
            "parties.role": "supplier"
          }
      },
      "tender.procurementMethod"
    ]
  },
  {
    "category": "Competitividad",
    "name": "Paraísos fiscales",
    "type": "check-field-value-bool",
    "fields": "party.address.countryName",
    "values": [
      "Uruguay",
      "/* Armar listado de paises basado en https://www.financialsecrecyindex.com/introduction/fsi-2018-results mayores a 60 */"
    ]
  },
  {
    "category": "Trazabilidad",
    "name": "Escala inconsistente",
    "type": "field-equality-bool",
    "fields": [
      "parties.details.scaleReportedByBuyerMxCnet", "parties.details.scaleReportedBySupplierMxCnet"
    ]
  },
  {
    "category": "Trazabilidad",
    "name": "campos fundamentales para la trazabilidad",
    "type": "check-fields-bool",
    "fields": [
      "planning.budget",
      {
        "value": "party.name",
        "conditions": {
          "party.role": "supplier"
        }
      },
      {
        "value": "party.name",
        "conditions": {
          "party.role": "buyer"
        }
      }
    ]
  },
  {
    "category": "Trazabilidad",
    "name": "Modificaciones al contrato",
    "fields": "contracts.amendments",
    "type": "check-fields-inverse"
  },
  {
    "category": "Trazabilidad",
    "name": "Información de las partes",
    "fields": {
      "value":"parties.contactPoint.name",
      "condition": {
        "or": [
          "parties.contactPoint.email",
          "parties.contactPoint.telephone"
          "parties.contactPoint.faxNumber"
          "parties.contactPoint.url",
        ]
        }
      },
    "type": "check-fields-bool"
  },
  {
    "category": "Trazabilidad",
    "name": "Proveedor fantasma",
    "fields": {
        "value": "party.identifier.id",
        "conditions": {
          "party.role": "supplier"
        }
    },
    "type": "check-fields-bool"
  },
  {
    "category": "Trazabilidad",
    "name": "Importe redondeado",
    "fields": [
      {
        "value":"contract.amount.value",
        "operation": {
        "substr":[-5]
        }
      }
    ],
    "values":["00000"],
    "type": "check-field-value-bool"
  },
  {
    "category": "Trazabilidad",
    "name": "Comprensión del título",
    "fields": ["contracts.title","TODO: falta otro: row23 y row26"],
    "type": "comprensibility"
  },
  {
    "category": "Trazabilidad",
    "name": "Falta de referencia oficial",
    "fields": "source",
    "type": "check-url-field"
  }
]