ideas-generator/QUICK_START_CHECKLIST.md

# Quick Start Checklist - Phase 1 Day 1

## ⚡ **Immediate Action Items**

### **🏗 Setup Environment (30 minutes)**
```bash
# 1. Navigate to project
cd /Users/daveporter/Desktop/CODING-2024/Ideas-Gen-2025

# 2. Create server directory
mkdir -p server/{config,models,routes,middleware,utils,migrations}
mkdir -p admin/src/{components,pages,services}
mkdir -p docs

# 3. Initialize Node.js project
cd server
npm init -y

# 4. Install core dependencies
npm install express cors dotenv sequelize pg redis openai
npm install joi express-rate-limit helmet morgan uuid node-cache
npm install --save-dev nodemon concurrently jest
```

### **📝 Create Essential Files (15 minutes)**

#### **server/package.json** (update scripts):
```json
{
  "scripts": {
    "dev": "nodemon index.js",
    "start": "node index.js",
    "db:migrate": "node migrations/migrate.js",
    "test": "jest"
  }
}
```

#### **server/.env** (create with your values):
```bash
# Database
DATABASE_URL=postgres://localhost:5432/ideas_gen_dev
DATABASE_HOST=localhost
DATABASE_NAME=ideas_gen_dev
DATABASE_USER=postgres
DATABASE_PASS=your_postgres_password

# Redis  
REDIS_URL=redis://localhost:6379

# OpenAI (REQUIRED - Get from OpenAI dashboard)
OPENAI_API_KEY=sk-your-actual-openai-key-here
OPENAI_ORG_ID=your-org-id-here

# Server
PORT=3000
NODE_ENV=development

# Development flags
SKIP_AUTH=true
ENABLE_CORS=true
LOG_LEVEL=debug
```

### **🗄️ Database Setup (20 minutes)**

#### **Install PostgreSQL:**
```bash
# macOS
brew install postgresql
brew services start postgresql
createdb ideas_gen_dev

# Ubuntu
sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql
sudo -u postgres createdb ideas_gen_dev

# Test connection
psql ideas_gen_dev
\q
```

#### **Create Migration File:**
Create `server/migrations/001_initial_schema.sql` with the complete schema from IMPLEMENTATION_GUIDE.md

### **🚀 Basic Server Setup (20 minutes)**

#### **server/index.js** (minimal starter):
```javascript
const express = require('express');
const cors = require('cors');
require('dotenv').config();

const app = express();
const PORT = process.env.PORT || 3000;

// Middleware
app.use(cors());
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// Basic health check
app.get('/health', (req, res) => {
  res.json({ 
    status: 'ok', 
    timestamp: new Date().toISOString(),
    environment: process.env.NODE_ENV 
  });
});

// API routes placeholder
app.use('/api', (req, res) => {
  res.json({ message: 'API routes will be implemented here' });
});

// Start server
app.listen(PORT, () => {
  console.log(`🚀 Ideas Gen 2025 Server running on port ${PORT}`);
  console.log(`🏥 Health check: http://localhost:${PORT}/health`);
  console.log(`📊 Environment: ${process.env.NODE_ENV}`);
});
```

### **✅ Verification Steps (10 minutes)**

1. **Start server:**
```bash
cd server
npm run dev
```

2. **Test endpoints:**
```bash
# Health check
curl http://localhost:3000/health

# Should return: {"status":"ok","timestamp":"...","environment":"development"}
```

3. **Test database connection:**
```bash
psql ideas_gen_dev -c "SELECT version();"
```

4. **Verify OpenAI API key:**
```bash
# Test with curl (replace YOUR_KEY)
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer YOUR_OPENAI_KEY" \
  | head -20
```

## 🎯 **Day 1 Success Criteria**

- [ ] Server starts without errors
- [ ] Health endpoint responds
- [ ] PostgreSQL database created and accessible  
- [ ] OpenAI API key validated
- [ ] Project structure created
- [ ] Dependencies installed
- [ ] Environment variables configured

## 🚨 **Common Issues & Solutions**

### **PostgreSQL Connection Issues:**
```bash
# Check if PostgreSQL is running
brew services list | grep postgres  # macOS
sudo systemctl status postgresql    # Ubuntu

# Reset PostgreSQL if needed
brew services restart postgresql
```

### **Permission Issues:**
```bash
# Create PostgreSQL user if needed
sudo -u postgres createuser --interactive your_username
sudo -u postgres createdb -O your_username ideas_gen_dev
```

### **Node.js Version:**
```bash
# Ensure Node.js 18+
node --version
# If too old: brew install node (macOS) or update via nvm
```

## 📋 **Next Context Window Prompt**

When ready for Day 2, use this prompt:

---

**"Continue Ideas Generator 2025 implementation - Day 2: Database Setup.**

**Current Status**: Day 1 complete - basic server running, PostgreSQL installed, environment configured.

**Today's Goal**: Implement complete database schema with Sequelize models, create migration system, establish database connection.

**Key Context**:
- 48 AI assistants (SMART Goals + 47 Creator Bots)
- PostgreSQL for relational data with JSONB for flexibility
- OpenAI Responses API integration
- Dynamic assistant configuration system

**Files to create today**:
- `server/config/database.js` - Sequelize configuration
- `server/models/` - All model definitions
- `server/migrations/migrate.js` - Migration runner
- Complete database schema implementation

**Reference**: IMPLEMENTATION_GUIDE.md (Day 2 section), schema in section 2.2

**Repository**: bitbucket.org/zlalani/ideas-generator (branch: ideas-gen-2025)"

---

This checklist gets you from zero to running server in ~95 minutes. Each step is verified before proceeding to ensure solid foundation for Day 2.