Course content

Module 1

Module 2

Module 3

Module 4

Module 5

Module 6

Module 7

Module 8

Module 9

Module 10

Module 11

Module 12

Module 13

Module 14

Module 15

Module 16

Module 17

Module 18

4 to 6 hours

Final Project: Mini Order Management System

Translate a small business brief into a tested modular program

By the end of this lesson

  • Translate a small business brief into a tested modular program
  • Explain validation, rounding and reporting policies

Your mission

Build an in-memory order program that validates records, calculates quotes, searches and filters orders, and produces a summary. It is a small program with realistic decisions, not a SaaS application. No DOM, database, payment system or real API is required.

Build your own implementation and test suite from the brief below. Start with a new practice folder and the JavaScript skills from the preceding modules. Your reasoning, source files and tests are the deliverable.

Create package.json at your project root with "type": "module", as shown in the modules lesson. This lets Node run your .js files with import and export.

Start with a precise brief

An order has a nonempty string id, a customer record and at least one item. The customer has a nonempty name, a type of standard or premium, and a Boolean active field. An inactive customer cannot receive a quote under this exercise's policy.

Each item has a nonempty name, a nonnegative integer unitPriceCents and a positive integer quantity. Amounts and products must stay within JavaScript's safe integer range. A missing array, missing property, numeric string or fractional quantity is invalid. Do not silently convert or drop it.

Represent money in integer cents to make units explicit. We assume a currency with 100 cents per unit. Real systems may need other monetary conventions; those are outside this exercise.

Confirm the pricing policy

  1. Sum unitPriceCents multiplied by quantity for every item.
  2. An active premium customer receives a 10% discount when the subtotal is strictly greater than 10,000 cents.
  3. Round the discount to the nearest whole cent using Math.round; for nonnegative half-cent values this rounds upward.
  4. Apply 20% exercise tax to the discounted subtotal and round that tax to the nearest cent using the same rule.
  5. Add discounted subtotal and tax. There is no delivery charge or promotion stacking in this project.

These fictional policies are fully specified so you can test them. They do not describe actual tax obligations.

Predict before implementing

Case Subtotal Discount Tax Total
Standard customer, one 10,000-cent item 10000 0 2000 12000
Premium customer, exactly 10,000 cents 10000 0 2000 12000
Premium customer, 15,000 cents 15000 1500 2700 16200
Standard customer, a 103-cent item 103 0 21 124
Inactive customer ? ? ? Reject

Compute the table by hand. A successful normal quote is insufficient: the exact threshold and a fractional tax case reveal different decisions.

Design the data and responsibilities

validation.js: validate the order, customer, items and collection ids
pricing.js: calculate subtotal, eligibility, discount, tax and total
orders.js: search, filter and summarize valid and invalid orders
main.js: prepare sample input and display results
tests.js: execute behavioral checks

Keep related calculation helpers together rather than creating one file per formula. A quote returns its component amounts so the result can be explained. Query functions return matching source records without modifying them.

Define reporting rules too

Order ids must be unique within a collection. Reject a duplicate-id collection because a search would otherwise be ambiguous. Structural errors in a record should be identified, not omitted from a report silently.

A summary contains accepted quotes and invalid records with reasons. Its total counts only valid quotes and must be labeled as such. For an empty collection, accepted and invalid lists are empty, total is zero and average is null. A non-array input is invalid.

Searching a valid unique collection by id returns the matching record or null. Filtering by customer type returns an array. These operations do not themselves approve an order: quote validation makes that decision.

Implement in deliberate stages

  1. Write requirements and open questions in your own words.
  2. Create your expected-result table, including missing data and boundaries.
  3. Write validation before arithmetic can consume invalid inputs.
  4. Implement one quote and test its component amounts.
  5. Add collection queries and the summary.
  6. Separate modules once responsibilities are clear.
  7. Run the complete suite after each refactor.

Do not add an interface to conceal an uncertain rule. A console report is enough to demonstrate correctness at this stage.

Required tests

Cover standard and premium customers, the exact threshold, above-threshold eligibility, inactive customers, missing names, unsupported customer types, no items, zero quantity, fractional quantity, text prices, nonfinite amounts, unsafe totals, rounding, duplicate ids, empty collections, absent searches and input immutability.

Include a mixed collection with one valid and one invalid order. Verify that the invalid record is reported and excluded from the financial total. Test the returned details, not only whether the function completed.

Run and review your project

Write tests.js for the required cases, main.js for the sample report and README.md for your setup and policy decisions. Run node tests.js, then node main.js. Compare the results with the table above. Use clear error wording of your own, and test the failure behavior. Ask another person to follow your README without extra instructions; note anything you need to clarify.

Change request: demonstrate your mindset

The owner changes eligibility to "10,000 cents or more." Before changing code, identify the expected row that changes. Then add a second request: "special discounts for some customers." Explain why the second request cannot yet be implemented faithfully.

Review and correction

At exactly 10,000 cents, a premium quote now has discount 1000, discounted subtotal 9000, tax 1800 and total 10800. The standard quote remains 12000. The 15,000-cent premium case stays 16200. Special discounts still require eligibility, rate, priority and combination rules. List those questions rather than inventing answers.

Submission rubric

Area Weight Evidence
Understanding and policy 25% Clear rules, units, assumptions and examples
Correct behavior 25% Valid quotes, explicit rejection and honest reports
Tests 20% Boundaries, failure cases and unchanged input
Organization 15% Responsibilities and readable function contracts
Reasoning and revision 15% Counterexample, alternatives and change analysis

Submit your source, test command, brief and decision journal. Explain what remains outside scope, such as persistence and concurrency. A maintainable program makes both its behavior and its limits understandable.

Preserve the baseline for Course 03

Keep the changed-threshold experiment in a separate copy or branch. Before continuing, restore or select the baseline implementation: premium eligibility is strictly above 10000 cents, so exactly 10000 yields 12000 total. Your 15000-cent premium example must yield 16200. Keep the changed-policy tests with the changed-policy version, not mixed into the baseline suite.

Continue to Course 03's first lesson with that baseline and its passing tests. Course 03 reuses quote validation and pricing; your search, filtering and summary functions remain useful Course 02 deliverables but are not all exposed in its initial interface. The browser bonus below is an optional preview.

Lesson complete?

Your progress is saved on this device.