@diagramers/cli 4.0.15 → 4.0.17

package/README.md

@@ -1,653 +1,837 @@
 # Diagramers CLI
 
-## Version Command
+A powerful command-line interface for managing Diagramers projects, generating modules, and extending functionality with a comprehensive template system.
 
-You can check the CLI version with:
-
-```
-diagramers version
-diagramers -V
-diagramers api version
-diagramers admin version
-```
+## 🚀 Features
 
-## Update Command
+### Core Capabilities
+- **Project Initialization** - Create new projects from templates
+- **Module Generation** - Generate complete modules with CRUD operations
+- **Table Generation** - Add database tables to existing modules
+- **Endpoint Generation** - Add custom endpoints to existing modules
+- **Relation Management** - Generate database relations within modules
+- **Feature Extension** - Add features to existing projects
+- **Template Management** - Download and update project templates
+
+### Supported Templates
+- **API Projects** - Full-featured Node.js API with TypeScript
+- **Admin Projects** - Modern admin dashboard with React/Vue/Angular support
+- **Custom Templates** - Extensible template system
+
+### Database Support
+- **MongoDB** - Primary database with Mongoose schemas
+- **SQL Databases** - MySQL, PostgreSQL, SQLite support
+- **Schema Generation** - Automatic schema and relation creation
 
-You can update your project with:
+## 📦 Installation
 
+### Global Installation
+```bash
+npm install -g @diagramers/cli
 ```
-diagramers update           # (if supported at root)
-diagramers admin update     # For admin projects (legacy and new)
-diagramers api update       # For API projects (legacy and new)
+
+### Local Installation
+```bash
+npm install @diagramers/cli
+npx diagramers --help
 ```
 
-- For legacy projects, dependencies are updated as before.
-- For new projects, only modules are updated/added.
+## 🚀 Quick Start
 
-## Backward Compatibility
+```bash
+# Install the CLI globally
+npm install -g @diagramers/cli
+
+# Create a new API project
+diagramers init api my-new-api
+
+# Navigate to the project
+cd my-new-api
 
-All previous commands are supported. New features (API commands, module addition) are available without breaking old workflows.
+# Set up environment variables
+cp .env.example .env
 
-## Usage Examples
+# Install dependencies
+npm install
 
+# Start development
+npm start
 ```
-# Show CLI version
-$ diagramers version
-$ diagramers api version
-$ diagramers admin version
 
-# Update admin project
-$ diagramers admin update
+## 📋 Commands
 
-# Update API project
-$ diagramers api update --modules odoo,notification
+### Project Management
+
+#### Initialize New Project
+```bash
+diagramers init <template-type> <project-name> [options]
 ```
 
-# @diagramers/cli
+**Options:**
+- `-v, --version <version>` - Specific version of the template to use (e.g., 1.1.17, latest)
+- `-t, --template <template>` - Template version to use (deprecated, use --version)
+- `-y, --yes` - Skip prompts and use defaults
 
-A powerful command-line interface for scaffolding and managing Diagramers projects. The CLI provides comprehensive tools for creating, managing, and extending API and admin dashboard projects with advanced features and automation.
+**Examples:**
+```bash
+# Create API project with latest version
+diagramers init api my-api-project
 
-## 🚀 Features
+# Create API project with specific version
+diagramers init api my-api-project -v 1.1.17
 
-### Project Management
-- **Project Scaffolding** - Create new API and admin projects from templates
-- **Template Management** - Manage and update project templates
-- **Project Initialization** - Automated project setup and configuration
-- **Environment Setup** - Automatic environment variable configuration
-- **Git Integration** - Automatic Git repository initialization
-
-### Module & Feature Generation
-- **Module Generation** - Create complete modules with CRUD operations
-- **Table Generation** - Generate database tables with relationships
-- **Endpoint Generation** - Create custom API endpoints
-- **Relation Generation** - Set up database relationships (one-to-one, one-to-many, many-to-many)
-- **Feature Extension** - Extend existing modules with new functionality
-
-### Database Management
-- **Database Seeding** - Generate and run database seeders
-- **Migration Support** - Create and manage database migrations
-- **Schema Generation** - Auto-generate database schemas
-- **Relationship Management** - Handle complex database relationships
-- **Data Validation** - Generate validation rules and schemas
-
-### Development Tools
-- **Code Generation** - Generate TypeScript interfaces, services, and controllers
-- **API Documentation** - Auto-generate Swagger/OpenAPI documentation
-- **Testing Setup** - Generate test files and testing configurations
-- **Linting & Formatting** - Set up code quality tools
-- **Build Configuration** - Generate build and deployment configurations
-
-### Authentication & Security
-- **Auth Module Generation** - Generate authentication modules
-- **Provider Integration** - Set up OAuth, SMS, and email providers
-- **Security Configuration** - Configure JWT, CORS, and security headers
-- **Role & Permission System** - Generate role-based access control
-- **Multi-factor Authentication** - Set up MFA providers
-
-### Communication Services
-- **Email System Setup** - Configure email providers and templates
-- **SMS Integration** - Set up SMS providers for notifications
-- **Push Notifications** - Configure push notification services
-- **Webhook Management** - Set up webhook endpoints and handlers
-
-### Deployment & DevOps
-- **Docker Configuration** - Generate Docker and Docker Compose files
-- **CI/CD Setup** - Create GitHub Actions and other CI/CD configurations
-- **Environment Management** - Manage multiple environment configurations
-- **Monitoring Setup** - Configure logging and monitoring tools
-- **Backup Configuration** - Set up automated backup systems
+# Create admin project with specific version
+diagramers admin init react-typescript my-admin-dashboard -v 1.0.0
+```
 
