ideas-generator/docs-archive/QUICK_START_CHECKLIST.md

Quick Start Checklist - Phase 1 Day 1

⚡ Immediate Action Items

🏗 Setup Environment (30 minutes)

# 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):

{
  "scripts": {
    "dev": "nodemon index.js",
    "start": "node index.js",
    "db:migrate": "node migrations/migrate.js",
    "test": "jest"
  }
}

server/.env (create with your values):

# 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:

# 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):

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:

cd server
npm run dev

2. Test endpoints:

# Health check
curl http://localhost:3000/health

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

3. Test database connection:

psql ideas_gen_dev -c "SELECT version();"

4. Verify OpenAI API key:

# 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:

# 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:

# 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:

# 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.