student-help 2.0.0

package/commands/db.ts

@@ -0,0 +1,59 @@
+import chalk from 'chalk';
+
+export async function dbInstall(feature: string) {
+  console.log(chalk.blue(`\n📦 Installing ${feature} database via Docker...\n`));
+
+  switch (feature.toLowerCase()) {
+    case 'postgres':
+    case 'postgresql':
+      console.log(chalk.green('✅ PostgreSQL is already included in docker-compose.yml'));
+      console.log(chalk.cyan('Access: localhost:5432'));
+      console.log(chalk.cyan('User: student'));
+      console.log(chalk.cyan('Password: student123\n'));
+      break;
+
+    case 'mongodb':
+    case 'mongo':
+      console.log(chalk.yellow('⚠️  To add MongoDB, edit docker-compose.yml\n'));
+      console.log(chalk.gray(`
+services:
+  mongodb:
+    image: mongo:latest
+    container_name: project_mongodb
+    ports:
+      - "27017:27017"
+    environment:
+      MONGO_INITDB_ROOT_USERNAME: admin
+      MONGO_INITDB_ROOT_PASSWORD: password
+    volumes:
+      - mongodb_data:/data/db
+      
+volumes:
+  mongodb_data:
+      `));
+      break;
+
+    case 'redis':
+      console.log(chalk.yellow('⚠️  To add Redis, edit docker-compose.yml\n'));
+      console.log(chalk.gray(`
+services:
+  redis:
+    image: redis:alpine
+    container_name: project_redis
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+      
+volumes:
+  redis_data:
+      `));
+      break;
+
+    default:
+      console.log(chalk.red(`❌ Database '${feature}' not recognized`));
+      console.log(chalk.cyan('Available options: postgres, mongodb, redis\n'));
+  }
+
+  console.log(chalk.yellow('Then, run: docker-compose up -d\n'));
+}

package/commands/dev.ts

@@ -0,0 +1,23 @@
+import { execSync } from 'child_process';
+import path from 'path';
+import chalk from 'chalk';
+
+export async function devCommand() {
+  try {
+    console.log(chalk.blue.bold('\n🐳 Starting Docker containers...\n'));
+    execSync('docker-compose up -d', { stdio: 'inherit' });
+
+    console.log(chalk.blue.bold('\n⏳ Waiting for containers to initialize...\n'));
+    await new Promise(resolve => setTimeout(resolve, 3000));
+
+    console.log(chalk.green.bold('\n✅ Development environment started!\n'));
+    console.log(chalk.cyan('Backend:  http://localhost:3000'));
+    console.log(chalk.cyan('Frontend: http://localhost:3001'));
+    console.log(chalk.cyan('Database: localhost:5432\n'));
+    
+    console.log(chalk.yellow('To stop the environment, run: docker-compose down\n'));
+  } catch (error) {
+    console.error(chalk.red('Error starting environment:'), error instanceof Error ? error.message : String(error));
+    throw error;
+  }
+}

package/commands/generate/auth.ts

@@ -0,0 +1,31 @@
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+
+export async function generateAuth() {
+  console.log(chalk.blue.bold('\n🔐 Creating Auth module...\n'));
+  
+  try {
+    console.log(chalk.cyan('Backend:'));
+    console.log('  - Creating module...');
+    execSync('cd backend && nest g module auth', { stdio: 'inherit' });
+    
+    console.log('  - Creating controller...');
+    execSync('cd backend && nest g controller auth', { stdio: 'inherit' });
+    
+    console.log('  - Creating service...');
+    execSync('cd backend && nest g service auth', { stdio: 'inherit' });
+
+    console.log(chalk.cyan('\nInstalling authentication dependencies...'));
+    execSync('cd backend && npm install @nestjs/jwt @nestjs/passport passport passport-jwt @types/passport-jwt bcrypt --save', { stdio: 'inherit' });
+    execSync('cd backend && npm install -D @types/bcrypt', { stdio: 'inherit' });
+
+    console.log(chalk.green('\n✅ Auth module created successfully!\n'));
+    console.log(chalk.yellow('Next steps:'));
+    console.log('  1. Configure JWT variables in .env');
+    console.log('  2. Implement authentication logic in AuthService');
+    console.log('  3. Configure passport strategies in auth.strategy.ts\n');
+  } catch (error) {
+    console.error(chalk.red('Error generating auth:'), error instanceof Error ? error.message : String(error));
+    throw error;
+  }
+}