-## 📦 Installation
+#### Update Project
+
+Update an existing project with the latest template features:
 
-### Global Installation (Recommended)
 ```bash
-npm install -g @diagramers/cli
+diagramers update [options]
 ```
 
-### Local Installation
+**Options:**
+- `-v, --version <version>` - Specific version to update to (e.g., 1.1.27, latest)
+- `-f, --force` - Force update even if conflicts detected
+- `-b, --backup` - Create backup before updating
+
+**Examples:**
 ```bash
-npm install @diagramers/cli
-npx diagramers-cli --help
+# Update to latest version
+diagramers update
+
+# Update to specific version
+diagramers update -v 1.1.27
+
+# Force update (overwrite conflicts)
+diagramers update --force
+
+# Create backup before updating
+diagramers update --backup
+
+# Combine options
+diagramers update -v 1.1.27 --backup --force
 ```
 
-### Development Installation
+#### What Gets Updated
+
+The update command intelligently updates the following:
+
+- **Core Files**: `src/core/`, `src/shared/`, `src/plugins/`
+- **Configuration**: `config/` folder, `webpack.config.js`, `tsconfig.json`
+- **Scripts**: `scripts/` folder with utility scripts
+- **Documentation**: `README.md`, `DEVELOPER_GUIDE.md`
+- **Environment**: `.env.example` template
+- **Package.json**: Updates dependencies and scripts while preserving project-specific fields
+
+#### Version Management
+
+- **Automatic Version Sync**: Project version is updated to match template version
+- **Project Preservation**: Project-specific fields (name, description, repository, etc.) are preserved
+- **Conflict Detection**: Detects conflicts and allows force overwrite
+- **Backup Support**: Creates timestamped backups before updating
+
+#### Update Process
+
+1. **Validation**: Checks if current directory is a valid project
+2. **Version Check**: Shows current project version vs target version
+3. **Backup**: Creates backup if requested
+4. **Download**: Downloads latest template from npm
+5. **Conflict Check**: Identifies files with conflicts
+6. **Update**: Updates files while preserving project-specific settings
+7. **Cleanup**: Removes temporary files
+
+#### Example Output
+
 ```bash
-git clone https://github.com/diagramers/diagramers-cli.git
-cd diagramers-cli
-npm install
-npm link
+🔄 Checking for template updates...
+📦 Current project version: 1.1.26
+📌 Updating to latest version
+📦 Downloading latest template: @diagramers/api
+✅ Template downloaded from npm: @diagramers/api
+📝 Updating project files...
+✅ Updated: src/core/config/index.ts
+✅ Updated: scripts/env-debug.js
+✅ Updated: package.json (version: 1.1.27)
+✅ Project updated successfully!
+📦 Template version: 1.1.27
+📝 Review the changes and test your application
+💡 Run "npm install" to update dependencies if needed
+```
+
+#### List Available Versions
+```bash
+diagramers versions [options]
 ```
 
-## 🛠️ Quick Start
+**Options:**
+- `-a, --all` - Show all versions (default: show last 10)
 
-### 1. Create a New API Project
+**Examples:**
 ```bash
-# Create a new API project
-diagramers init api my-api-project
+# Show last 10 versions
+diagramers versions
 
-# Navigate to the project
-cd my-api-project
+# Show all available versions
+diagramers versions --all
+```
 
-# Install dependencies
-npm install --legacy-peer-deps
+### Module Management
 
-# Start development server
-npm run dev
+#### Generate Module
+```bash
+diagramers extend --module <module-name> [options]
 ```
 
-### 2. Create a New Admin Dashboard
+**Examples:**
 ```bash
-# Create a new admin dashboard
-diagramers init admin my-admin-dashboard
-
-# Navigate to the project
-cd my-admin-dashboard
+# Generate basic module
+diagramers extend --module products
 
-# Install dependencies
-npm install --legacy-peer-deps
+# Generate module with CRUD operations
+diagramers extend --module products --crud
 
-# Start development server
-npm start
+# Generate module with custom fields
+diagramers extend --module products --fields name,price,description --crud
 ```
 
-### 3. Generate Your First Module
+### Table Management
+
+#### Add Table to Module
 ```bash
-# Generate a products module with CRUD operations
-diagramers extend --module products --crud
+diagramers extend --table <module:table> --fields <field1,field2,...>
+```
 
