Logging an Activity
Activity logging is the core of Heelr. Every time you interact with an animal -- whether it's a walk, a playgroup, enrichment, or a kennel observation -- you log it so others know what has already been done today.
Why Log Activities?
- Other volunteers and staff can see what the animal already did
- It prevents overstimulation from too many activities in a row
- It builds a history of what works for each animal over time
- It helps staff make better decisions about care plans
Quick Log
The fastest way to log an activity is the Quick Log modal. Tap the "Log Activity" button on any animal card or detail page.
Dog Activity Types
When logging for a dog, you'll choose from these tiles:
| Tile | What It Covers |
|---|---|
| Walk | Walking the dog (yard, trail, neighborhood) |
| Playgroup | Group play session with other dogs |
| Training | Training session (commands, behavior work) |
| Enrichment | Mental enrichment (puzzle toys, snuffle mats, games) |
| Kennel | Kennel-related tasks (see sub-categories below) |
| Incident | Neutral observational record of a notable event |
Dogs under 16 weeks old are automatically restricted from Walk and Playgroup activities. This is a biosecurity measure -- puppies with incomplete vaccination series cannot safely interact with outdoor environments or other dogs.
When logging for a pre-vax dog, you'll only see Training, Enrichment, Kennel, and Incident tiles. The restriction lifts automatically when the dog reaches 16 weeks based on their date of birth. Dogs with unknown DOB are not restricted.
Pre-vax dogs also cannot be tagged as participants in another dog's playgroup.
Kennel Sub-Categories
Tapping "Kennel" opens a second selection with three options:
| Sub-Category | Description |
|---|---|
| Cleaning | Cleaning the dog's kennel |
| Feeding | Feeding the dog |
| Kennel Observation | Observing the dog's behavior in their kennel space |
Cat & Other Activity Types
Cats and Other species have a simplified set of three activity types:
| Type | Description |
|---|---|
| Interaction | Any direct interaction (play, handling, socialization) |
| Enrichment | Mental enrichment activities |
| Observation | Observing the animal's behavior without direct contact |
Cats and Other species do not have behavior tracking features like mood capture, stress signals, or incident logging. These are dog-specific.
Logging Flow
- Select the activity type (required) -- tap a tile
- Fill in the details form -- what you see depends on the activity type
- Submit -- the activity is saved and the dashboard updates immediately
The goal is 3 taps for a simple log: select the animal, pick the activity type, and submit. You can add more detail when you have time, but the minimum is just the activity type.
Details by Activity Type
Walk
- Potty (required) -- Did the dog go? Options: None, Pee, Poop, Both
- Mood (required) -- Calm, Excited, Anxious, Fearful, or Unknown
- Duration -- Optional; preset chips (15, 30, 45 min) or custom
- Observations (expandable):
- Stool quality (if poop/both): Normal, Loose, Diarrhea, Bloody
- Urine concern (if pee/both): Normal, Excessive, Straining, Blood
- Vomit: Food or Bile
- Stress signals
- Medical concern toggle
- Notes
- Kennel cleaning flag -- Optionally flag that the kennel needs cleaning
Training
- Focus (required) -- How well the dog focused: Low, Medium, High
- Mood (required) -- Calm, Excited, Anxious, Fearful, or Unknown
- Duration -- Optional
- Observations (expandable):
- Treat interest: Eager, Neutral, Refused
- Stress signals
- Medical concern toggle
- Notes
Feeding
- Appetite (required) -- Ate All, Ate Half, Nibbling, Refused
- Mood -- Optional
- Observations (expandable):
- Vomit: Food or Bile
- Medical concern toggle
- Notes
Kennel Observation
- Approach (required) -- How the dog responds to your presence: Readily, Hesitant, Avoids
- Mood -- Optional
- Observations (expandable):
- Stress sign: Pacing, Trembling, Frozen, Growl
- Medical concern toggle
- Notes
Playgroup
- Mood -- Optional
- Duration -- Optional
- Participants (staff/admin only) -- Optionally tag up to 6 other dogs in the playgroup. Each tagged dog gets a shared playgroup activity logged automatically.
- Play Style -- Optional tags describing how the dog played (e.g., Rough & Tumble, Push & Pull, Toy Oriented, Gentle / Soft)
- Notes -- Optional
Enrichment
- Enrichment Type -- Optional category:
- Sniff / Search -- Nose work, scent games
- Lick / Chew -- Puzzle toys, long-lasting chews
- Move / Play -- Fetch, agility, active games
- Training / Learn -- Problem-solving, skill building
- Mood -- Optional
- Duration -- Optional
- Notes -- Optional
Kennel Cleaning
- Mood -- Optional
- Duration -- Optional
- Notes -- Optional
Incident
Incidents are neutral observational records. They do not change a dog's status, handling level, or trigger any automated workflow.
- Context (required) -- Where it happened: In Kennel, On Leash, Off Leash, Playgroup, Handling, Other
- What Happened (required) -- What occurred: Lunged, Snapped, Bit, Fight, Resource Guarding, Escape Attempt, Other
- Broke Skin -- Shown if Bit or Fight: Yes, No, Unknown
- Target (optional) -- Who/what was involved: Dog, Person, Cat, Object, None
- Notes (optional)
Behavior Support and Behavior Session logging is available on the Dog Detail page for staff and admin only. See Behavior Support for details.
Exit Behaviors
For activities that capture mood (Walk, Training, and optionally others), your selection maps to an exit behavior that's stored with the activity:
| Mood Selection | Exit Behavior | What It Means |
|---|---|---|
| Calm | Calm | The dog left relaxed and settled. Ideal outcome. |
| Excited | Excited | The dog was energized but not stressed. Normal for active dogs after play. |
| Anxious | Overaroused | The dog showed signs of anxiety or stress. |
| Fearful | Overaroused | The dog was overstimulated or fearful. May need a longer cooldown. |
Over time, exit behavior data reveals which activities work best for each dog.
Stress Signals
If you notice signs of stress during a walk, training session, or kennel interaction, you can check them off:
- Pacing -- Repetitive back-and-forth movement
- Trembling -- Visible shaking or trembling
- Frozen -- Suddenly going still and tense
- Growl -- Growling during the interaction
You don't need to check every box -- just note what you observe. This data helps staff identify patterns.
Medical Concerns
Any activity type with a details form includes a Medical Concern toggle. If you notice something that needs medical attention, flip the toggle and select the type:
- Injury / Cut
- Bite Wound
- Cough
- Vomiting
- Limping
- Other
Flagging a medical concern alerts staff to follow up.
Activity History
You can view the full activity history for any animal by visiting their detail page. Activities appear in reverse chronological order (newest first) with:
- Activity type and duration
- Who logged it
- When it was logged
- Exit behavior badge (if recorded)
- Behavior notes and stress indicators (expandable)
Shelter-Wide Activity History
The Activity History page (accessible from the navigation) shows all logged activities across your shelter. You can filter by:
- Animal -- Show activities for a specific animal
- Volunteer -- Show activities logged by a specific user
- Activity Type -- Filter to walks, playgroups, enrichment, etc.
- Date Range -- Today, Yesterday, Last 7 Days, Last 30 Days, This Week, Last Week, or All Time
Results load in pages -- tap Load More at the bottom to see older entries.
Permissions
- All users (volunteers, mod squad, staff, admin) can log activities for animals they're permitted to handle
- Only staff and admin can edit or delete activities after they've been logged
- Only staff and admin can log behavior support activities and behavior sessions (dogs only)
- Activities are designed to be immutable -- once logged, the record is preserved for accuracy