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

Update task tracking for database phase progress 

- Mark database setup tasks as completed
- Update progress percentages and status
- Document database implementation notes
main
Bastian Masanek 2 months ago
parent
38056e04d8
commit
934635ac77
2 changed files with 93 additions and 89 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 134
      tasks/00-PROGRESS.md
  2. 38
      tasks/02-database.md

134
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

Write Preview
Loading…
Cancel
Save