+**Examples:**
+```bash
 # Add categories table to products module
 diagramers extend --table products:categories --fields name,description,slug
 
 # Add products table to products module
-diagramers extend --table products:products --fields name,price,description,category_id
+diagramers extend --table products:products --fields name,price,category_id
 
-# Create relationship between categories and products
-diagramers extend --relation products:category-product:one-to-many
+# Add user profiles table to users module
+diagramers extend --table users:profiles --fields bio,avatar,social_links
 ```
 
-### 4. Add Custom Endpoints
-```bash
-# Add search endpoint
-diagramers extend --endpoint products:search --method GET --description "Search products"
+**Field Types (Auto-detected):**
+- `name`, `title`, `description` → String
+- `email`, `phone` → String
+- `price`, `count`, `age` → Number
+- `created_at`, `updated_at` → Date
+- `is_active`, `verified` → Boolean
+- `*_id` → ObjectId
+- `status` → Number
+
+### Endpoint Management
 
-# Add featured products endpoint
-diagramers extend --endpoint products:featured --method GET --description "Get featured products"
+#### Add Endpoint to Module
+```bash
+diagramers extend --endpoint <module:endpoint> [options]
 ```
 
-## 📚 CLI Commands
+**Examples:**
+```bash
+# Add GET endpoint
+diagramers extend --endpoint products:search --method GET
 
-### Project Management Commands
+# Add POST endpoint
+diagramers extend --endpoint users:reset-password --method POST
 
-#### Initialize Projects
-```bash
-# Initialize API project
-diagramers init api <project-name> [options]
+# Add endpoint with custom path
+diagramers extend --endpoint products:featured --method GET --path /featured --description "Get featured products"
+```
 
-# Initialize admin dashboard
-diagramers init admin <project-name> [options]
+**Supported Methods:**
+- `GET` - Retrieve data
+- `POST` - Create data
+- `PUT` - Update data
+- `DELETE` - Delete data
 
-# Initialize both API and admin projects
-diagramers init <project-name> --api --admin
+### Relation Management
 
-# Initialize with specific template version
-diagramers init api <project-name> --version 4.0.1
+#### Create Relations Within Module
+```bash
+diagramers extend --relation <module:table1-table2[:type]>
 ```
 
-#### Project Options
+**Examples:**
 ```bash
-# Initialize with custom configuration
-diagramers init api <project-name> \
-  --database mongodb \
-  --auth internal,oauth,sms \
-  --email sendgrid \
-  --deploy firebase
+# One-to-many relation (default)
+diagramers extend --relation products:category-product
+
+# One-to-one relation
+diagramers extend --relation users:user-profile:one-to-one
 
-# Initialize with specific features
-diagramers init api <project-name> \
-  --features auth,email,sms,notifications,file-upload \
-  --providers google,github,twilio,sendgrid
+# Many-to-many relation
+diagramers extend --relation products:product-tag:many-to-many
 ```
 
-### Module Management Commands
+**Relation Types:**
+- `one-to-one` - Single record relations
+- `one-to-many` - Parent-child relations (default)
+- `many-to-many` - Junction table relations
 
-#### Generate Modules
+### Feature Management
+
+#### List Available Features
 ```bash
-# Generate basic module
-diagramers extend --module <module-name>
+diagramers extend --list
+```
 
-# Generate module with CRUD operations
-diagramers extend --module <module-name> --crud
+#### Add Feature
+```bash
+diagramers extend --feature <feature-name>
+```
 
-# Generate module with specific fields
-diagramers extend --module users --fields email,username,role,is_active --crud
+## 🎨 Admin Dashboard Management
 
-# Generate module with authentication
-diagramers extend --module auth --auth --providers internal,oauth,sms
+The CLI provides comprehensive support for managing admin dashboard projects with modern frameworks and features.
 
-# Generate module with custom configuration
-diagramers extend --module products \
-  --fields name,price,description,category_id \
-  --crud \
-  --validation \
-  --tests \
-  --docs
+### Admin Project Initialization
+
+#### Initialize New Admin Project
+```bash
+diagramers admin init <template-type> <project-name> [options]
 ```
 
-#### Module Options
+**Template Types:**
+- `react-typescript` - React 18 + TypeScript + Tailwind CSS
+- `vue-typescript` - Vue 3 + TypeScript + Tailwind CSS
+- `angular` - Angular 17 + TypeScript + Tailwind CSS
+
+**Options:**
+- `-f, --framework <framework>` - Framework to use (react, vue, angular)
+- `-t, --template <template>` - Template package name
+- `-v, --version <version>` - Template version to use
+- `-y, --yes` - Skip prompts and use defaults
+- `--typescript` - Use TypeScript (default: true)
+- `--tailwind` - Use Tailwind CSS (default: true)
+- `--api-url <url>` - API URL for the backend
+- `--socket-url <url>` - Socket.IO URL for real-time features
+
+**Examples:**
 ```bash
-# Generate with specific features
-diagramers extend --module <module-name> \
-  --crud \
-  --validation \
-  --tests \
-  --docs \
-  --migrations \
-  --seeders
+# Create React admin project
+diagramers admin init react-typescript my-admin-app
+
+# Create Vue admin project with specific version
+diagramers admin init vue-typescript my-vue-admin --version 1.0.0
 
-# Generate with custom paths
-diagramers extend --module <module-name> \
-  --path src/modules/custom \
-  --template custom-template
+# Create Angular admin project with custom API URL
+diagramers admin init angular my-angular-admin --api-url http://localhost:3000
+
+# Create with all options
+diagramers admin init react-typescript my-admin-app \
+  --framework react \
+  --typescript \
+  --tailwind \
+  --api-url http://localhost:3000 \
+  --socket-url http://localhost:3000
 ```
 
