Example page · made-up app and data

What happens when a user signs up

Pocket Planner is a made-up app. Read left to right; hover or tap a box with a card.

User story

As a developer, I can see every step a new user's sign-up goes through, and which parts are live.

"Where does the welcome email actually get sent from?" (a made-up teammate)
Read left → right. It fits your window; a bigger window shows it bigger. Press 100% to read up close, then scroll sideways.
Steps →Who or what ↓
Youthe developer
Browser appwhat the user sees
API server
Database
Email service
AI model
1Fill in the form
Sam types sam@example.com
2Check and create
Email is free, so the account is made
3Save the user
4Say welcome
5Pick a first tip
6Land on the dashboard
You ship the formYour laptop
1Sign-up formName, email, passwordLive
2POST /signupChecks the email is free and hashes the passwordLiveHosted
3users tableOne new rowLive
4Welcome emailHover or tap for detailsOff
5First-day tipHover or tap for detailsIdeaai
6DashboardShows the tip at the topNext
You watch sign-upsAdmin page
  1. 1The browser sends the form to the API.
  2. 2The API writes the new user (green = a write).
  3. 3The API queues the welcome email.
  4. 4The tip shows on the dashboard.

Step details · click a box above to jump here

4Welcome email

Email service

What it does
Sends one welcome email with a link to confirm the address.
Runs on
A background job on the API server, so sign-up never waits for the email.
Status
Offuntil the sending domain is verified.
Data in
user.email, user.name
  1. Queue
  2. Fill template
  3. Send
  4. Opened

5First-day tip

AI model

What it does
Reads the new user's answers and picks one tip for their first day.
Model
Claude Haiku, with Gemini Flash-Lite as a fallback
Status
Ideanot built yet.
Cost
About a tenth of a cent per sign-up (made-up number).
Show the prompt
Task

Pick one tip for {{USER_NAME}}.

  • Keep it under 20 words
  • Use plain language
Q1 · Should the welcome email wait for the AI tip?
My pick: No, send it straight away
Why: Sign-up should never wait on a slow model.
Your answer:
Your notes (⌘S saves them into this page)

User story

As a developer, I can follow the welcome email from the queue to the user's inbox.

Read left → right. It fits your window; a bigger window shows it bigger. Press 100% to read up close, then scroll sideways.
Steps →Who or what ↓
API server
Email service
New userSam (made up)
1Queue the job
2Fill the template
3Send
4Open and confirm
Job queuedLive
welcome.htmlName and confirm link filled inLive
Send via providerOff
Sam clicks ConfirmNext

Why a queue

The sign-up request returns as soon as the job is queued. If the email provider is down, the job retries later and the user still gets in.

Made-up example.