mercado_publico_cl 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 523a6d88bf7a955410f9fda0896f1bc83269b2559155c1451917c8dc4cf138fe
+  data.tar.gz: 4c1d1ac13173348c42533af60d158ec2be7c059458dc7a817368734a99370d5f
+SHA512:
+  metadata.gz: b6cf1cfe69f04e41a59fe4a614398a4670ac8b43a03c872a222921fca89bb2ae077dbd793fa5e59d939c47bbb656d2d7c949dadb2a186684c8f2db8fb5acca03
+  data.tar.gz: bfd5e78cb67fa89755034963180177334300396c258ffa60b2cc196004ed5da0936231d310cc644bd13a86a0fee7f59e38e46f253ebf7e715e6c7bfea0be791d

data/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+Todos los cambios notables de este proyecto se documentan en este archivo.
+
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
+y el proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/).
+
+## [0.1.0] - 2026-06-09
+
+Primera versión publicada.
+
+### Recursos
+
+- `Tender`, `PurchaseOrder`, `Supplier` y `PublicAgency` como value objects
+  (`Data.define`) con atributos en inglés y acceso al payload original vía
+  `raw`.
+- Objetos anidados: comprador, proveedor, ítems, fechas, contactos y
+  adjudicación (`TenderAward` con `resolution_number`, `resolution_date`,
+  `act_url`, `bidders_count`; proveedor adjudicado por ítem vía
+  `awarded_supplier_rut` / `awarded_supplier_name`).
+- `summary?` para distinguir resúmenes de listado del detalle completo.
+- Enums para estados, tipos, monedas, modalidades de pago, despacho,
+  unidades de tiempo, actos administrativos y monto estimado — incluida la
+  tabla propia del estado de OC según proveedor (`SupplierOrderStatus`,
+  confirmada contra la API real).
+
+### Cliente HTTP
+
+- Cliente HTTParty con traducción completa de errores
+  (`InvalidTicketError`, `NotFoundError`, `RateLimitError`, `TimeoutError`,
+  `ApiError` con `status_code`/`response_body`); los errores de red de bajo
+  nivel (`ECONNREFUSED`, `ECONNRESET`, SSL, EOF) se envuelven en `ApiError`.
+- Reintentos opcionales con backoff exponencial + jitter (`max_retries`,
+  `retry_base`, `retry_max_wait`, `retry_on`), que respetan el header
+  `Retry-After` y cubren también errores de red. Desactivados por defecto.
+- Query builder con validaciones (exclusividad de `code`, `status`/`date`,
+  requisitos de proveedor/organismo) y rechazo de fechas ambiguas con año
+  de dos dígitos.
+- Fechas default en **hora de Chile** (`MercadoPublicoCl.today`, zona
+  configurable vía `time_zone`): un worker en UTC ya no consulta el día
+  equivocado durante la noche chilena.
+- Parsing estricto de payloads: enteros en base 10 (sin octal), enums que
+  no truncan strings malformados, fechas dd-mm-yyyy con siglo correcto y
+  `parse_date` seguro bajo ActiveSupport.
+
+### Seguridad
+
+- El ticket se redacta de `Configuration#inspect`, de los logs y de
+  mensajes/cuerpos de `ApiError` (incluida la forma URL-encoded).
+- `base_url` exige `https` (se permite `http` solo hacia localhost, para
+  mocks y tests).
+- HTTParty con `no_follow: true` y `verify: true`: las redirecciones no se
+  siguen ni se reintentan, y la verificación TLS no es desactivable.
+
+### Rails
+
+- Generator `rails g mercado_publico_cl:install` que crea el initializer
+  con todas las opciones documentadas.
+- Railtie que copia la configuración completa desde
+  `config.mercado_publico_cl` (incluidas las opciones de reintentos).
+- Jobs base opcionales para ActiveJob (`Jobs::SyncTenders`,
+  `Jobs::SyncPurchaseOrders`) que validan el contrato `#process` antes de
+  gastar cuota de API.
+
+### Infraestructura
+
+- Suite RSpec + WebMock + SimpleCov (180 ejemplos, cobertura > 90%),
+  verificada en Ruby 3.2, 3.3, 3.4 y 4.0.
+- CI en GitHub Actions con esa misma matriz + RuboCop.

data/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contribuir
+
+¡Gracias por tu interés en mejorar `mercado_publico_cl`!
+
+## Setup
+
+```bash
+git clone https://github.com/nduartex/mercado_publico_cl.git
+cd mercado_publico_cl
+bin/setup          # instala las dependencias
+bundle exec rspec  # corre la suite de tests
+```
+
+Rubies soportados: **3.2, 3.3, 3.4 y 4.0** (el CI corre la matriz completa).
+
+## Flujo de trabajo
+
+1. Haz fork del repo y crea una rama para tu cambio.
+2. **Escribe primero un spec que falle** — cada bugfix y feature entra con
+   su test. La suite usa RSpec + WebMock; los specs no llaman a la API real.
+3. Haz que pase, manteniendo el cambio mínimo.
+4. Corre los chequeos localmente antes de pushear:
+
+   ```bash
+   bundle exec rspec            # todo verde, cobertura >= 90%
+   bundle exec rubocop          # sin ofensas
+   ```
+
+5. Abre un PR describiendo **qué** cambia y **por qué**. Si es sobre el
+   comportamiento de la API, adjunta evidencia (payloads reales ayudan
+   muchísimo — ¡redacta tu ticket antes!).
+
+## Guías del proyecto
+
+- El código y la API pública de la librería están en **inglés**; la
+  documentación de cara al usuario está en **español**.
+- Los mapeos de campos deben estar respaldados por evidencia: la
+  documentación oficial (<https://www.chilecompra.cl/api/>) o un payload
+  real. Las rarezas documentadas de la API (valores de filtro con typos,
+  booleanos invertidos) son intencionales — no las "corrijas".
+- Nunca registres ni commitees un ticket real. La gema lo redacta de
+  errores y logs; mantenelo así.
+- Una opción de configuración nueva necesita: default en `Configuration`,
+  fila en la tabla del README y entrada en el template del generator.
+
+## Reportar problemas
+
+Abre un issue en GitHub con: versión de Ruby, versión de la gema, la
+consulta que ejecutaste (sin tu ticket) y el error completo. Si la API
+devolvió algo inesperado, incluye el payload crudo si es posible.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Nelson Duarte
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.