System Context¶

C4 Level 1 - System Context

This page describes PetFolio at the highest level: the system, the people who use it, and the external systems it depends on. For implementation detail, see Containers.

What is PetFolio?¶

PetFolio is a platform that connects pet owners and pet professionals around a shared, secure pet data record. It is made up of two products:

PetFolio Personal: The pet owner-facing app
PetFolio Business: The pet professional-facing app

Actors¶

Actor	Account Type	Description
Personal User	Personal	Creates and manages pet profiles for their own animals, shares with carers and family
Professional User	Professional	Manages animal records on behalf of an organisation (vet, groomer, breeder, rehoming centre, etc.)

External Systems¶

System	Purpose
Google (OAuth)	User authentication - PetFolio uses OAuth-only sign-in
Microsoft (OAuth, planned)	Alternative OAuth provider
Facebook (OAuth, planned)	Alternative OAuth provider

System Diagram (Level 1)¶

graph TD
    PU["<b>Personal User</b><br/><i>Manages their own pets' profiles</i>"]
    PRO["<b>Professional User</b><br/><i>Manages animal records for an organisation</i>"]

    PF["<b>PetFolio</b><br/><i>Connects pet owners and professionals around a shared, secure pet profile</i>"]

    OAUTH["<b>OAuth Providers</b><br/><i>Google, Microsoft, Facebook authentication (Planned)</i>"]

    PU -->|"Creates and shares pet profiles"| PF
    PRO -->|"Manages organisational animal records"| PF
    PF -.->|"OAuth 2.0"| OAUTH

    classDef c4-person fill:#08427b26,stroke:#08427B,stroke-width:2px
    classDef c4-system fill:#1168bd26,stroke:#1168BD,stroke-width:2px
    classDef c4-system-ext fill:#9999992e,stroke:#999999,stroke-width:2px

    class PU,PRO c4-person
    class PF c4-system
    class OAUTH c4-system-ext