-### Table Generation Commands
+### Admin Project Extension
 
-#### Generate Tables
+#### Extend Admin Project
+```bash
+diagramers admin extend [options]
+```
+
+**Options:**
+- `-p, --page <name>` - Generate a new page
+- `-c, --component <name>` - Generate a new component
+- `-s, --service <name>` - Generate a new service
+- `-h, --hook <name>` - Generate a new custom hook
+- `-m, --module <name>` - Generate a complete module with CRUD
+- `--crud` - Include CRUD operations for module
+- `--api` - Include API integration for module
+- `--socket` - Include Socket.IO integration for module
+- `--table` - Include data table for module
+- `--form` - Include form components for module
+- `--chart` - Include chart components for module
+- `--auth` - Include authentication for module
+- `--path <path>` - Custom path for generated files
+
+**Examples:**
 ```bash
-# Add table to existing module
-diagramers extend --table <module>:<table> --fields <field1>,<field2>
+# Generate a new module with CRUD operations
+diagramers admin extend --module products --crud --api --table
+
+# Generate a new page
+diagramers admin extend --page analytics
 
-# Generate table with various field types
-diagramers extend --table users:profiles \
-  --fields bio,avatar,birth_date,is_verified,preferences
+# Generate a new component
+diagramers admin extend --component ProductCard
 
-# Generate table with relationships
-diagramers extend --table products:categories \
-  --fields name,description,slug,parent_id \
-  --relations parent:categories:one-to-many
+# Generate a new service
+diagramers admin extend --service orderService
 
-# Generate table with indexes
-diagramers extend --table products:products \
-  --fields name,price,description,category_id,sku \
-  --indexes name,sku,category_id
+# Generate a new custom hook
+diagramers admin extend --hook useOrders
+
+# Generate complete module with all features
+diagramers admin extend --module orders --crud --api --socket --table --form --chart --auth
 ```
 
-#### Field Types
+### Admin Project Updates
+
+#### Update Admin Project
 ```bash
-# String fields
-diagramers extend --table users:profiles \
-  --fields name:string,email:string,phone:string
+diagramers admin update [options]
+```
 
-# Numeric fields
-diagramers extend --table products:products \
-  --fields price:number,stock:integer,rating:float
+**Options:**
+- `-t, --template <template>` - Template to update
+- `-v, --version <version>` - Version to update to
+- `--force` - Force update even if conflicts exist
+- `--backup` - Create backup before updating
 
-# Date fields
-diagramers extend --table orders:orders \
-  --fields created_at:date,updated_at:date,delivery_date:datetime
+**Examples:**
+```bash
+# Update to latest version
+diagramers admin update
+
+# Update to specific version
+diagramers admin update --version 1.0.0
 
-# Boolean fields
-diagramers extend --table users:users \
-  --fields is_active:boolean,email_verified:boolean
+# Force update with backup
+diagramers admin update --force --backup
+```
 
-# Object/JSON fields
-diagramers extend --table users:profiles \
-  --fields preferences:object,metadata:json
+### Admin Version Management
 
-# Array fields
-diagramers extend --table products:products \
-  --fields tags:array,images:array
+#### Check Admin Version
+```bash
+diagramers admin version [options]
 ```
 
-### Endpoint Generation Commands
+**Options:**
+- `-c, --check <version>` - Check if specific version exists
 
-#### Generate Endpoints
+**Examples:**
 ```bash
-# Add GET endpoint
-diagramers extend --endpoint <module>:<endpoint> --method GET
+# Show current version info
+diagramers admin version
 
-# Add POST endpoint with custom path
-diagramers extend --endpoint users:reset-password --method POST --path /reset-password
+# Check specific version
+diagramers admin version --check 1.0.0
+```
 
-# Add endpoint with validation
-diagramers extend --endpoint products:create --method POST \
-  --validation name:required,price:required:number
+#### List Available Admin Versions
+```bash
+diagramers admin versions [options]
+```
 
-# Add endpoint with authentication
-diagramers extend --endpoint users:profile --method GET \
-  --auth required --roles user,admin
+**Options:**
+- `-a, --all` - Show all versions (default: show last 10)
 