package/commands/generate/install.ts

@@ -0,0 +1,34 @@
+import { execSync } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+
+export async function installDependencies() {
+  const currentDir = process.cwd();
+
+  console.log("📦 Installing backend dependencies...");
+  try {
+    execSync('cd backend && npm install', { stdio: 'inherit' });
+  } catch (error) {
+    console.error('Error installing backend dependencies:', error instanceof Error ? error.message : String(error));
+  }
+
+  console.log("📦 Installing frontend dependencies...");
+  try {
+    execSync('cd frontend && npm install', { stdio: 'inherit' });
+  } catch (error) {
+    console.error('Error installing frontend dependencies:', error instanceof Error ? error.message : String(error));
+  }
+
+  console.log("✅ Dependencies installed successfully!");
+}
+
+export async function setupEnvironment() {
+  const envPath = '.env';
+  const envExamplePath = '.env.example';
+
+  if (!fs.existsSync(envPath) && fs.existsSync(envExamplePath)) {
+    console.log("📝 Creating .env file...");
+    fs.copyFileSync(envExamplePath, envPath);
+    console.log("✅ .env file created from .env.example");
+  }
+}

package/commands/generate/resource.ts

@@ -0,0 +1,184 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+
+export async function generateResource(resourceName: string) {
+  const resourceLower = resourceName.toLowerCase();
+  const resourcePascal = resourceName.charAt(0).toUpperCase() + resourceName.slice(1);
+
+  console.log(chalk.blue.bold(`\n📦 Generating resource: ${resourcePascal}\n`));
+
+  try {
+    // Backend
+    console.log(chalk.cyan('Backend:'));
+    const backendPath = path.join(process.cwd(), 'backend/src', resourceLower);
+    fs.ensureDirSync(backendPath);
+
+    // Helper function to replace template variables
+    const replaceContent = (content: string, name: string) => {
+      return content
+        .replace(/Resource/g, name)
+        .replace(/resource/g, name.toLowerCase());
+    };
+
+    // Copy and customize files
+    const primaryPath = path.resolve('.', 'node_modules/student-help/templates/backend/module.ts');
+    const fallbackPath = path.resolve(import.meta.url, '../../../templates/backend/module.ts');
+    
+    let moduleTemplate: string;
+    try {
+      moduleTemplate = fs.readFileSync(primaryPath, 'utf-8');
+    } catch {
+      moduleTemplate = fs.readFileSync(fallbackPath, 'utf-8');
+    }
+
+    const backendDir = path.resolve('.', 'node_modules/student-help/templates/backend');
+    const templatesDir = path.resolve(import.meta.url, '../../../templates/backend');
+    
+    // Try to find templates
+    let templateDir = null;
+    if (fs.existsSync(backendDir)) {
+      templateDir = backendDir;
+    } else if (fs.existsSync(templatesDir)) {
+      templateDir = templatesDir;
+    } else {
+      // Create from scratch if templates not found
+      console.log(chalk.yellow('⚠️  Templates not found, creating basic structure...\n'));
+      
+      // Module
+      fs.writeFileSync(
+        path.join(backendPath, `${resourceLower}.module.ts`),
+        `import { Module } from '@nestjs/common';
+import { ${resourcePascal}Service } from './${resourceLower}.service';
+import { ${resourcePascal}Controller } from './${resourceLower}.controller';
+
+@Module({
+  controllers: [${resourcePascal}Controller],
+  providers: [${resourcePascal}Service],
+})
+export class ${resourcePascal}Module {}
+`);
+
+      // Service
+      fs.writeFileSync(
+        path.join(backendPath, `${resourceLower}.service.ts`),
+        `import { Injectable } from '@nestjs/common';
+import { Create${resourcePascal}Dto, Update${resourcePascal}Dto } from './${resourceLower}.dto';
+
+@Injectable()
+export class ${resourcePascal}Service {
+  create(create${resourcePascal}Dto: Create${resourcePascal}Dto) {
+    return { message: 'Create endpoint for ${resourcePascal}' };
+  }
+
+  findAll() {
+    return { message: 'Find all ${resourcePascal}' };
+  }
+
+  findOne(id: number) {
+    return { message: \`Find ${resourcePascal} with id \${id}\` };
+  }
+
+  update(id: number, update${resourcePascal}Dto: Update${resourcePascal}Dto) {
+    return { message: \`Update ${resourcePascal} with id \${id}\` };
+  }
+
+  remove(id: number) {
+    return { message: \`Remove ${resourcePascal} with id \${id}\` };
+  }
+}
+`);
+
+      // Controller
+      fs.writeFileSync(
+        path.join(backendPath, `${resourceLower}.controller.ts`),
+        `import { Controller, Get, Post, Body, Patch, Param, Delete } from '@nestjs/common';
+import { ${resourcePascal}Service } from './${resourceLower}.service';
+import { Create${resourcePascal}Dto, Update${resourcePascal}Dto } from './${resourceLower}.dto';
+
+@Controller('${resourceLower}')
+export class ${resourcePascal}Controller {
+  constructor(private readonly ${resourceLower}Service: ${resourcePascal}Service) {}
+
+  @Post()
+  create(@Body() create${resourcePascal}Dto: Create${resourcePascal}Dto) {
+    return this.${resourceLower}Service.create(create${resourcePascal}Dto);
+  }
+
+  @Get()
+  findAll() {
+    return this.${resourceLower}Service.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id') id: string) {
+    return this.${resourceLower}Service.findOne(+id);
+  }
+
+  @Patch(':id')
+  update(@Param('id') id: string, @Body() update${resourcePascal}Dto: Update${resourcePascal}Dto) {
+    return this.${resourceLower}Service.update(+id, update${resourcePascal}Dto);
+  }
+
+  @Delete(':id')
+  remove(@Param('id') id: string) {
+    return this.${resourceLower}Service.remove(+id);
+  }
+}
+`);
+
+      // DTO
+      fs.writeFileSync(
+        path.join(backendPath, `${resourceLower}.dto.ts`),
+        `export class Create${resourcePascal}Dto {
+  title: string;
+  description?: string;
+}
+
+export class Update${resourcePascal}Dto {
+  title?: string;
+  description?: string;
+}
+`);
+      
+      console.log('  ✅ Module created');
+      console.log('  ✅ Service created');
+      console.log('  ✅ Controller created');
+      console.log('  ✅ DTO created');
+    }
+
+    // Frontend
+    console.log(chalk.cyan('\nFrontend:'));
+    const frontendPath = path.join(process.cwd(), 'app', resourceLower);
+    fs.ensureDirSync(frontendPath);
+
+    // Create a basic page component
+    fs.writeFileSync(
+      path.join(frontendPath, 'page.tsx'),
+      `'use client';
+
+import React from 'react';
+
+export default function ${resourcePascal}Page() {
+  return (
+    <div className="container mx-auto py-8">
+      <h1 className="text-3xl font-bold mb-4">${resourcePascal} Management</h1>
+      <p className="text-gray-600">This is the ${resourcePascal} CRUD page. Start implementing here!</p>
+    </div>
+  );
+}
+`);
+
+    console.log(`  ✅ Page created in app/${resourceLower}`);
+
+    console.log(chalk.green.bold(`\n✅ Resource ${resourcePascal} generated successfully!\n`));
+    console.log(chalk.yellow('Next steps:'));
+    console.log(`  1. Register the module in backend/src/app.module.ts`);
+    console.log(`  2. Implement service logic`);
+    console.log(`  3. Create frontend interface in Next.js\n`);
+
+  } catch (error) {
+    console.error(chalk.red('Error generating resource:'), error instanceof Error ? error.message : String(error));
+    throw error;
+  }
+}

