Add animal water through visitation observation

[arruda]

Should replace previous idea for more generic observation type: #31

[arruda]

Here is the proposed json-ld:

{
    "@type": "WaterTroughVisitationObservation",
    "activityType": {
        "@type": "FarmCalendarActivityType",
        "@id": "urn:farmcalendar:FarmCalendarActivityType:55cf0568-a998-43e8-9b4d-c49e74e853e7"
    },
    "title": "Water Trough Visitation",
    "details": "",
    "phenomenonTime": "2025-02-27T15:15:02Z",
    "hasEndDatetime": "2025-02-27T19:15:02Z",
    "observedAt": {
        "@type": "Parcel",
        "@id": "urn:farmcalendar:Parcel:00000000-0000-0000-0000-000000000001"
    },
    "madeBySensor": {
        "@type": "Sensor",
        "name": "TroughSensor123"
    },
    "hasResult": {
        "@type": "QuantityValue",
        "hasValue": "200",
        "unit": null
    },
    "observedProperty": "uniqueAnimalsCount",
    "missingAnimals": [
        "urn:farmcalendar:FarmAnimal:00000000-0000-0000-0000-000000000001",
        "urn:farmcalendar:FarmAnimal:00000000-0000-0000-0000-000000000023"
    ],
    "totalVisits": {
        "@type": "QuantityValue",
        "hasValue": "250"
    }
}

• UniqueAnimalsCount: (from the fields "hasResult" and "observedPropert") represents the total unique RFIDs recorded on that period.
• totalVisits: is a field that specifies the sum of visits to the trough (not unique visits) on that period
• missingAnimals: is a field that contain the UUID (in FarmCalendar) of the cows that did not visit the water in that period.
• observedAt: is a field that will point to which parcel (e.g., pasture 1) this observation refers to.
  The coordinates are then no longer needed, since they can be retrieved from the parcel that is referenced in the observation.

I'm considering here that the references to animals, parcel and other entities in the FarmCalendar will be done using the same standard approach as the rest of the system, by using the the internal ID of that entity (eg: "urn:farmcalendar:FarmAnimal:00000000-0000-0000-0000-000000000023" for some animal).

Since we don't know what the RFID contains, I can create in the FarmAnimal API endpoint a filter that will allow the user to retrieve a given animal based on the Country's Unique Animal ID (eg: "FR 12345").

[fedjo]

Nice Felipe.

Regarding the API to retrieve the animalId we discussed it offline.

What about the parcelId? How will the retrieve it in order to provide it in the above json?