-# Add endpoint with custom logic
-diagramers extend --endpoint products:search --method GET \
-  --description "Search products with filters" \
-  --query name,price_min,price_max,category_id
+**Examples:**
+```bash
+# Show last 10 versions
+diagramers admin versions
+
+# Show all available versions
+diagramers admin versions --all
+```
+
+### Admin Project Features
+
+#### Available Templates
+- **React TypeScript Admin** - React 18 + TypeScript + Tailwind CSS
+- **Vue TypeScript Admin** - Vue 3 + TypeScript + Tailwind CSS  
+- **Angular Admin** - Angular 17 + TypeScript + Tailwind CSS
+
+#### Built-in Features
+- **Authentication System** - Login, register, password reset, JWT management
+- **Dashboard** - Analytics overview, metric cards, chart widgets
+- **User Management** - User CRUD, profiles, role management, activity tracking
+- **Real-time Updates** - Socket.IO integration, live notifications
+- **Data Tables** - Advanced filtering, sorting, pagination, bulk actions
+- **Charts & Analytics** - Line, bar, pie, area charts with real-time data
+- **Form Builder** - Dynamic forms, validation, file uploads, multi-step forms
+- **File Upload** - Drag & drop, progress tracking, file preview
+- **Notifications** - Toast notifications, notification center, push notifications
+- **Settings Panel** - Application settings, user preferences, theme customization
+
+#### Project Structure
+```
+my-admin-app/
+├── src/
+│   ├── components/           # Reusable UI components
+│   │   ├── ui/              # Base UI components
+│   │   └── layout/          # Layout components
+│   ├── features/            # Feature modules
+│   │   ├── auth/           # Authentication
+│   │   ├── dashboard/      # Dashboard
+│   │   ├── users/          # User management
+│   │   └── [modules]/      # Generated modules
+│   ├── hooks/              # Custom React hooks
+│   ├── services/           # API services
+│   ├── lib/                # Utilities and configurations
+│   ├── types/              # TypeScript type definitions
+│   ├── styles/             # Global styles
+│   └── assets/             # Static assets
+├── public/                 # Public assets
+├── package.json           # Dependencies and scripts
+├── tsconfig.json          # TypeScript configuration
+├── tailwind.config.js     # Tailwind CSS configuration
+├── vite.config.ts         # Vite configuration
+└── .env                   # Environment variables
+```
+
+### Email System Management
+
+#### Generate Email Module
+```bash
+diagramers extend --module email --crud
 ```
 
-#### Endpoint Options
+#### Add Email Configuration Table
 ```bash
-# Generate with specific features
-diagramers extend --endpoint <module>:<endpoint> \
-  --method GET \
-  --auth required \
-  --roles admin \
-  --validation \
-  --tests \
-  --docs \
-  --rate-limit 100:1m
+diagramers extend --table email:configs --fields provider,code,credentials,fromName,fromEmail,default
+```
 
-# Generate with custom response
-diagramers extend --endpoint products:featured \
-  --method GET \
-  --response "Product[]" \
-  --description "Get featured products"
+#### Add Email Templates Table
+```bash
+diagramers extend --table email:templates --fields name,subject,body,isActive,createdAt
 ```
 
-### Relationship Generation Commands
+#### Add Email Logs Table
+```bash
+diagramers extend --table email:logs --fields to,subject,status,provider,error,createdAt
+```
 
-#### Generate Relationships
+#### Create Email Relations
 ```bash
-# One-to-many relation (default)
-diagramers extend --relation <module>:<relation-name>
+# One-to-many: User to Email Configs
+diagramers extend --relation email:user-config:one-to-many
 
-# One-to-one relation
-diagramers extend --relation users:user-profile:one-to-one
+# One-to-many: Email Config to Email Logs
+diagramers extend --relation email:config-log:one-to-many
+```
 
-# Many-to-many relation
-diagramers extend --relation products:product-tag:many-to-many
+#### Add Email Endpoints
+```bash
+# Send email endpoint
+diagramers extend --endpoint email:send --method POST --description "Send email using configured provider"
 
-# Complex relationships
-diagramers extend --relation orders:order-items:one-to-many \
-  --through products \
-  --fields quantity,price
+# Test email endpoint
+diagramers extend --endpoint email:test --method POST --description "Test email configuration"
 
-# Self-referencing relationships
-diagramers extend --relation categories:parent-child:one-to-many \
-  --self-referencing
+# Get email statistics
+diagramers extend --endpoint email:stats --method GET --description "Get email sending statistics"
 ```
 
-### Authentication Commands
-
-#### Generate Auth Modules
+#### Email Provider Setup Commands
 ```bash
-# Generate basic authentication
-diagramers extend --auth --providers internal
+# Add Gmail SMTP configuration
+diagramers extend --endpoint email:setup-gmail --method POST --description "Setup Gmail SMTP configuration"
 
-# Generate multi-provider authentication
-diagramers extend --auth --providers internal,oauth,sms,email
+# Add SendGrid configuration
+diagramers extend --endpoint email:setup-sendgrid --method POST --description "Setup SendGrid configuration"
 
-# Generate OAuth providers
-diagramers extend --auth --providers oauth \
-  --oauth google,github,facebook,twitter
+# Add AWS SES configuration
+diagramers extend --endpoint email:setup-ses --method POST --description "Setup AWS SES configuration"
+```
 
