# ~/.devex/backend-development.yaml
# Complete Backend Development Environment

applications:
  development:
    # Version Control
    - name: git
      description: "Distributed version control system"
      category: "Version Control"
      default: true
      priority: 10
      
    - name: gh
      description: "GitHub CLI"
      category: "Version Control"
      default: true
      dependencies: ["git"]
      
    # Code Editors
    - name: vscode
      description: "Visual Studio Code"
      category: "Editors"
      default: true
      post_install:
        # Backend development extensions
        - shell: "code --install-extension ms-python.python"
        - shell: "code --install-extension golang.go"
        - shell: "code --install-extension ms-vscode.vscode-typescript-next"
        - shell: "code --install-extension ms-vscode.vscode-json"
        - shell: "code --install-extension redhat.vscode-yaml"
        - shell: "code --install-extension ms-kubernetes-tools.vscode-kubernetes-tools"
        - shell: "code --install-extension ms-vscode.vscode-docker"
        - shell: "code --install-extension humao.rest-client"
        - shell: "code --install-extension esbenp.prettier-vscode"
        - shell: "code --install-extension ms-vscode.vscode-eslint"
        
    # Alternative Editors
    - name: vim
      description: "Vim text editor"
      category: "Editors"
      default: false
      
    - name: nvim
      description: "Neovim text editor"
      category: "Editors"
      default: false
      
    # Container and Orchestration
    - name: docker
      description: "Container platform"
      category: "Containers"
      default: true
      priority: 20
      post_install:
        - shell: "docker run hello-world"
        - shell: "sudo usermod -aG docker $USER"
      service:
        name: docker
        enabled: true
        started: true
        
    - name: docker-compose
      description: "Docker Compose for multi-container apps"
      category: "Containers"
      default: true
      dependencies: ["docker"]
      
    - name: kubectl
      description: "Kubernetes command-line tool"
      category: "Orchestration"
      default: true
      post_install:
        - shell: "kubectl completion bash > ~/.kube/completion.bash"
        
    - name: helm
      description: "Kubernetes package manager"
      category: "Orchestration"
      default: true
      dependencies: ["kubectl"]
      
    - name: k9s
      description: "Kubernetes cluster management"
      category: "Orchestration"
      default: false
      dependencies: ["kubectl"]
      
    # API Development Tools
    - name: postman
      description: "API development and testing"
      category: "API Tools"
      default: false
      linux:
        install_method: flatpak
        install_command: com.getpostman.Postman
      macos:
        install_method: brew
        install_command: postman
        cask: true
      windows:
        install_method: winget
        install_command: Postman.Postman
        
    - name: insomnia
      description: "API client and design tool"
      category: "API Tools"
      default: false
      linux:
        install_method: flatpak
        install_command: rest.insomnia.Insomnia
      macos:
        install_method: brew
        install_command: insomnia
        cask: true
        
    - name: httpie
      description: "Command-line HTTP client"
      category: "API Tools"
      default: true
      
    - name: curl
      description: "Command-line data transfer tool"
      category: "API Tools"
      default: true
      
    - name: jq
      description: "JSON processor"
      category: "Utilities"
      default: true
      
    # Monitoring and Debugging
    - name: htop
      description: "Interactive process viewer"
      category: "Monitoring"
      default: true
      
    - name: netstat
      description: "Network statistics"
      category: "Monitoring"
      default: true
      
    - name: lsof
      description: "List open files"
      category: "Monitoring"
      default: true
      
    - name: tcpdump
      description: "Network packet analyzer"
      category: "Monitoring"
      default: false
      
    # Terminal and Shell Tools
    - name: zsh
      description: "Zsh shell"
      category: "Shell"
      default: true
      post_install:
        - shell: "sh -c '$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)'"
        
    - name: tmux
      description: "Terminal multiplexer"
      category: "Terminal"
      default: true
      
    - name: fzf
      description: "Fuzzy finder"
      category: "Utilities"
      default: true
      
    - name: ripgrep
      description: "Fast grep alternative"
      category: "Utilities"
      default: true
      
    - name: bat
      description: "Cat with syntax highlighting"
      category: "Utilities"
      default: true
      
    # Version Control Tools
    - name: git-lfs
      description: "Git Large File Storage"
      category: "Version Control"
      default: false
      dependencies: ["git"]
      
    - name: lazygit
      description: "Terminal UI for git"
      category: "Version Control"
      default: false
      dependencies: ["git"]

