# MEIDAM-AR 0.1.0

Modelo Estándar de Intercambio de Datos Abiertos de Mascotas de Argentina.

- Versión: 0.1.0
- Estado: Borrador
- Fecha de publicación: 2026-11-19
- Editor: Misión Mascota
- Licencia: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.es)
- JSON Schema: <https://misionmascota.org/desarrolladores/estandar/0.1.0/pet.schema.json>

## Propósito

MEIDAM-AR define un lenguaje formal y uniforme para describir mascotas y, en próximas versiones, sus casos (pérdidas, hallazgos y avistamientos), de modo que cualquier sistema pueda producir, intercambiar y procesar estos datos sin ambigüedad.

Los nombres de campos y los códigos de valores están en inglés y coinciden con los que Misión Mascota utiliza internamente. Cada valor lleva su etiqueta en español, que es la que debe mostrarse a las personas usuarias.

Esta versión es un borrador: puede cambiar antes de la versión 1.0.0.

## Convenciones

- **Códigos**: Los valores enumerados se intercambian siempre por su código, nunca por su etiqueta. Las etiquetas en español son de referencia para la interfaz de usuario.
- **null / ausente**: No reportado: nadie informó el dato.
- **U**: Observado, no determinable: alguien miró y no pudo establecerlo.
- **Fechas**: ISO 8601, formato AAAA-MM-DD.
- **Unidades**: Peso en kilogramos (kg), altura en centímetros (cm).
- **Colores**: Hexadecimal #RRGGBB en mayúsculas, restringido a la paleta cerrada de cada campo.
- **Obsoleto**: Un campo obsoleto se sigue aceptando, pero los productores deben preferir su reemplazo. Se retira solo en una versión mayor.
- **Versionado**: SemVer. Una versión menor agrega campos o valores; una versión mayor rompe la compatibilidad.

## `pet` · Mascota

Las características de un animal, independientes de cualquier caso. Es la fuente autoritativa de sus rasgos.

### Identidad

| Campo | Tipo | Etiqueta | Valores |
| --- | --- | --- | --- |
| `species` **requerido** | string | Especie | `D` Perro · `C` Gato |
| `name` | string, ≤ 255 | Nombre | — |
| `name_response` | boolean | Responde a su nombre | — |
| `gender` | string | Sexo | `M` Macho · `F` Hembra · `U` Sin determinar |
| `breed` | string, ≤ 255 | Raza | Texto libre. Un catálogo de razas está previsto. |
| `is_pure_bred` | boolean | De raza pura | — |
| `date_of_birth` | string (date) | Fecha de nacimiento | — |
| `is_exact_dob` | boolean | Fecha de nacimiento exacta | false indica que date_of_birth es aproximada. |
| `is_neutered` | string | Castrado/a | `Y` Sí · `N` No · `U` Sin determinar |

### Rasgos físicos

| Campo | Tipo | Etiqueta | Valores |
| --- | --- | --- | --- |
| `size` | integer | Tamaño | `1` Mini / Toy · `2` Pequeño · `3` Mediano · `4` Grande · `5` Gigante |
| `weight_kg` | number | Peso | Unidad: kg. Hasta dos decimales. |
| `height_cm` | integer | Altura a la cruz | Unidad: cm. |

### Pelaje y ojos

| Campo | Tipo | Etiqueta | Valores |
| --- | --- | --- | --- |
| `coat_length` | integer | Largo del pelaje | `0` Sin pelo · `1` Pelo corto · `2` Pelo medio · `3` Pelo largo |
| `coat_pattern` | string | Patrón del pelaje | `S` Sólido (un solo color) · `B` Bicolor · `T` Tricolor · `A` Atigrado / brindle · `M` Manchado · `P` Moteado / ruano · `C` Carey · `I` Siamés (puntos) |
| `coat_color_1` | string | Color de pelaje principal | Paleta `coat` |
| `coat_color_2` | string | Color de pelaje secundario | Paleta `coat` |
| `coat_color_3` | string | Color de pelaje terciario | Paleta `coat` |
| `eyes_color` | string | Color de ojos | Paleta `eyes` |
| `eyes_color_2` | string | Color del segundo ojo | Paleta `eyes`. Solo ante heterocromía (ojos de distinto color). |