-# Generate SMS authentication
-diagramers extend --auth --providers sms \
-  --sms twilio,aws-sns,vonage
+### User Management System
 
-# Generate email authentication
-diagramers extend --auth --providers email \
-  --email sendgrid,aws-ses,mailgun
+#### Generate User Module
+```bash
+diagramers extend --module users --crud
 ```
 
-#### Auth Configuration
+#### Add User Profile Table
 ```bash
-# Generate with specific features
-diagramers extend --auth \
-  --providers internal,oauth,sms \
-  --features registration,login,logout,password-reset,email-verification \
-  --oauth google,github \
-  --sms twilio \
-  --jwt \
-  --refresh-tokens \
-  --rate-limiting
+diagramers extend --table users:profiles --fields bio,avatar,socialLinks,location,website,birthDate,preferences
 ```
 
-### Communication Commands
+#### Add User Sessions Table
+```bash
+diagramers extend --table users:sessions --fields userId,deviceInfo,ipAddress,userAgent,isActive,lastActivity
+```
 
-#### Generate Email System
+#### Add User Activity Table
 ```bash
-# Generate email module
-diagramers extend --email --providers sendgrid,aws-ses,mailgun
+diagramers extend --table users:activities --fields userId,action,details,ipAddress,userAgent,timestamp
+```
 
-# Generate email templates
-diagramers extend --email-templates \
-  --templates welcome,password-reset,verification,notification
+#### Create User Relations
+```bash
+# One-to-one: User to Profile
+diagramers extend --relation users:user-profile:one-to-one
 
-# Generate email configuration
-diagramers extend --email-config \
-  --providers sendgrid,aws-ses \
-  --templates handlebars
+# One-to-many: User to Sessions
+diagramers extend --relation users:user-session:one-to-many
+
+# One-to-many: User to Activities
+diagramers extend --relation users:user-activity:one-to-many
 ```
 
-#### Generate SMS System
+#### Add User Endpoints
 ```bash
-# Generate SMS module
-diagramers extend --sms --providers twilio,aws-sns,vonage
+# User profile management
+diagramers extend --endpoint users:profile --method GET --description "Get user profile"
+diagramers extend --endpoint users:update-profile --method PUT --description "Update user profile"
+diagramers extend --endpoint users:upload-avatar --method POST --description "Upload user avatar"
 
-# Generate SMS templates
-diagramers extend --sms-templates \
-  --templates verification,notification,alert
+# User administration
+diagramers extend --endpoint users:list --method GET --description "List all users (admin)"
+diagramers extend --endpoint users:create --method POST --description "Create user (admin)"
+diagramers extend --endpoint users:update --method PUT --description "Update user (admin)"
+diagramers extend --endpoint users:delete --method DELETE --description "Delete user (admin)"
 
-# Generate SMS configuration
-diagramers extend --sms-config \
-  --providers twilio,aws-sns \
-  --features verification,notifications
+# User statistics
+diagramers extend --endpoint users:stats --method GET --description "Get user statistics"
+diagramers extend --endpoint users:activity --method GET --description "Get user activity"
 ```
 
-### Database Commands
+## 🔧 Workflow Examples
+
+### Complete Product Management System
 
-#### Database Operations
 ```bash
-# Run database seeding
-diagramers db seed
+# 1. Create new API project
+diagramers init api ecommerce-api
+cd ecommerce-api
 
-# Reset and reseed database
-diagramers db seed --reset
+# 2. Generate products module
+diagramers extend --module products --crud
 
-# Generate seeders for specific modules
-diagramers db seed --modules products,users
+# 3. Add categories table
+diagramers extend --table products:categories --fields name,description,slug
 
-# Create database migration
-diagramers db migrate --create <migration-name>
+# 4. Add products table
+diagramers extend --table products:products --fields name,price,description,category_id
 
-# Run database migrations
-diagramers db migrate --run
+# 5. Create category-product relation
+diagramers extend --relation products:category-product:one-to-many
 
-# Rollback migrations
-diagramers db migrate --rollback
+# 6. Add custom search endpoint
+diagramers extend --endpoint products:search --method GET --description "Search products"
+
+# 7. Install dependencies and start
+npm install
+npm start
 ```
 
-#### Database Configuration
+### User Management with Profiles
+
 ```bash
-# Generate database configuration
-diagramers db config --type mongodb --connection-pool 10
+# 1. Generate users module (if not exists)
+diagramers extend --module users --crud
+
+# 2. Add user profiles table
+diagramers extend --table users:profiles --fields bio,avatar,social_links,birth_date
 
-# Generate database schemas
-diagramers db schemas --modules products,users,orders
+# 3. Create user-profile relation
+diagramers extend --relation users:user-profile:one-to-one
 
-# Generate database indexes
-diagramers db indexes --modules products --indexes name,price,category_id
+# 4. Add profile endpoints
+diagramers extend --endpoint users:update-profile --method PUT
+diagramers extend --endpoint users:get-profile --method GET
 ```
 