# Programming Languages
programming_languages:
  - name: Node.js
    description: "JavaScript runtime for server-side development"
    category: "Programming Languages"
    install_method: mise
    install_command: node@lts
    default: true
    shell_updates:
      - "export NODE_OPTIONS='--max-old-space-size=4096'"
    post_install:
      - shell: "npm install -g npm@10.4.0"  # Pin npm version for stability
      - shell: "npm install -g pnpm yarn"
      - shell: "npm install -g nodemon pm2 forever"
      - shell: "npm install -g @nestjs/cli express-generator"
      
  - name: Python
    description: "Python programming language"
    category: "Programming Languages"
    install_method: mise
    install_command: python@3.11
    default: true
    post_install:
      - shell: "pip install --upgrade pip"
      - shell: "pip install virtualenv pipenv poetry"
      - shell: "pip install requests flask fastapi django"
      - shell: "pip install pytest black isort flake8"
      
  - name: Go
    description: "Go programming language"
    category: "Programming Languages"
    install_method: mise
    install_command: go@1.21.6     # Pin Go version for stability
    default: true
    shell_updates:
      - "export GOPATH=$HOME/go"
      - "export PATH=$PATH:$GOPATH/bin"
    post_install:
      - shell: "go install github.com/air-verse/air@latest"
      - shell: "go install github.com/cosmtrek/air@latest"
      - shell: "go install github.com/swaggo/swag/cmd/swag@latest"
      
  - name: Rust
    description: "Rust programming language"
    category: "Programming Languages"
    install_method: mise
    install_command: rust@1.75.0   # Pin Rust version for stability
    default: false
    post_install:
      - shell: "rustup component add clippy rustfmt"
      
  - name: Java
    description: "Java programming language"
    category: "Programming Languages"
    install_method: mise
    install_command: java@openjdk-17
    default: false
    post_install:
      - shell: "echo 'export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))' >> ~/.bashrc"

# Databases
databases:
  - name: postgresql
    description: "Advanced open source database"
    category: "SQL Databases"
    default: true
    service:
      name: postgresql
      enabled: true
      started: true
    post_install:
      - shell: "sudo -u postgres createuser --superuser $USER"
      - shell: "sudo -u postgres createdb $USER"
      
  - name: mysql
    description: "Popular open source database"
    category: "SQL Databases"
    default: false
    service:
      name: mysql
      enabled: true
      started: true
      
  - name: redis
    description: "In-memory data structure store"
    category: "NoSQL Databases"
    default: true
    service:
      name: redis-server
      enabled: true
      started: true
      
  - name: mongodb
    description: "Document-oriented database"
    category: "NoSQL Databases"
    default: false
    service:
      name: mongod
      enabled: true
      started: true
      
  - name: elasticsearch
    description: "Search and analytics engine"
    category: "Search Databases"
    default: false
    service:
      name: elasticsearch
      enabled: true
      started: true
      
  # Database Tools
  - name: pgcli
    description: "PostgreSQL CLI with autocompletion"
    category: "Database Tools"
    default: false
    dependencies: ["postgresql"]
    install_method: pip
    install_command: pgcli
    
  - name: mycli
    description: "MySQL CLI with autocompletion"
    category: "Database Tools"
    default: false
    dependencies: ["mysql"]
    install_method: pip
    install_command: mycli
    
  - name: redis-cli
    description: "Redis command line interface"
    category: "Database Tools"
    default: false
    dependencies: ["redis"]

# Infrastructure and DevOps Tools
infrastructure:
  - name: terraform
    description: "Infrastructure as code"
    category: "Infrastructure"
    default: false
    
  - name: ansible
    description: "IT automation platform"
    category: "Configuration Management"
    default: false
    install_method: pip
    install_command: ansible
    
  - name: vagrant
    description: "Virtual development environments"
    category: "Virtualization"
    default: false
    
  - name: nginx
    description: "HTTP and reverse proxy server"
    category: "Web Servers"
    default: false
    service:
      name: nginx
      enabled: false
      started: false
      
  - name: apache2
    description: "Apache HTTP Server"
    category: "Web Servers"
    default: false
    service:
      name: apache2
      enabled: false
      started: false

# Message Queues and Streaming
messaging:
  - name: rabbitmq
    description: "Message broker"
    category: "Message Queues"
    default: false
    service:
      name: rabbitmq-server
      enabled: true
      started: true
      
  - name: kafka
    description: "Distributed streaming platform"
    category: "Streaming"
    default: false
    
# Environment Configuration
environment:
  shell:
    default_shell: "zsh"
    oh_my_zsh: true
    plugins:
      - "git"
      - "docker"
      - "kubectl"
      - "python"
      - "golang"
      - "node"
      - "npm"
    theme: "powerlevel10k/powerlevel10k"
    
  fonts:
    - name: "JetBrains Mono"
      description: "Programming font with ligatures"
      method: "url"
      url: "https://download.jetbrains.com/fonts/JetBrainsMono-2.304.zip"
      destination: "~/.local/share/fonts/"
      post_install:
        - shell: "fc-cache -fv"

