All BlueprintsCommerce
Corner shop storefront
A small shop sells online. The shelf shows what is genuinely there, a basket survives the tab it was made in, the shop never takes money for a tin it does not have, and the buyer can follow their order until they pick it up.
What you’ll build.
A real online shop. The shopkeeper adds stock from their phone. Customers fill a basket that is still there tomorrow, and only one person can buy the last tin. Orders get paid for, tracked and collected, and anything nobody came back for goes back on the shelf 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.
File uploads
You can upload a file from the browser, store it somewhere the application does not own, and show it again on a later request — and say where the bytes travelled and what the database actually holds.
A cart that survives
You can add, change and remove items, keep the cart across a logout and login, and show a total that reflects prices as they are now.
Stock that cannot go negative
You can decrement stock on a sale and prove that a hundred simultaneous orders for ten items produce ten sales and ninety refusals.
An order that moves through states
You can move an order through its states, refuse a transition that should not happen, and show the history of how it got where it is.
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.
Behind the counter
A shopper can make an account and come back to it, and the till is not something anybody can issue themselves.
4 tasks
- A shopper can register and land signed in
- Coming back tomorrow to the same account
- Leaving properly on a borrowed laptop
- The till cannot be issued from the sign-up form
Stocking the shelves
The shopkeeper puts the shop's stock online from their phone, and a shopper can see what is for sale and how much is left.
5 tasks
- The shopkeeper puts a line of stock on the shelf
- A photograph taken on a phone, next to the delivery
- A shopper sees the shelf and what is left on it
- Taking a line off the shelf for good
- Only the shop can change the shelf
The basket
A basket outlives the tab it was made in, follows a shopper into their account when they sign in, and shows today's prices.
5 tasks
- Putting things in a basket and changing your mind
- The basket is still there tomorrow
- Two baskets, one person, when they sign in
- The basket charges today's price, and says when it moved
- A basket is not a promise, and it has to say so
The last one on the shelf
Money is taken, the count goes down by exactly what was bought, and two shoppers buying the last tin at the same instant produce one order and one refusal.
5 tasks
- A basket becomes an order somebody has paid for
- The shelf goes down when the money is taken, and not before
- The count can never go below zero
- Two shoppers buy the last tin at the same instant
- What the shopper who lost the last tin sees
Held, not sold
Starting to pay holds the stock for long enough to finish, and a checkout nobody finished gives it back.
5 tasks
- Opening the checkout holds the stock for a stated time
- Stock somebody is paying for is not available to anybody else
- A claim that ran out stops the shopper before the money, not after
- Walking away from a checkout gives the stock back
- The shopkeeper counts the shelf while people are buying
Where the order is
An order moves from paid to ready to collected, the shopper can see where it is, and cancelling puts the stock back.
5 tasks
- A shopper can see where their own order is
- The shopkeeper works through the day's orders
- An order only moves in ways that make sense, and the moves are kept
- Cancelling an order puts the stock back on the shelf
- Cancelled at the same instant it was being put together
When the shop is shut
Lapsed holds go back on the shelf and the shopper hears their order is ready, with nobody at the shop pressing anything.
4 tasks
- Lapsed holds go back on the shelf with nobody looking
- Work that runs twice does no harm
- The shopper hears that their order is ready
- When the unattended work stops, somebody finds out
Open for business
The shop is on the internet at its own address, with data that survives a restart, mail that leaves, and a way back from a bad release.
6 tasks
- A stranger can reach the shop without you
- Nothing the shop needs exists only on the laptop
- Mail that genuinely leaves
- The shelf keeps itself honest on the host too
- An address worth typing, that a browser does not warn about
- A release that can be undone, and knowing when the shop is down
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 shop, who uses it, and what finished means.
What a count means
On hand, held and available are three different numbers, and confusing them is most stock bugs.
More commerce Blueprints.
Food ordering with options
Ordering for one restaurant, where a dish is a set of choices rather than a price. A size replaces the base price, extras add to it, some extras only exist on some sizes, and the total the customer is charged is worked out from what they chose rather than taken from the browser.
Restock waitlist
A waiting list for what a small shop has run out of. People ask to be told when it returns, and when three come back the stock goes down the line in the order they asked: held long enough to act on, offered to nobody behind them until that window closes, and never offered to the same person twice.
Event ticketing with door check-in
Tickets for one event: they sell until the allocation runs out, every seat carries its own code, and the door admits each code once, whatever the signal is doing.
Build corner shop storefront.
Start your free week. Adaeze runs your kickoff, and Lars reviews every pull request.