### Cola y orejas

| Campo | Tipo | Etiqueta | Valores |
| --- | --- | --- | --- |
| `tail_type` | string | Tipo de cola | `L` Larga · `M` Media · `C` Corta · `E` Enroscada · `X` Cortada (amputada) · `U` Muñón · `N` Sin cola (de nacimiento) |
| `tail_length` *obsoleto* | integer | Cola | `0` Sin cola (cortada) · `1` Con cola (natural). Obsoleto: usar tail_type. |
| `tail_notes` | string, ≤ 255 | Detalle de la cola | — |
| `ear_type` | string | Tipo de orejas | `E` Erguidas / paradas · `C` Caídas · `S` Semierguidas (quebradas) · `X` Cortadas · `P` Muy peludas / con flecos |

### Identificación

| Campo | Tipo | Etiqueta | Valores |
| --- | --- | --- | --- |
| `collar` | string | Collar | `Y` Sí · `N` No · `U` Sin determinar |
| `collar_color` | string | Color del collar | Paleta `collar` |
| `collar_description` | string, ≤ 255 | Descripción del collar | — |
| `idtag` | string | Chapita identificatoria | `Y` Sí · `N` No · `U` Sin determinar |
| `idtag_description` | string, ≤ 255 | Descripción de la chapita | — |
| `description` | string | Descripción | Texto libre: señas particulares, comportamiento, contexto. |

## Paletas de colores

### `coat`

- `#000000` Negro
- `#FFFFFF` Blanco
- `#FFFDD0` Crema
- `#E5AA70` Arena / Beige
- `#FFD700` Marrón Dorado
- `#B5651D` Marrón Madera
- `#654321` Marrón Chocolate
- `#A52A2A` Marrón Rojizo
- `#808080` Gris
- `#C0C0C0` Plata
- `#8099B2` Azul Grisáceo

### `eyes`

- `#5A3C28` Marrón Oscuro
- `#C58E55` Marrón Claro / Ámbar
- `#997C57` Avellana
- `#81878B` Gris
- `#6B8E23` Verde Oliva
- `#6495ED` Azul Cielo

### `collar`

- `#000000` Negro
- `#FFFFFF` Blanco
- `#FF0000` Rojo
- `#00FF00` Verde
- `#0000FF` Azul
- `#FFFF00` Amarillo
- `#FFA500` Naranja
- `#800080` Púrpura
- `#00FFFF` Cian
- `#FFC0CB` Rosa
- `#808080` Gris
- `#800000` Granate
- `#008000` Verde Oscuro
- `#000080` Azul Marino
- `#FFD700` Dorado
- `#A52A2A` Marrón

## Ejemplo

```json
{
    "$schema": "https://misionmascota.org/desarrolladores/estandar/0.1.0/pet.schema.json",
    "meidam_version": "0.1.0",
    "pet": {
        "species": "D",
        "name": "Toby",
        "name_response": true,
        "gender": "M",
        "breed": "Mestizo",
        "is_pure_bred": false,
        "date_of_birth": "2021-03-01",
        "is_exact_dob": false,
        "is_neutered": "Y",
        "size": 3,
        "weight_kg": 14.5,
        "coat_length": 1,
        "coat_pattern": "B",
        "coat_color_1": "#654321",
        "coat_color_2": "#FFFFFF",
        "eyes_color": "#5A3C28",
        "tail_type": "L",
        "ear_type": "C",
        "collar": "Y",
        "collar_color": "#FF0000",
        "idtag": "N",
        "description": "Mancha blanca en el pecho, muy sociable."
    }
}
```

## Previsto

- Caso (case): pérdida, hallazgo y avistamiento, con estado, fechas y ubicación.
- Catálogo de razas.
- Contacto y fotos.

## Historial de versiones

- **0.1.0** (2026-11-19): Borrador inicial: estructura de la mascota.