package/commands/new.ts

@@ -0,0 +1,179 @@
+import fs from 'fs-extra';
+import { execSync } from 'child_process';
+import path from 'path';
+
+export async function newCommand(projectName: string) {
+  const projectPath = path.join(process.cwd(), projectName);
+  fs.ensureDirSync(projectPath);
+
+  console.log("📦 Setting up NestJS backend...");
+  try {
+    execSync(`npx @nestjs/cli new backend --directory ${projectPath}/backend --package-manager npm`, { stdio: 'inherit' });
+  } catch (error) {
+    console.error('Error creating backend:', error instanceof Error ? error.message : String(error));
+    throw error;
+  }
+
+  console.log("📦 Setting up Next.js frontend...");
+  try {
+    execSync(`npx create-next-app@latest ${projectPath}/frontend --typescript --use-npm --eslint --app --no-src-dir --import-alias '@/*'`, { stdio: 'inherit' });
+  } catch (error) {
+    console.error('Error creating frontend:', error instanceof Error ? error.message : String(error));
+    throw error;
+  }
+
+  console.log("📝 Creating Dockerfiles...");
+  fs.writeFileSync(path.join(projectPath, 'backend/Dockerfile'), `FROM node:18
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npm run build
+CMD ["npm", "run", "start:prod"]
+`);
+
+  fs.writeFileSync(path.join(projectPath, 'frontend/Dockerfile'), `FROM node:18
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npm run build
+CMD ["npm", "run", "start"]
+`);
+
+  console.log("📝 Creating docker-compose.yml...");
+  fs.writeFileSync(path.join(projectPath, 'docker-compose.yml'), `version: '3.8'
+services:
+  backend:
+    build: ./backend
+    container_name: ${projectName}_backend
+    ports:
+      - "3000:3000"
+    environment:
+      NODE_ENV: development
+      DB_HOST: db
+      DB_PORT: 5432
+      DB_USER: student
+      DB_PASSWORD: student123
+      DB_NAME: ${projectName}
+    volumes:
+      - ./backend:/app
+      - /app/node_modules
+    depends_on:
+      - db
+    networks:
+      - app-network
+
+  frontend:
+    build: ./frontend
+    container_name: ${projectName}_frontend
+    ports:
+      - "3001:3000"
+    environment:
+      NODE_ENV: development
+      NEXT_PUBLIC_API_URL: http://localhost:3000/api
+    volumes:
+      - ./frontend:/app
+      - /app/node_modules
+    depends_on:
+      - backend
+    networks:
+      - app-network
+
+  db:
+    image: postgres:15-alpine
+    container_name: ${projectName}_postgres
+    environment:
+      POSTGRES_USER: student
+      POSTGRES_PASSWORD: student123
+      POSTGRES_DB: ${projectName}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    networks:
+      - app-network
+
+volumes:
+  postgres_data:
+
+networks:
+  app-network:
+    driver: bridge
+`);
+
+  console.log("📝 Creating .env.example...");
+  fs.writeFileSync(path.join(projectPath, '.env.example'), `# Backend
+BACKEND_PORT=3000
+NODE_ENV=development
+
+# Frontend
+FRONTEND_PORT=3001
+NEXT_PUBLIC_API_URL=http://localhost:3000/api
+
+# Database
+DB_HOST=db
+DB_PORT=5432
+DB_USER=student
+DB_PASSWORD=student123
+DB_NAME=${projectName}
+
+# JWT
+JWT_SECRET=your_secret_key_change_this
+JWT_EXPIRATION=7d
+`);
+
+  console.log("📝 Creating .gitignore...");
+  fs.writeFileSync(path.join(projectPath, '.gitignore'), `# Dependencies
+node_modules/
+/.pnp
+.pnp.js
+
+# Testing
+/coverage
+
+# Production
+/build
+/dist
+/out
+
+# Misc
+.DS_Store
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# Docker
+docker-compose.override.yml
+`);
+
+  console.log("🔧 Initializing git...");
+  try {
+    execSync(`cd ${projectPath} && git init && git add . && git commit -m "Initial project setup"`, { stdio: 'inherit' });
+  } catch (error) {
+    console.warn('Warning: Git not configured properly');
+  }
+
+  console.log("\n✅ Project created successfully!");
+  console.log(`\n📂 Next steps:`);
+  console.log(`   cd ${projectName}`);
+  console.log(`   docker-compose up -d`);
+  console.log(`\n🚀 Project will be available at:`);
+  console.log(`   Backend:  http://localhost:3000`);
+  console.log(`   Frontend: http://localhost:3001`);
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "student-help",
+  "version": "2.0.0",
+  "description": "🎓 Student Help Framework - Create full-stack projects in minutes with integrated StudentHelp utilities module",
+  "main": "cli.mjs",
+  "type": "module",
+  "preferGlobal": true,
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "start": "node bin/student-help.js",
+    "dev": "node --loader ts-node/esm bin/student-help.js",
+    "prepare": "npm run build 2>/dev/null || true"
+  },
+  "bin": {
+    "student-help": "./bin/student-help.js"
+  },
+  "files": [
+    "bin",
+    "cli.mjs",
+    "commands",
+    "templates",
+    "utils",
+    "package.json",
+    "README.md"
+  ],
+  "keywords": [
+    "framework",
+    "nestjs",
+    "nextjs",
+    "cli",
+    "students",
+    "fullstack",
+    "generator",
+    "scaffold"
+  ],
+  "author": "Student Help Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guimelloo/StudentHelp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/guimelloo/StudentHelp/issues"
+  },
+  "homepage": "https://github.com/guimelloo/StudentHelp#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.4",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/backend/controller.ts

