All BlueprintsEducation

Study group finder

Learners studying the same thing say which hours they are free in an ordinary week. The product finds the stretches where enough of them are free at once, ranks them by how many people each one suits, and lets a group form around a window instead of around a time one person picked.

L2–L4Level range
8Sprints
39Tasks
Backend and frontendBuilt as

What you’ll build.

By the last sprint

A study group finder that understands time zones. Students say when they are free in a normal week and see the windows where enough of the group is free at once. A place somebody gives up goes to the next person waiting, and a place held by somebody who went quiet is offered again on its own.

What you’ll learn.

Each sprint is built around one skill. You show you have it in a pull request your team reviews, then explain it in a walkthrough.

Authentication

You can register and sign in a user, keep a request authenticated without asking for the password again, and explain where the credential lives in the browser and why there rather than somewhere else.

Scheduling a live session

You can schedule a session, show its time correctly for a learner anywhere in the world, and open joining only in the window where it makes sense.

Search and filtering

You can search a list by keyword, combine that with filters, and say what the database does to answer the query — including which part uses an index and which part cannot.

Enrolling on a course

You can enrol a learner, refuse one who does not qualify with a reason they can act on, and show that a full course cannot be over-enrolled.

Notifications people do not mute

You can notify a user when an event concerns them, show an unread count that survives a refresh, and honour a preference that says stop.

Background jobs

You can hand work to a worker, tell the user it is in progress, and show the result when it lands — and say what happens to that work if the process dies halfway.

Going live

Somebody who has never met you can open a URL and use the product — and you can say what is different about the copy running there, where its secrets come from, and what you do when a release turns out to be wrong.

The roadmap. 8 sprints, 39 tasks.

Every sprint has a goal and a set of tasks. Open a sprint to see the tasks you will pick up.

Sprint 01

An account and a clock

Somebody can make an account, come back to it, and the product knows which clock they live in.

4 tasks
  1. A learner can sign up and start using the product
  2. A learner comes back two days later and is still themselves
  3. Signing out on a shared machine leaves nothing behind
  4. Every account carries the clock its owner lives in
Sprint 02

Saying when you are free

A learner marks the hours they are free in a normal week, and those hours mean the same moment to everybody.

5 tasks
  1. A learner joins the subject they are studying, or starts it
  2. A learner paints the hours they are usually free
  3. Most Tuesdays, but not the Tuesday after next
  4. Seven in the evening means two different moments
  5. Every time on screen is in the clock of whoever is looking
Sprint 03

Where the week overlaps

A learner sees the windows where enough of the subject are free at once, best first, without waiting.

5 tasks
  1. The product finds the stretches where enough people are free at once
  2. The best window comes first, and the product says what best means
  3. A learner sees the windows, and who each one leaves out
  4. Finding the overlap stays quick as the subject grows
  5. A learner narrows the list to windows they can act on
Sprint 04

A group forms around a window

Enough learners agree on one window and it becomes a group, and the last place never goes to two people.

5 tasks
  1. A learner turns a window into a group
  2. Another learner joins a group that is forming
  3. The group becomes real when the fourth person joins
  4. Two people taking the last place get different answers
  5. The group has a page, and only its members see all of it
Sprint 05

When the window moves

People hear that a group formed, and hear when somebody's change breaks the time it agreed.

5 tasks
  1. A learner hears that a group formed at a window they suit
  2. The person a group leaves out is told what is close
  3. Changing your week tells the groups it affects
  4. A notice never shows a time that is no longer true
  5. Notices are a list somebody can keep up with
Sprint 06

Next in line

A place somebody gives up reaches the person who asked first, not the one who refreshed fastest.

5 tasks
  1. Leaving a group is one step and costs nothing
  2. A full group takes names, in the order they arrived
  3. A freed place is offered to the person who asked first
  4. Accepting takes the place, declining moves it on at once
  5. A group that falls below four says what it needs
Sprint 07

When nobody says anything

A place held by somebody who has gone quiet comes back on offer, and a run that fails is seen.

5 tasks
  1. Members are asked whether they are still coming
  2. A place nobody confirmed comes back without anybody noticing
  3. An offer nobody answers moves on by itself
  4. Work that stopped happening is noticed
  5. Running it twice changes nothing the second time
Sprint 08

Somewhere the group can reach

The product is on the internet at its own address, and the machine's own clock is not the product's clock.

5 tasks
  1. The product is on the internet at its own address
  2. The machine's own clock is not the product's clock
  3. The work that runs itself has somewhere to run
  4. No credential is in the repository
  5. Four people in two countries do the whole thing on the deployed product

Read before you build. The best engineers do.

Senior engineers read the docs before they touch the code. Every Blueprint comes with short documents on the product and its world, the kind a team hands a new hire. Read them well and you ask sharper questions and walk into every review prepared.

What you are building

The product, who it is for, and what finished means.

A week of free hours, and what counts as an overlap

The vocabulary the whole product uses: windows, quorum, the ninety-minute floor, and why a window is not a slot.

Build study group finder.

Start your free week. Adaeze runs your kickoff, and Lars reviews every pull request.