Skip to content

User Flows

Jump to bottom
Luara edited this page Jul 5, 2026 · 2 revisions

User Flows

Documents the core flows from the user's point of view — what each profile experiences from arrival to their first real action.

Flow 1 — Anonymous User (Conflicted or Curious)

Profile: Arrived via search, has a problem or a curiosity. Doesn't know what a colony is.

Arrival → Educational home
    ↓
Sees entry cards for different situations
    ↓
Picks the card matching their situation
    ↓
Reads a contextual educational article
    ↓
Views the map (blurred location, ~500m)
    ↓
Clicks a nearby colony
    ↓
Reads the narrative, sees named cats
    ↓
[Decision] Want to do something?
  ├─ Yes → Report a sighting (no account)
  ├─ Yes → Create an account for more actions
  └─ No  → Leaves with more understanding than they arrived with

Principle applied: action before commitment. A visitor can contribute without ever creating an account.

Flow 2 — Emergency (any user)

Profile: Found an injured cat, suspects poisoning, or witnessed abuse. Needs guidance now.

Arrives via search or the navbar
    ↓
/help — no account required
    ↓
Picks the situation from 9 types:
  sighting · injured/sick cat · lone kitten · building conflict
  suspected poisoning · abuse · disease outbreak
  missing cat · threat to a whole colony
    ↓
Marks the location (approximate or exact)
    ↓
Receives contextual guidance:
  • Specific contact numbers
  • Step-by-step guidance
  • Legal resources (Lei 9.605/98, 181, CCZ, 190)
    ↓
[Optional] Registers the report in the system
    ↓
Report appears on the map and in the colony timeline

Principle applied: urgency prevails over identification. No signup step in the way.

Flow 3 — Signup and Onboarding

Clicks "Create account" or is redirected by an action requiring auth
    ↓
/signup — email and password
    ↓
Redirected back to the previous page (returnTo param, validated
against open-redirect — see Security)
    ↓
Profile row created automatically on first real access, streak at zero
    ↓
Cat assistant appears for the first time with a curiosity
    ↓
User can now:
  • See a more precise location (~100m)
  • Confirm reports
  • Follow colonies
  • Register a colony

Flow 4 — Colony Registration

/colony/new
    ↓
Validation questions before the form
    ↓
[If validation fails] → Redirects to registering a sighting instead
[If it passes] → Continues to the form
    ↓
Form:
  • Colony name
  • Cover photo (optional — not gated behind a dropdown choice)
  • Narrative (optional)
  • Pin on the map
    ↓
Colony created → user automatically becomes a caretaker
    ↓
Cat assistant appears celebrating
    ↓
CTA to add cats and complete the colony profile

Flow 5 — Caretaker's Daily Life

Opens Felines
    ↓
Goes straight to the colony via map or profile
    ↓
Colony page — actions available contextually:
  • [Top] Fed today / Watered today
  • [Timeline] Share a story
  • [Needs] Ask for help / Log a neutering
  • [Settings] Edit colony / Stop being a caretaker
    ↓
Check-in recorded → timeline event created
    ↓
Streak updated on profile (resets to 1, not 0, after a missed day)
    ↓
If another caretaker already checked in today: visual feedback

Flow 6 — Educational Journey

/learn — article index
    ↓
Picks an article by title or level
    ↓
Reads the article (progress bar)
    ↓
Fact chips with sources appear inline
    ↓
Scrolling to the end marks the article as read
    ↓
Cat assistant may appear with a curiosity
    ↓
After 3 articles read:
  Personalization quiz: "What kind of neighbor are you?"
    ↓
3 possible results (no right/wrong answer):
  • Observer • Backup • Guardian
    ↓
Profile-specific CTA: go to the map, report a sighting, etc.

Clone this wiki locally