@@ -0,0 +1,41 @@
+/**
+ * ResourceController
+ * ================================
+ * Controlador que gerencia as requisições HTTP para o recurso Resource.
+ * Expansão:
+ * - Adicione validação com pipes
+ * - Adicione autenticação/autorização
+ */
+import { Controller, Get, Post, Body, Param, Put, Delete } from '@nestjs/common';
+import { ResourceService } from './resource.service';
+import { CreateResourceDto, UpdateResourceDto } from './resource.dto';
+
+@Controller('api/resource')
+export class ResourceController {
+  constructor(private readonly resourceService: ResourceService) {}
+
+  @Post()
+  create(@Body() createResourceDto: CreateResourceDto) {
+    return this.resourceService.create(createResourceDto);
+  }
+
+  @Get()
+  findAll() {
+    return this.resourceService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id') id: string) {
+    return this.resourceService.findOne(+id);
+  }
+
+  @Put(':id')
+  update(@Param('id') id: string, @Body() updateResourceDto: UpdateResourceDto) {
+    return this.resourceService.update(+id, updateResourceDto);
+  }
+
+  @Delete(':id')
+  remove(@Param('id') id: string) {
+    return this.resourceService.remove(+id);
+  }
+}

package/templates/backend/dto.ts

@@ -0,0 +1,20 @@
+/**
+ * Resource DTOs
+ * ================================
+ * Data Transfer Objects para validação de entrada do recurso Resource.
+ * Expansão:
+ * - Adicione validação com class-validator
+ * - Adicione transformação com class-transformer
+ */
+
+export class CreateResourceDto {
+  title: string;
+  description?: string;
+  content?: string;
+}
+
+export class UpdateResourceDto {
+  title?: string;
+  description?: string;
+  content?: string;
+}

package/templates/backend/module.ts

@@ -0,0 +1,16 @@
+/**
+ * ResourceModule
+ * ===============================
+ * Este módulo agrupa todos os componentes do recurso Resource.
+ * Expansão:
+ * - Adicione guards e interceptors
+ */
+import { Module } from '@nestjs/common';
+import { ResourceService } from './resource.service';
+import { ResourceController } from './resource.controller';
+
+@Module({
+  controllers: [ResourceController],
+  providers: [ResourceService],
+})
+export class ResourceModule {}