SOURCE-BASED CODE QUALITY WORKSHOP

This package preserves the existing lecture demo and homework, including their
intentionally weak tests. It also contains the standalone Python examples from
the restored lesson. It is a local review draft, not production-ready commerce code.

Start with demo. Its policy includes a book discount, an optional general
discount, and a premium discount. The homework is a DIFFERENT policy: book and
VIP discounts only. Do not transfer the demo's general discount into homework.

On macOS/Linux, from the extracted package:
  cd demo
  python3 -m venv .venv
  .venv/bin/python -m pip install -r requirements.txt
  .venv/bin/python -m pytest -q

On Windows, create the environment with py -m venv .venv, then use
.venv\Scripts\python instead of .venv/bin/python in those commands.

The recovered test only checks that a result is positive. Strengthen it with
independently calculated expected values before treating it as meaningful evidence.
The improved reference is not a fully validated checkout system.

Original demo/homework: earliest site commit 1945e87, 2026-03-24.
Original algorithm topics: shared A2SV Best Coding Practices deck, October 2022.
The lesson examples are explained adaptations, not verbatim transcriptions of
image-based code in the PDF. Adaptations are checked independently. The adapted hourglass contract allows
negative integers; zero initialization would be invalid for that expanded contract.
See sources.json for per-unit provenance. Read the EN or TR notes alongside the code.

CURRENT-ASSIGNMENT-en.txt and CURRENT-ASSIGNMENT-tr.txt govern this course.
The numerical comment quotas in the archived homework/ASSIGNMENT.md do not apply.
The separate git-practice folder supplies cart.py and check_cart.py for unit17.
Follow that unit to initialize a new local repository and record a naming change;
this does not require or modify the site repository.

Standalone examples require Python 3; test_item_price.py also needs pytest.
Run ordinary examples with your environment's Python. Run the test example with:
  .venv/bin/python -m pytest -q ../examples/test_item_price.py

Git examples are instructions for your own practice repository, not automatic
setup steps. They do not push or deploy. Never commit secrets or a .venv folder.
