Phase 05 · Lesson 09

Exercises and Phase Exit

≈ 3 min core reading · 704 source/companion words
Learning contract

What you should be able to do after this

  • Explain Exercises and Phase Exit without relying on framework buzzwords.
  • Connect the lesson to the phase outcome: Design HTTP APIs using resources, methods, status codes, idempotency, errors, caching semantics, and versionable contracts.
  • Reproduce the relevant behavior and verify it with evidence.
  • Diagnose at least one representative failure instead of guessing.
Figure 5.9 — TaskFlow boundary map
Client intent
HTTP method + URI
headers/body
server processing
status + response representation
client state transition
This lesson belongs to Phase 05. Keep the full request/data path visible even when today's code changes only one box.
Instructor workflow: predict first → implement the smallest slice → run it → inspect evidence → break one assumption → diagnose → explain it back. Do not copy the whole code block before understanding the first failing boundary.

FULL_STACK_DEVELOPER_2026_COMPLETE - Phase 05 Exercises and Phase Exit

VOLUME 02 - FRONTEND + BACKEND FOUNDATIONS

Exercises and Phase Exit Hands-on HTTP labs, debugging drills and the Phase 05 readiness standard

HTTP is the contract between independent programs.

REQUEST HTTP Client TaskFlow API

PowerShell / browser / later Next.js NestJS + Fastify RESPONSE

method + target + headers + optional body

status + headers + optional body

Figure - HTTP request/response exchange. Phase 05 studies the protocol before Phase 06 introduces a browser cross-origin call.

Book 9 of Phase 05

FULL_STACK_DEVELOPER_2026_COMPLETE - Phase 05 Exercises and Phase Exit

Hands-on lab - prove that HTTP is no longer magic Do the exercises with the TaskFlow API running independently. Do not open the Next.js frontend. Phase 05 is successful when you can reason from protocol contracts before integration hides details behind fetch helpers.

Level 1 - Follow 1 Create the Todos feature module/controller/service. 2 Implement GET /todos and GET /todos/:id. 3 Implement POST /todos with 201 behavior. 4 Implement PATCH /todos/:id. 5 Implement DELETE /todos/:id with 204. 6 Exercise every route from PowerShell and record method, URL, status and returned content.

Level 2 - Modify Add an optional description field to the in-memory Todo representation. Decide which requests should include it and prove GET/POST/PATCH behavior with PowerShell. Do not add formal DTO files yet.

Level 3 - Implement Add GET /todos?completed=true and GET /todos?completed=false. Parse the query string in the controller and delegate selection to the service. Explain why completed is a query parameter rather than a new route such as /getCompletedTodos.

Level 4 - Engineer Design the HTTP contract for an archive Todo capability. Compare at least two approaches: PATCHing an archived field versus an explicit action endpoint. State your assumptions and choose one based on domain semantics, not on a memorized REST rule.

Debugging drills Scenario What you should diagnose

Code
GET /todo/1 returns 404                       Compare path to registered resource route before inspecting service logic.
Code
POST /todos returns 400                       Inspect exact JSON and Content-Type before changing the server.

DELETE returns 204 but PowerShell prints no Recognize that no response content is expected. object

Second DELETE returns 404 Explain why DELETE can still have idempotent semantics despite a different response.

Server restart removes created Todos Identify in-memory persistence as the expected phase limitation.

PATCH succeeds but unknown fields are Identify missing formal validation; do not claim the current boundary is accepted production-complete.

Oral architecture exam ● What is the difference between a resource and a representation? ● Why can the same URL be used with GET and DELETE? ● What does safe mean in HTTP semantics? ● What does idempotent mean?

FULL_STACK_DEVELOPER_2026_COMPLETE - Phase 05 Exercises and Phase Exit

  • Why can two identical DELETE requests return different status codes and still have idempotent semantics?
  • Why is 201 more informative than 200 for resource creation?
  • Why should a 204 response not include a JSON body?
  • Why is /todos?completed=true different from /getCompletedTodos?
  • Why are we testing the API from PowerShell before using Next.js?
  • Why does the temporary Todo array intentionally disappear on restart?

Phase 05 exit checklist ● [ ] GET, POST, PATCH and DELETE routes work from PowerShell. ● [ ] you can identify request method, target, headers and content. ● [ ] you can identify response status, headers and content. ● [ ] you can explain safe and idempotent accurately. ● [ ] you use resource-oriented URLs by default. ● [ ] you understand why status codes are part of the contract. ● [ ] you can distinguish a route 404 from a missing-resource 404 through context. ● [ ] you can explain the temporary in-memory limitation without trying to add Prisma early. ● [ ] pnpm run build succeeds after the Todo endpoints are added.

NEXT: PHASE 06 - NEXT.JS <-> NESTJS COMMUNICATION

