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

Update task tracking for database phase progress

Browse Source 
- Mark database setup tasks as completed
- Update progress percentages and status
- Document database implementation notes
This commit is contained in:
Bastian Masanek
2025-10-30 14:29:05 +01:00
parent 38056e04d8
commit 934635ac77
2 changed files with 91 additions and 87 deletions
Download Patch File Download Diff File Expand all files Collapse all files

130
tasks/00-PROGRESS.md
View File

@@ -2,18 +2,18 @@
## my.experimenta.science
**Last Updated:** 2025-10-29
**Overall Progress:** 9/137 tasks (6.6%)
**Current Phase:** ✅ Phase 1 - Foundation (Completed)
**Last Updated:** 2025-10-30
**Overall Progress:** 21/137 tasks (15.3%)
**Current Phase:** ✅ Phase 2 - Database (Completed)
---
## 🎯 Quick Status
| Phase | Status | Progress | Started | Completed |
| --------------------------- | ------- | ---------- | ---------- | ---------- |
| --------------------------- | ------- | ------------ | ---------- | ---------- |
| **01** Foundation | ✅ Done | 9/10 (90%) | 2025-10-29 | 2025-10-29 |
| **02** Database | ⏳ Todo | 0/12 (0%) | - | - |
| **02** Database | ✅ Done | 12/12 (100%) | 2025-10-30 | 2025-10-30 |
| **03** Authentication | ⏳ Todo | 0/18 (0%) | - | - |
| **04** Products | ⏳ Todo | 0/10 (0%) | - | - |
| **05** Cart | ⏳ Todo | 0/12 (0%) | - | - |
@@ -30,38 +30,35 @@
## 🚀 Current Work
**Phase:** Phase 1 - Foundation ✅ **COMPLETED**
**Phase:** Phase 2 - Database ✅ **COMPLETED**
**Tasks Completed (9/10):**
**Tasks Completed (12/12):**
- ✅ Initialize Nuxt 4 project with pnpm (v4.2.0)
- ✅ Copy .env.example to .env and configure
- ✅ Install shadcn-nuxt module (v2.3.2)
- ✅ Configure Tailwind CSS v4 with experimenta brand colors
- ✅ Setup TypeScript strict mode
- ✅ Configure ESLint (@nuxt/eslint v1.10.0)
- ✅ Configure Prettier (v3.6.2)
- ✅ Create basic folder structure
- ✅ Configure nuxt.config.ts
- ✅ Create basic layout components (app.vue, layouts, Header, Footer)
- ✅ Test development server
- ⏭️ Setup Git hooks with husky (Skipped - deferred to Phase 11)
**Pending:**
- ⚠️ Start Docker services (PostgreSQL + Redis) - **Manual action required**
- ✅ Install Drizzle ORM & PostgreSQL driver
- ✅ Configure drizzle.config.ts
- ✅ Add database scripts to package.json
- ✅ Create users table schema
- ✅ Create products table schema
- ✅ Create carts table schema
- ✅ Create cart_items table schema
- ✅ Create orders table schema
- ✅ Create order_items table schema
- ✅ Generate initial migration
- ✅ Apply migrations to dev database
- ✅ Create database connection utility (server/utils/db.ts)
- ✅ Test CRUD operations
- ✅ Setup Drizzle Studio
- ✅ Document schema decisions (comprehensive comments added)
**Next Steps:**
1. **Manual Action Required:** Start Docker Desktop and run:
```bash
docker-compose -f docker-compose.dev.yml up -d
```
2. **Begin Phase 2 - Database Setup:**
- Read `tasks/02-database.md`
- Install Drizzle ORM and PostgreSQL driver
- Create database schemas
- Generate and apply migrations
1. **Begin Phase 3 - Authentication (Cidaas OAuth2):**
- Read `tasks/03-authentication.md`
- Review `docs/CIDAAS_INTEGRATION.md` for complete OAuth2 implementation guide
- Install nuxt-auth-utils and jose
- Implement OAuth2 Authorization Code Flow with PKCE
- Create login/register/logout endpoints
- Build auth UI components
---
@@ -70,7 +67,7 @@
### Week 1 (Target)
- [x] Phase 1: Foundation ✅ **COMPLETED 2025-10-29**
- [ ] Phase 2: Database
- [x] Phase 2: Database ✅ **COMPLETED 2025-10-30**
- [ ] Phase 3: Authentication
### Week 2 (Target)
@@ -95,10 +92,7 @@
## 🚧 Blockers
**Phase 2 (Database):** Docker services (PostgreSQL + Redis) need to be started before database setup can begin.
- **Action Required:** User needs to start Docker Desktop and run `docker-compose -f docker-compose.dev.yml up -d`
- **Impact:** Blocks Phase 2 start
**None currently.** All blockers resolved.
---
@@ -120,6 +114,15 @@
- ESLint and Prettier configured
- Basic project structure created
- Development server tested successfully
- [x] **Phase 2 - Database (2025-10-30)**
- Drizzle ORM installed and configured
- All 6 database tables defined (users, products, carts, cart_items, orders, order_items)
- Relations configured correctly
- Initial migration generated and applied successfully
- Database connection utility created
- CRUD operations tested and verified
- Drizzle Studio setup and working
- Comprehensive schema documentation added
---
@@ -150,22 +153,24 @@ Tasks:
### Phase 2: Database (Drizzle ORM)
**Status:** ⏳ Todo | **Progress:** 0/12 (0%)
**Status:** ✅ Done | **Progress:** 12/12 (100%)
Tasks:
- [ ] Install Drizzle ORM & PostgreSQL driver
- [ ] Configure drizzle.config.ts
- [ ] Create users table schema
- [ ] Create products table schema
- [ ] Create carts & cart_items schema
- [ ] Create orders & order_items schema
- [ ] Generate initial migration
- [ ] Apply migrations to dev DB
- [ ] Create database connection utility
- [ ] Test CRUD operations
- [ ] Setup Drizzle Studio
- [ ] Document schema decisions
- [x] Install Drizzle ORM & PostgreSQL driver
- [x] Configure drizzle.config.ts
- [x] Create users table schema
- [x] Create products table schema
- [x] Create carts & cart_items schema
- [x] Create orders & order_items schema
- [x] Generate initial migration
- [x] Apply migrations to dev DB
- [x] Create database connection utility
- [x] Test CRUD operations
- [x] Setup Drizzle Studio
- [x] Document schema decisions
**Completed:** 2025-10-30
[Details: tasks/02-database.md](./02-database.md)
@@ -388,26 +393,25 @@ Tasks:
## 📈 Progress Over Time
| Date | Overall Progress | Phase | Notes |
| ---------- | ---------------- | ------------- | ------------------------------------------------------------------------------------------- |
| ---------- | ---------------- | -------------- | ---------------------------------------------------------------------------------------------------------------- |
| 2025-01-29 | 0% | Planning | Task system created |
| 2025-10-29 | 6.6% | Phase 1 - MVP | ✅ Foundation completed: Nuxt 4, shadcn-nuxt, Tailwind CSS, ESLint, Prettier all configured |
| 2025-10-30 | 15.3% | Phase 2 - MVP | ✅ Database completed: Drizzle ORM, all tables defined, migrations applied, Studio working, schema documented |
---
## 🎉 Next Steps
1. ⚠️ **Manual Action Required:** Start Docker services
```bash
# Start Docker Desktop, then run:
docker-compose -f docker-compose.dev.yml up -d
```
2. **Start Phase 2: Database Setup**
- Read `tasks/02-database.md` for detailed tasks
- Install Drizzle ORM and PostgreSQL driver
- Create database schemas
- Generate and apply migrations
1. **Start Phase 3: Authentication (Cidaas OAuth2)**
- Read `tasks/03-authentication.md` for detailed tasks
- Review `docs/CIDAAS_INTEGRATION.md` for complete OAuth2 implementation guide
- Install nuxt-auth-utils and jose packages
- Implement PKCE generator utility
- Create Cidaas API client
- Build OAuth2 login/callback/register/logout endpoints
- Create auth UI components (LoginForm, RegisterForm)
- Implement auth middleware for protected routes
- Test complete OAuth2 flow end-to-end
---

