subscription-billing

Moduł rozliczania subskrypcji: plany taryfowe, miejsca, rabaty, okres próbny, faktury.

Repozytorium szkoleniowe kursu Claude Code for Seniors (Mate academy), temat M1T2 „Daily Workflow: From Research to Commit”. Zadanie jest w ticket.md: proration przy zmianie liczby miejsc lub planu taryfowego w trakcie cyklu rozliczeniowego.

Uruchomienie

npm install
npm test
npm run typecheck

Wymagany jest Node.js 22 lub nowszy. Przed rozpoczęciem pracy: 3 test suites, 12 tests passed.

Jak przechodzić zadanie razem z teorią

Każdy krok odpowiada rozdziałowi teorii. Przejdź cały cykl z agentem samodzielnie, a wynik porównaj z teorią.

1. Research (rozdział 1). Uruchom claude w katalogu głównym repozytorium i daj agentowi domenę, nie pliki: „Sprawdź, jak u nas działa już rozliczanie i logika zaokrąglania, zanim zaproponujesz zmiany. Zadanie: proration według zgłoszenia w ticket.md. Na razie niczego nie zmieniaj”. Sprawdź, czy agent znalazł istniejące zaokrąglanie, rabaty, okres próbny i typy.
2. Specyfikacja (rozdział 2). Utwórz spec.md: acceptance criteria w formacie Given-When-Then dla każdego warunku zgłoszenia oraz non-goals. Przykład specyfikacji jest w teorii.
3. Plan (rozdział 3). Włącz plan mode (Shift+Tab) i poproś o plan, w którym każde kryterium ma osobny punkt. Przed zatwierdzeniem porównaj plan ze specyfikacją punkt po punkcie.
4. Kod (rozdział 4). Po implementacji przyjrzyj się decyzjom, które agent podjął po cichu: skąd bierze się liczba miejsc w okresie próbnym i co jest zwracane, gdy różnica wynosi 0.
5. Testy (rozdziały 5-6). Zielone istniejące testy nie sprawdzają proration. Każde kryterium musi stać się testem. Zaokrąglanie sprawdzaj na wartości, dla której half up i zaokrąglanie bankierskie dają różne wyniki.
6. Commit (rozdział 7). Porównaj diff ze zgłoszeniem, specyfikacją i planem. Sprawdź, czy nie zmieniło się nic z non-goals. Potem zrób commit.

Struktura

ticket.md                  zgłoszenie, 7 warunków
billing/
  billingService.ts        punkt wejścia: faktura za odnowienie, żądanie zmiany planu
  proration.ts             szkielet pod zadanie
  currency.ts              zaokrąglanie i formatowanie kwot
  discounts.ts             stosowanie rabatów i kodów promocyjnych
  trial.ts                 14-dniowy okres próbny
  invoices.ts              faktura za odnowienie
  tenants.ts               ładowanie tenanta
  types.ts                 wspólne typy
  errors.ts                błędy domenowe rozliczeń
  *.test.ts                testy currency, discounts, trial