bam/my2
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update CLAUDE.md to clarify role definitions and database schema

Browse Source 
- Added details about the primary key for the `roles` table, emphasizing its enum nature and direct readability in junction tables.
- Included information on foreign key relationships for `user_roles` and `product_role_visibility` referencing `roles.code`.
- Documented the auto-assignment of the 'private' role for new users upon first login and clarified the use of UUID primary keys in most tables.
This commit is contained in:
Bastian Masanek
2025-11-03 10:44:52 +01:00
parent ba0267ef88
commit a6d09d76fd
1 changed files with 6 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
CLAUDE.md
View File

@@ -180,15 +180,20 @@ See `docs/ARCHITECTURE.md` for full schema. Key tables:
- `carts` / `cart_items` - Shopping cart - `carts` / `cart_items` - Shopping cart
- `orders` / `order_items` - Orders and line items - `orders` / `order_items` - Orders and line items
- **`roles`** - Role definitions (private, educator, company) - **`roles`** - Role definitions (private, educator, company)
- **Primary Key:** `code` (enum: 'private' | 'educator' | 'company') - No separate UUID id!
- Benefit: Direct readability in junction tables
- **`user_roles`** - Many-to-Many User ↔ Roles (with approval workflow prepared for Phase 2/3) - **`user_roles`** - Many-to-Many User ↔ Roles (with approval workflow prepared for Phase 2/3)
- Foreign Key: `roleCode` references `roles.code`
- **`product_role_visibility`** - Many-to-Many Product ↔ Roles (controls product visibility) - **`product_role_visibility`** - Many-to-Many Product ↔ Roles (controls product visibility)
- Foreign Key: `roleCode` references `roles.code`
**Role-based Visibility (MVP):** **Role-based Visibility (MVP):**
- Products are ONLY visible if they have `product_role_visibility` entries - Products are ONLY visible if they have `product_role_visibility` entries
- Users ONLY see products matching their approved roles in `user_roles` - Users ONLY see products matching their approved roles in `user_roles`
- Opt-in visibility: No role assignment = invisible to everyone - Opt-in visibility: No role assignment = invisible to everyone
- **Auto-assignment:** New users automatically receive `'private'` role on first login
Use Drizzle ORM for all database operations. All tables use UUID primary keys. Use Drizzle ORM for all database operations. Most tables use UUID primary keys (except `roles` which uses enum code as PK).
## Development Commands (Once Set Up) ## Development Commands (Once Set Up)