38
tasks/02-database.md
View File

@@ -1,9 +1,9 @@
# Phase 2: Database (Drizzle ORM)
**Status:** ⏳ Todo
**Progress:** 0/12 tasks (0%)
**Started:** -
**Completed:** -
**Status:** ✅ Done
**Progress:** 12/12 tasks (100%)
**Started:** 2025-10-30
**Completed:** 2025-10-30
**Assigned to:** -
---
@@ -27,14 +27,14 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Drizzle Setup
- [ ] Install Drizzle ORM & PostgreSQL driver
- [x] Install Drizzle ORM & PostgreSQL driver
```bash
pnpm add drizzle-orm postgres
pnpm add -D drizzle-kit
```
- [ ] Configure drizzle.config.ts
- [x] Configure drizzle.config.ts
```typescript
import { defineConfig } from 'drizzle-kit'
@@ -49,7 +49,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
})
```
- [ ] Add database scripts to package.json
- [x] Add database scripts to package.json
```json
{
"scripts": {
@@ -63,35 +63,35 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Schema Definition
- [ ] Create users table schema
- [x] Create users table schema
- File: `server/database/schema.ts`
- Fields: id (UUID), experimenta_id (unique), email, first_name, last_name, salutation, date_of_birth, street, post_code, city, country_code, phone, created_at, updated_at
- See: [ARCHITECTURE.md Section 4.1](../docs/ARCHITECTURE.md#41-datenbank-schema)
- [ ] Create products table schema
- [x] Create products table schema
- Fields: id (UUID), nav_product_id (unique), name, description, price (decimal), stock_quantity, category, active, created_at, updated_at
- Indexes: nav_product_id, active, category
- [ ] Create carts table schema
- [x] Create carts table schema
- Fields: id (UUID), user_id (FK to users, nullable), session_id, created_at, updated_at
- Relations: hasMany cart_items
- [ ] Create cart_items table schema
- [x] Create cart_items table schema
- Fields: id (UUID), cart_id (FK to carts), product_id (FK to products), quantity, added_at
- Relations: belongsTo cart, belongsTo product
- [ ] Create orders table schema
- [x] Create orders table schema
- Fields: id (UUID), order_number (unique), user_id (FK to users), total_amount, status, billing_address (JSON), payment_id, payment_completed_at, created_at, updated_at
- Relations: hasMany order_items
- Indexes: order_number, user_id, status
- [ ] Create order_items table schema
- [x] Create order_items table schema
- Fields: id (UUID), order_id (FK to orders), product_id (FK to products), product_snapshot (JSON), quantity, price_snapshot, created_at
- Relations: belongsTo order, belongsTo product
### Migrations
- [ ] Generate initial migration
- [x] Generate initial migration
```bash
pnpm db:generate
@@ -99,7 +99,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
- Verify migration files in `server/database/migrations/`
- [ ] Apply migrations to dev database
- [x] Apply migrations to dev database
```bash
pnpm db:migrate
@@ -113,7 +113,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Database Utilities
- [ ] Create database connection utility
- [x] Create database connection utility
- File: `server/utils/db.ts`
```typescript
@@ -126,7 +126,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
export const db = drizzle(client, { schema })
```
- [ ] Test CRUD operations
- [x] Test CRUD operations
- Create test endpoint: `server/api/test/db.get.ts`
- Test insert, select, update, delete on users table
- Verify relations work (e.g., fetch cart with items)
@@ -134,7 +134,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Tools
- [ ] Setup Drizzle Studio
- [x] Setup Drizzle Studio
```bash
pnpm db:studio
@@ -144,7 +144,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
- Verify all tables are visible
- Test data manipulation via Studio
- [ ] Document schema decisions
- [x] Document schema decisions
- Add comments to schema.ts explaining design choices
- Document why JSONB for billing_address
- Document why UUID vs serial IDs