-### Testing Commands
+### Complete Email System Setup
 
-#### Generate Tests
 ```bash
-# Generate unit tests
-diagramers test --unit --modules products,users
-
-# Generate integration tests
-diagramers test --integration --modules products
+# 1. Generate email module with CRUD operations
+diagramers extend --module email --crud
 
-# Generate API tests
-diagramers test --api --endpoints products,users
+# 2. Add email configurations table
+diagramers extend --table email:configs --fields provider,code,credentials,fromName,fromEmail,default
 
-# Generate test configuration
-diagramers test --config --framework jest --coverage
-```
+# 3. Add email templates table
+diagramers extend --table email:templates --fields name,subject,body,isActive,createdAt
 
-### Documentation Commands
+# 4. Add email logs table for tracking
+diagramers extend --table email:logs --fields to,subject,status,provider,error,createdAt
 
-#### Generate Documentation
-```bash
-# Generate API documentation
-diagramers docs api --format swagger --output docs/api
+# 5. Create relationships
+diagramers extend --relation email:user-config:one-to-many
+diagramers extend --relation email:config-log:one-to-many
 
-# Generate module documentation
-diagramers docs modules --format markdown --output docs/modules
+# 6. Add email-specific endpoints
+diagramers extend --endpoint email:send --method POST --description "Send email using configured provider"
+diagramers extend --endpoint email:test --method POST --description "Test email configuration"
+diagramers extend --endpoint email:stats --method GET --description "Get email sending statistics"
 
-# Generate deployment documentation
-diagramers docs deployment --platforms docker,firebase --output docs/deployment
+# 7. Add provider setup endpoints
+diagramers extend --endpoint email:setup-gmail --method POST --description "Setup Gmail SMTP configuration"
+diagramers extend --endpoint email:setup-sendgrid --method POST --description "Setup SendGrid configuration"
 
-# Generate README files
-diagramers docs readme --modules products,users --output docs
+# 8. Install dependencies and start
+npm install
+npm start
 ```
 
-### Documentation Templates
+### Complete User Management System Setup
+
 ```bash
-# Use custom documentation template
-diagramers docs --template custom-docs --output docs
+# 1. Generate users module with CRUD operations
+diagramers extend --module users --crud
 
-# Generate documentation for specific features
-diagramers docs --features auth,email,sms --output docs/features
-```
+# 2. Add user profiles table
+diagramers extend --table users:profiles --fields bio,avatar,socialLinks,location,website,birthDate,preferences
 
-## 🔍 Troubleshooting
+# 3. Add user sessions table for tracking
+diagramers extend --table users:sessions --fields userId,deviceInfo,ipAddress,userAgent,isActive,lastActivity
 
-### Common Issues
+# 4. Add user activity table for audit
+diagramers extend --table users:activities --fields userId,action,details,ipAddress,userAgent,timestamp
 
-#### Project Generation Issues
-```bash
-# Clear CLI cache
-diagramers cache clear
+# 5. Create user relationships
+diagramers extend --relation users:user-profile:one-to-one
+diagramers extend --relation users:user-session:one-to-many
+diagramers extend --relation users:user-activity:one-to-many
 
-# Update CLI to latest version
-npm update -g @diagramers/cli
+# 6. Add user profile endpoints
+diagramers extend --endpoint users:profile --method GET --description "Get user profile"
+diagramers extend --endpoint users:update-profile --method PUT --description "Update user profile"
+diagramers extend --endpoint users:upload-avatar --method POST --description "Upload user avatar"
 
-# Check template availability
-diagramers template list --available
+# 7. Add user administration endpoints
+diagramers extend --endpoint users:list --method GET --description "List all users (admin)"
+diagramers extend --endpoint users:create --method POST --description "Create user (admin)"
+diagramers extend --endpoint users:update --method PUT --description "Update user (admin)"
+diagramers extend --endpoint users:delete --method DELETE --description "Delete user (admin)"
+
+# 8. Add user analytics endpoints
+diagramers extend --endpoint users:stats --method GET --description "Get user statistics"
+diagramers extend --endpoint users:activity --method GET --description "Get user activity"
+
+# 9. Install dependencies and start
+npm install
+npm start
 ```
 
-#### Module Generation Issues
-```bash
-# Validate module configuration
-diagramers validate --module products
+## 🛠️ Advanced Usage
 
-# Check field types
-diagramers validate --fields name:string,price:number
+### Database Seeding
 
-# Verify relationships
-diagramers validate --relation products:categories
-```
+All generated tables automatically include:
+- **Sample data** - 3 sample records per table
+- **Seeder integration** - Automatic database seeding
+- **Development data** - Realistic test data
 