# System Configuration
system:
  git:
    aliases:
      co: "checkout"
      br: "branch"
      ci: "commit"
      st: "status"
      unstage: "reset HEAD --"
      last: "log -1 HEAD"
      visual: "!gitk"
      graph: "log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"
      
    settings:
      - key: "core.editor"
        value: "code --wait"
      - key: "init.defaultBranch"
        value: "main"
      - key: "pull.rebase"
        value: "false"
      - key: "core.autocrlf"
        value: "input"
      - key: "push.default"
        value: "current"
        
  docker:
    config:
      log-driver: "json-file"
      log-opts:
        max-size: "10m"
        max-file: "3"
      storage-driver: "overlay2"
      
  environment_variables:
    EDITOR: "code"
    BROWSER: "firefox"
    TERM: "xterm-256color"
    DOCKER_BUILDKIT: "1"
    COMPOSE_DOCKER_CLI_BUILD: "1"

# Create Express.js project
npx express-generator my-express-app --ejs --git
cd my-express-app
npm install

# Install additional dependencies
npm install --save dotenv cors helmet morgan
npm install --save-dev nodemon jest supertest

# Install monitoring tools
npm install --save express-prometheus-middleware
npm install --save @opentelemetry/api @opentelemetry/node

# Create basic API structure
mkdir -p routes/api controllers middleware

# Start development server
npm run dev

applications:
  development:
    - name: express-tools
      post_install:
        - shell: "npm install -g express-generator"
        - shell: "npm install -g nodemon"

# Create FastAPI project
mkdir my-fastapi-app
cd my-fastapi-app
python -m venv venv
source venv/bin/activate

# Install FastAPI and dependencies
pip install fastapi uvicorn[standard]
pip install sqlalchemy alembic psycopg2-binary
pip install pydantic[email] python-jose[cryptography]
pip install pytest pytest-asyncio httpx

# Create basic app structure
mkdir -p app/{api,core,models,schemas,crud}

# Create main.py
cat > app/main.py << 'EOF'
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware

app = FastAPI(title="My API", version="1.0.0")

app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

@app.get("/")
async def root():
    return {"message": "Hello World"}

@app.get("/health")
async def health_check():
    return {"status": "healthy"}
EOF

# Start development server
uvicorn app.main:app --reload

app/
├── main.py
├── api/
│   ├── __init__.py
│   ├── deps.py
│   └── endpoints/
├── core/
│   ├── config.py
│   ├── security.py
│   └── database.py
├── models/
│   └── __init__.py
├── schemas/
│   └── __init__.py
└── crud/
    └── __init__.py

# Create Go project with Gin
mkdir my-gin-app
cd my-gin-app
go mod init my-gin-app

# Install Gin and dependencies
go get github.com/gin-gonic/gin
go get github.com/gin-contrib/cors
go get github.com/golang-jwt/jwt/v4
go get gorm.io/gorm
go get gorm.io/driver/postgres

# Create main.go
cat > main.go << 'EOF'
package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
    "github.com/gin-contrib/cors"
)

func main() {
    r := gin.Default()
    
    // CORS middleware
    r.Use(cors.Default())
    
    // Routes
    r.GET("/", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "Hello World!",
        })
    })
    
    r.GET("/health", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "status": "healthy",
        })
    })
    
    r.Run(":8080")
}
EOF

# Run the application
go run main.go

my-gin-app/
├── main.go
├── go.mod
├── go.sum
├── handlers/
│   ├── auth.go
│   └── users.go
├── models/
│   └── user.go
├── middleware/
│   └── auth.go
├── config/
│   └── database.go
└── utils/
    └── jwt.go

// swagger.js
const swaggerJSDoc = require('swagger-jsdoc')
const swaggerUi = require('swagger-ui-express')

const options = {
  definition: {
    openapi: '3.0.0',
    info: {
      title: 'My API',
      version: '1.0.0',
      description: 'A backend API service',
    },
    servers: [
      {
        url: 'http://localhost:3000',
        description: 'Development server',
      },
    ],
  },
  apis: ['./routes/*.js', './models/*.js'],
}

const specs = swaggerJSDoc(options)

module.exports = { specs, swaggerUi }

// app.js
const { specs, swaggerUi } = require('./swagger')
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(specs))

// logger.js
const winston = require('winston')

const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || 'info',
  format: winston.format.combine(
    winston.format.timestamp(),
    winston.format.errors({ stack: true }),
    winston.format.json()
  ),
  defaultMeta: { service: 'my-api' },
  transports: [
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }),
    new winston.transports.File({ filename: 'logs/combined.log' }),
  ],
})

if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple()
  }))
}

module.exports = logger