People and roles
Who someone is at a club. A role is club-wide; everything else is a relationship to particular records.
- Owner
- The person who registered the club. Everything an admin can do, plus deleting the club, transferring ownership and exporting a child's data. A club always has exactly one.
owner- Admin
- Runs the club's office: members, sponsors, supporters, tickets, audit log, and all the football.
admin- Director
- Runs the football: seasons, teams, players, assessments, training, matches, notes, exercises. Not members or money.
director- Staff
- A club member with no appointment yet. Can see the club exists and its seasons — nothing else until appointed to a team.
staff- Member
- Anyone in one of the four club roles. Parents, players, sponsors and supporters are never members.
member- Head coach
- Appointed to one team season. Assesses, plans training, writes notes, manages the roster and staff list. Needs a confirmed email; in production, an authenticator app.
HEAD_COACH- Coach
- Appointed to one team season. Assesses, plans training, writes notes; does not change the roster or staff.
COACH- Assistant coach
- Like a coach, but does not manage development plans or the drill library.
ASSISTANT_COACH- Team manager
- Appointed to one team season for logistics: fixtures, attendance, availability. Sees the roster, never a child's development.
TEAM_MANAGER- Guardian
- A parent or carer who follows one child. Not a member. Reads the child's development and family-visible notes, records the child's training.
guardian- Player (own login)
- A child whose record is linked to their own account. Sees themself only: their development and this week's training, which they can mark done.
self- Sponsor representative
- Represents a sponsor company. Sees the sponsor's page and counts across the clubs it backs — never a player. Admin representatives invite colleagues.
SPONSOR_ADMIN · SPONSOR_MEMBER- Supporter
- Anyone who chose to follow a club. Sees the club's public face and what is on sale.
supporter- Ticket owner
- The account a season ticket was issued to. Reaches that ticket and the club's public listings.
ticket-owner
The club
The container everything else lives in.
- Club
- A football club or academy. In the system it is a Better Auth organization; its profile (country, timezone, badge) is ClubHub's.
club · organization- Season
- A named period at a club, e.g. 2026. One is current.
season- Team
- A team as an identity that outlives a season — U10 Tigers.
team- Team season
- A team entered into one season. Staff are appointed to it and players rostered on it. Most coaching screens are about a team season.
team season- Appointment
- A staff member's role on one team season. Ended, never deleted.
team staff assignment- Roster
- The players assigned to a team season for the season.
roster- Registration
- A player registered with a club for a season. This is what puts a child inside a club's boundary.
player registration- Transfer
- Moving a rostered player to another team season. The old assignment is marked transferred and a new one opens.
TRANSFERRED- Staff invitation
- The club office inviting someone to become a member in a role. Accepted on a confirmed address.
invitation
The player
A person, not a club's record.
- Player
- A child (or adult) who plays. Has a profile, may have an account, may be registered with more than one club.
player- Position
- Primary position, plus optional secondary positions.
GOALKEEPER · DEFENDER · MIDFIELDER · FORWARD- Preferred foot
- —
LEFT · RIGHT · BOTH- Player status
- Active, inactive (paused) or archived (kept, hidden).
ACTIVE · INACTIVE · ARCHIVED- Has account
- Whether the player's record is linked to their own login.
linkedUserId
The development loop
The heart of the product: assess, prioritise, assign, reassess.
- Skill
- One thing to be good at — first touch, positioning, resilience. Scored 1 to 5 in half steps.
skill- Skill category
- An FA 4-corner area: Technical, Game IQ, Physical, Psychological, Social (the default; a club can have its own).
skill category- Taxonomy
- The club's full set of categories and skills. Seeded when the club is created.
taxonomy- Assessment
- One coach's scoring of a player's skills on one day. Never edited or overwritten — a new assessment is a new record.
assessment- Assessment context
- What kind of occasion the assessment was. Required on every assessment.
FORMAL · TRAINING · MATCH- Assessment template
- What a coach is asked on that kind of day: criteria from the club's taxonomy, per context and age group, core first. It shapes the sheet, never forces a write.
assessment template- Core criteria
- The handful every player gets on a normal day — in training: effort, focus, technical execution, decision making, teamwork, coachability.
core- Coach's picks
- On one assessment: what stood out, the development point, the next focus — up to three skills each, plus a comment.
strength · development point · next focus- Not observed
- A criterion left blank. Never forced, never recorded — the analytics only hold what a coach actually saw.
omitted- Self-assessment / In their own words
- The player's answer after training or a match: what went well, what was hard, what to improve, plus effort · confidence · enjoyment. Written by the player or a guardian; read beside the coach's picture, never averaged into it.
player self assessment- Assessment sheet
- The whole squad, every skill, last scores — one screen so a coach can assess a team in minutes.
assessment sheet- Bulk assessment
- Saving the sheet: all players at once, all or nothing.
bulk- Score / Level
- Whole levels 1–5, each with a name: Needs Support, Developing, Competent, Strong, Excellent. Children see the name and dots, never the number.
1–5- Level
- The child's word for a score: dots filled out of five. The banner's level is the average of every skill.
level- Development Engine
- The one place strengths, priorities, improvements and consistency are computed. Every screen renders its answer; none recompute it.
engine- Strength / Superpower
- A skill the player is already strong in. Superpower is the child's word.
strength- Priority / Work on next
- Where the next block of work should go. One thing at a time.
priority- Improvement / Getting better
- A skill that went up between the two most recent assessments.
improvement- Progress
- The engine's summary for one player: strengths, priorities, improvements, category averages, consistency, match form.
progress- Trend
- A skill's full score series over time, for charts.
trend- Goal
- A target score on one skill, set by a coach with the player. Achieved is stamped once.
ACTIVE · ACHIEVED · ARCHIVED- Observation / Coach note
- Something a coach wrote about a player, with an explicit audience.
observation- Visibility
- Who a note (or other record) is for. Private is the author's alone — even from the club office.
PRIVATE · COACHING_STAFF · CLUB · FAMILY
Training
What the family does between sessions.
- Exercise / Drill
- An entry in the club's drill library, linked to the skills it develops.
exercise- Routine / Training plan
- A weekly plan a coach assigns to one player: a few drills, each so many times a week. Assigning a new one retires the old.
ACTIVE · COMPLETED · ARCHIVED- Activity
- One drill inside a routine, with its times-per-week target.
training activity- Completion / Mark done
- The family's — or the player's own — record that an activity was done. The one thing a family writes.
training completion- This week
- The last seven days, not the calendar week.
rolling 7 days- Weekly target
- The sum of every activity's times-per-week.
target- Streak
- Consecutive weeks that met the target. The current week never breaks it.
streak- Consistency
- Per-week completions capped at the target, summed, over what was expected. Null with no plan; 0 with a plan and nothing done.
0–1- Training session
- A team's session on the pitch, with its register.
training session- Attendance
- Who was at a session.
PRESENT · LATE · ABSENT · EXCUSED- Availability
- Whether a player can make sessions and matches; managed by the family and the team manager.
availability
Matches
Context beside the development picture — never a skill score.
- Match / Fixture
- A team season's game: opponent, kick-off, venue, result.
SCHEDULED · PLAYED · CANCELLED- Venue
- —
HOME · AWAY · NEUTRAL- Lineup
- Who played, started, minutes, goals, assists, and the coach's rating.
lineup- Match form
- A player's last 90 days of matches in one number and a few counts. Context only.
form- Coach review
- The coach's notes on a match after it was played.
review
The story
One feed, written as things happened.
- Story / Timeline
- Every moment in a player's development, newest first, in chapters by month.
timeline- Moment / Event
- One entry in the story.
ASSESSMENT_COMPLETED · GOAL_CREATED · GOAL_ACHIEVED · TRAINING_ACTIVITY_COMPLETED · COACH_OBSERVATION · MATCH_PLAYED · PLAYER_SCORED · DEVELOPMENT_PRIORITY_CHANGED- Highlights
- What the story is made of: counts of trainings, assessments, matches, goals.
highlights- Big moment
- An assessment, a goal reached, a goal scored — outlined in the story.
big
Families and invitations
How anyone who is not staff gets in.
- Relationship invitation
- An email link to one address that opens one relationship: a guardian to a child, a player to their own login, a representative to a sponsor. Never club membership.
GUARDIAN · PLAYER · SPONSOR_MEMBER- Accept
- Signed in on the invited address, the person accepts — the moment the relationship exists.
accept- Access grant
- A guardian's reach into one child at one club. What the API reads. Revoked, never deleted.
ACTIVE · REVOKED- Relationship kind
- How a guardian relates to the child.
MOTHER · FATHER · PARENT · LEGAL_GUARDIAN · CARER · OTHER- Family
- The child's guardians and, when linked, the child's own login. The Family tab on the phone; the Family card on the web.
family- Give a login / Account invitation
- Inviting a player to their own account. Links only when accepted on the address.
account-invitation- Link account
- Tying an existing account to a player, for an address that already has one. Fresh sign-in required.
link-account- End access
- Revoking a guardian's grant. The record stays.
revoke
Sponsors, supporters and tickets
Relationships with a club that are not membership and reach no child.
- Sponsor
- A company that backs one or more clubs.
sponsor- Sponsorship
- A sponsor backing a club, or one team season: tier and dates.
ACTIVE · ENDED- Sponsor analytics
- Counts across the clubs a sponsor backs — teams, registered players, matches, sessions. Nothing names a child.
analytics- Follow / Supporter membership
- Choosing to follow a club. Anyone signed in can.
ACTIVE · CANCELLED- Ticket product
- What a club sells for a season: name, price, seats per ticket.
season ticket product- Season ticket
- A ticket issued to an account. Ownership reaches that ticket, nothing else.
ACTIVE · CANCELLED- Holder
- A person a ticket admits, named by its owner within the seats.
holder- Entitlement
- What a ticket admits to, and whether it was used.
HOME_MATCH · EVENT
Sign-in and security
- Session
- Being signed in on one device. Listed under Security; any one can be ended.
session- Sign out everywhere
- End every session, on every device — a lost phone.
revoke sessions- Authenticator app / Two-factor
- A six-digit code from an app, after the password. Required for owners, admins, directors and head coaches in production.
TWO_FACTOR_REQUIRED- Backup code
- One-time codes for when the authenticator is lost. Shown once at enrolment.
backup code- Fresh sign-in
- Some actions need a session younger than 15 minutes: transferring ownership, removing an admin, linking an account, turning off two-factor.
FRESH_AUTH_REQUIRED- Confirmed address
- An email address proven by clicking its link. Needed to accept staff invitations.
emailVerified- Permission
- A named ability, e.g. player.read. Nobody has one; a relationship carries it over what it is held over.
player.read · development.read …- Not found
- What anyone outside a record's reach is told — the same answer as for a record that does not exist.
404- Audit event
- A record of a sensitive change or security event: who, what, when. Children are involved.
audit