-#### Database Issues
 ```bash
-# Check database connection
-diagramers db check --connection
-
-# Validate database schema
-diagramers db validate --schema
+# Run database seeding
+npm run seed
 
-# Test database operations
-diagramers db test --operations
+# Reset and reseed database
+npm run seed --reset
 ```
 
-### Debug Mode
-```bash
-# Enable debug logging
-diagramers --debug init api my-project
+### Template Updates
 
-# Verbose output
-diagramers --verbose extend --module products
+```bash
+# Update project with latest template
+diagramers update
 
-# Dry run (preview changes)
-diagramers --dry-run extend --module products
+# Force update with backup
+diagramers update --force --backup
 ```
 
-## 🤝 Contributing
+### Custom Field Types
 
-### Development Setup
-```bash
-# Clone repository
-git clone https://github.com/diagramers/diagramers-cli.git
-cd diagramers-cli
+The CLI automatically detects field types based on naming conventions:
 
-# Install dependencies
-npm install
+```bash
+# These fields will be auto-typed:
+diagramers extend --table products:products --fields \
+  name,description,price,stock_count,created_at,is_active,category_id
+```
+
+**Auto-detection:**
+- `name`, `title`, `description` → String
+- `price`, `count`, `stock_count` → Number
+- `created_at`, `updated_at` → Date
+- `is_active`, `verified` → Boolean
+- `category_id`, `user_id` → ObjectId
+
+## 📚 Project Structure
+
+Generated projects follow this structure:
+
+```
+my-project/
+├── src/
+│   ├── modules/
+│   │   ├── products/
+│   │   │   ├── controllers/
+│   │   │   ├── entities/
+│   │   │   ├── schemas/
+│   │   │   ├── services/
+│   │   │   └── routes/
+│   │   └── users/
+│   ├── core/
+│   │   ├── database/
+│   │   ├── config/
+│   │   └── server/
+│   └── shared/
+├── scripts/
+└── package.json
+```
 
-# Link for development
-npm link
+## 🔍 Troubleshooting
 
-# Run tests
-npm test
+### Common Issues
 
-# Build project
-npm run build
+#### Module Not Found
+```bash
+❌ Module 'inventory' does not exist
+```
+**Solution:** Create the module first:
+```bash
+diagramers extend --module inventory
 ```
 
-### Contributing Guidelines
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new functionality
-5. Ensure all tests pass
-6. Submit a pull request
+#### Table Already Exists
+```bash
+❌ Table 'products' already exists in module 'products'
+```
+**Solution:** Use a different table name or check existing tables
 
-### Code Style
+#### Invalid Relation
+```bash
+❌ Table 'categories' does not exist in module 'products'
+```
+**Solution:** Create both tables before creating relations:
 ```bash
-# Run linting
-npm run lint
+diagramers extend --table products:categories --fields name,description
+diagramers extend --table products:products --fields name,price
+diagramers extend --relation products:category-product
+```
 
-# Fix linting issues
-npm run lint:fix
+### Getting Help
 
-# Format code
-npm run format
+```bash
+# General help
+diagramers --help
 
-# Type checking
-npm run type-check
+# Command-specific help
+diagramers init --help
+diagramers extend --help
+diagramers update --help
 ```
 
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
 ## 📄 License
 
-MIT License - see LICENSE file for details
+MIT License - see [LICENSE](LICENSE) file for details.
 
 ## 🔗 Related Packages
 
-- [@diagramers/api](./diagramers-api) - Node.js API template
-- [@diagramers/admin](./diagramers-admin) - React admin dashboard template
+- [@diagramers/api](https://npmjs.com/package/@diagramers/api) - API template package
+- [@diagramers/admin](https://npmjs.com/package/@diagramers/admin) - Admin template package
 
 ## 📞 Support
 
-For support and questions:
-- Create an issue on GitHub
-- Check the documentation
-- Review the examples in the codebase
-- Join our community discussions
-
-## 🗺️ Roadmap
-
-### Upcoming Features
-- [ ] GraphQL support
-- [ ] Microservices architecture
-- [ ] Kubernetes deployment
-- [ ] Advanced caching strategies
-- [ ] Real-time analytics
-- [ ] Advanced security features
-- [ ] Multi-tenant support
-- [ ] API versioning
-- [ ] Advanced rate limiting
-- [ ] Webhook system
-
-### Plugin Ecosystem
-- [ ] Plugin marketplace
-- [ ] Community plugins
-- [ ] Plugin development tools
-- [ ] Plugin testing framework
-- [ ] Plugin documentation generator
-
-### Integration Features
-- [ ] Third-party service integrations
-- [ ] Payment gateway integrations
-- [ ] Analytics integrations
-- [ ] Monitoring integrations
-- [ ] Backup service integrations 
+- **Issues**: [GitHub Issues](https://github.com/diagramers/diagramers-cli/issues)
+- **Documentation**: [Official Docs](https://docs.diagramers.com)
+- **Community**: [Discord Server](https://discord.gg/diagramers)