The protocol is now understandable. Phase 06 will finally make the Next.js application call the NestJS API, introduce frontend API configuration, browser network inspection and CORS at the moment cross-origin behavior actually becomes real.

Official source notes Primary protocol reference: RFC 9110 - HTTP Semantics (RFC Editor). Supplemental developer reference: MDN HTTP Reference and HTTP Request Methods. Nest-specific routing and status behavior reference: NestJS Controllers documentation.

This phase teaches HTTP semantics independent of a specific transport version. HTTP/2 and HTTP/3 change framing and transport details, while request methods, target resources, headers, status codes and representation semantics remain the important application-level concepts for this course.

Executable lesson studio · http

Now turn the explanation into engineering skill.

HTTP is the contract joining independently deployed systems. Method, URL, headers, body, status, and response semantics must agree on both sides.

By the end, you should be able to

  • Explain Exercises and Phase Exit in terms of concrete inputs, ownership, outputs, and evidence.
  • Implement or reproduce the smallest TaskFlow slice that demonstrates this http concept.
  • Diagnose one representative http failure using observable evidence instead of trial-and-error.
Figure 5.9B — Mental model
client
method + URL
headers/body
server contract
status + response
Read left-to-right while implementing. When debugging, walk right-to-left until the first observed fact differs from your prediction.
Code-along sequence

One coherent change at a time

  1. 01

    Restate the goal of “Exercises and Phase Exit” as one observable behavior. Write the success signal before touching code.

  2. 02

    Trace the boundary map: client → method + URL → headers/body → server contract → status + response. Mark the one boundary this lesson changes.

  3. 03

    Inspect the current repository state and record the exact files, route, table, or runtime involved. Avoid creating an abstraction before you can name the existing owner.

  4. 04

    Implement the smallest vertical slice. Add one coherent change, run the narrowest verification command, and read the output before continuing.

  5. 05

    Connect the slice to TaskFlow’s phase artifact: A written TaskFlow API contract for tasks with request/response examples and deliberate error semantics.. Verify behavior from the outside as a user or API client would.

  6. 06

    Create one controlled failure that is safe to reproduce. Predict the symptom first, capture evidence, locate the earliest broken boundary, then fix only that cause.

  7. 07

    Close the reference and rebuild or explain the core change from memory. Record what you would monitor or test before trusting the same change in production.

httpWrite the contract before the framework
POST /tasks HTTP/1.1
Content-Type: application/json
Authorization: Bearer <token>

{"title":"Ship TaskFlow"}

HTTP/1.1 201 Created

Do not copy this as a finished answer. Predict what each boundary does, type the smallest useful slice, run it, then compare the result with your prediction.

Verification

Prove the happy path

  1. Run the narrowest relevant command or request and require a clean exit/status.
  2. Inspect the boundary-specific evidence: terminal output, Network panel, database row/query plan, test report, container health, or deployment logs.
  3. Repeat the behavior once after the change so a one-off cached or stale result cannot masquerade as success.
Break it on purpose

Build debugging memory

  1. Using 200 for every outcome
  2. Change one assumption in the http example—identity, input, configuration, ordering, connectivity, or state—and predict the exact symptom before running it.
SymptomInvestigation path
Expected result does not appear

Return to the nearest observable boundary: input, network, process log, database, or rendered UI. Compare actual evidence with the predicted path.

A shortcut appears to fix it

Change one variable at a time and reproduce the original failure after the fix; otherwise you have correlation, not diagnosis.

Closed-reference challenge

Can you transfer the idea?

Without copying the final source, create a second small scenario that applies “Exercises and Phase Exit” to a different TaskFlow resource or input. Write the acceptance criteria first, implement it, and provide the evidence that each criterion is satisfied.

Explain-back

Answer these without reopening the solution

  1. What problem does Exercises and Phase Exit solve in TaskFlow, and what would be observably wrong without it?
  2. Which part of the http boundary owns the decision, and which neighboring layer must not own it?
  3. What evidence proves the happy path instead of merely suggesting it worked?
  4. Name one realistic failure or abuse case and the first place you would inspect.
  5. If requirements doubled tomorrow, which part of this design should stay stable and which part is allowed to change?
Lesson studio

Turn the reading into skill

01

Do it

Define success and failure status codes for create, read, update, delete, validation, auth, forbidden, and missing-resource cases.

Use the smallest change that demonstrates this lesson. Stop after it works and capture evidence.
02

Break it safely

Using 200 for every outcome

Predict the symptom before causing the failure. Then locate the earliest boundary where reality diverges from expectation.
03

Explain it back

Why does this responsibility live here, what input does it trust, what output proves success, and what would go wrong if another layer owned it?

If your explanation is vague, repeat the boundary trace before moving on.
Exit ticket

Before marking complete

Close the reference. Reproduce the core idea from memory or explain the exact request/data flow aloud. Then check your diff or notes for accidental shortcuts that bypass validation, authorization, error handling, or verification earned in earlier phases.