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

38
tasks/02-database.md
View File

@@ -1,9 +1,9 @@
# Phase 2: Database (Drizzle ORM) # Phase 2: Database (Drizzle ORM)
**Status:** ⏳ Todo **Status:** ✅ Done
**Progress:** 0/12 tasks (0%) **Progress:** 12/12 tasks (100%)
**Started:** - **Started:** 2025-10-30
**Completed:** - **Completed:** 2025-10-30
**Assigned to:** - **Assigned to:** -
--- ---
@@ -27,14 +27,14 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Drizzle Setup ### Drizzle Setup
- [ ] Install Drizzle ORM & PostgreSQL driver - [x] Install Drizzle ORM & PostgreSQL driver
```bash ```bash
pnpm add drizzle-orm postgres pnpm add drizzle-orm postgres
pnpm add -D drizzle-kit pnpm add -D drizzle-kit
``` ```
- [ ] Configure drizzle.config.ts - [x] Configure drizzle.config.ts
```typescript ```typescript
import { defineConfig } from 'drizzle-kit' 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 ```json
{ {
"scripts": { "scripts": {
@@ -63,35 +63,35 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Schema Definition ### Schema Definition
- [ ] Create users table schema - [x] Create users table schema
- File: `server/database/schema.ts` - 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 - 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) - 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 - 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 - 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 - Fields: id (UUID), user_id (FK to users, nullable), session_id, created_at, updated_at
- Relations: hasMany cart_items - 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 - Fields: id (UUID), cart_id (FK to carts), product_id (FK to products), quantity, added_at
- Relations: belongsTo cart, belongsTo product - 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 - 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 - Relations: hasMany order_items
- Indexes: order_number, user_id, status - 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 - 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 - Relations: belongsTo order, belongsTo product
### Migrations ### Migrations
- [ ] Generate initial migration - [x] Generate initial migration
```bash ```bash
pnpm db:generate 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/` - Verify migration files in `server/database/migrations/`
- [ ] Apply migrations to dev database - [x] Apply migrations to dev database
```bash ```bash
pnpm db:migrate pnpm db:migrate
@@ -113,7 +113,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
### Database Utilities ### Database Utilities
- [ ] Create database connection utility - [x] Create database connection utility
- File: `server/utils/db.ts` - File: `server/utils/db.ts`
```typescript ```typescript
@@ -126,7 +126,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
export const db = drizzle(client, { schema }) export const db = drizzle(client, { schema })
``` ```
- [ ] Test CRUD operations - [x] Test CRUD operations
- Create test endpoint: `server/api/test/db.get.ts` - Create test endpoint: `server/api/test/db.get.ts`
- Test insert, select, update, delete on users table - Test insert, select, update, delete on users table
- Verify relations work (e.g., fetch cart with items) - 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 ### Tools
- [ ] Setup Drizzle Studio - [x] Setup Drizzle Studio
```bash ```bash
pnpm db:studio pnpm db:studio
@@ -144,7 +144,7 @@ Setup Drizzle ORM, define complete database schema for all tables (users, produc
- Verify all tables are visible - Verify all tables are visible
- Test data manipulation via Studio - Test data manipulation via Studio
- [ ] Document schema decisions - [x] Document schema decisions
- Add comments to schema.ts explaining design choices - Add comments to schema.ts explaining design choices
- Document why JSONB for billing_address - Document why JSONB for billing_address
- Document why UUID vs serial IDs - Document why UUID vs serial IDs