james/vmall
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(openspec): plan shop coupons, accounts, points, flash sales, and group buying

Browse Source 
Capture exclusive promotion composition, empty-group cancel, and mall surface scope so the five marketing changes can be implemented without stacking or lifecycle ambiguity.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Chengdong Zhang
2026-09-18 17:32:08 +08:00
co-authored by Cursor
parent e10cae5789
commit 53548196f8
38 changed files with 894 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files
openspec/changes/add-customer-accounts/specs/customer-accounts/spec.md
+26
View File
@@ -0,0 +1,26 @@
## ADDED Requirements
### Requirement: Customer account summary
Each customer SHALL have available monetary balance, frozen monetary balance, and loyalty-points accounts. An authenticated customer SHALL retrieve a summary containing balance minor, frozen balance minor, their monetary currency, and integer points. Public APIs SHALL NOT list or mutate account entries.
#### Scenario: new customer summary
- **WHEN** a newly registered customer requests account stats
- **THEN** the API returns zero balances and zero points without relying on browser fixtures
#### Scenario: frozen kind exists without a freeze flow
- **WHEN** a customer with no freeze events requests account stats
- **THEN** `frozen_minor` is zero and available balance is unchanged
### Requirement: Append-only account entries
Every account balance change SHALL create an immutable entry with signed delta, resulting balance, reason, optional business reference, and timestamp in the same transaction. Account entries SHALL NOT be edited or deleted through public APIs.
#### Scenario: debit records result
- **WHEN** an internal business flow debits points successfully
- **THEN** the points balance and one entry with the resulting balance commit together
### Requirement: Guarded account mutation
A debit or freeze SHALL succeed only when the affected account has sufficient available balance. Concurrent changes SHALL use conditional atomic updates and return 409 rather than create a negative balance.
#### Scenario: competing debits
- **WHEN** two debits together exceed a points balance
- **THEN** at most one debit succeeds and the final stored balance is non-negative