Commands Overview

Goca provides a comprehensive set of commands to generate Clean Architecture components and manage your project structure.

Command Categories

Project Initialization

• goca init - Initialize a new Clean Architecture project

Complete Features

• goca feature - Generate a complete feature with all layers
• goca integrate - Integrate existing features with DI and routing

Layer-Specific Generation

Domain Layer

• goca entity - Generate domain entities

Application Layer

• goca usecase - Generate use cases and DTOs
• goca interfaces - Generate interface contracts

Infrastructure Layer

• goca repository - Generate repositories

Adapter Layer

• goca handler - Generate handlers (HTTP, gRPC, CLI, etc.)

Utilities

• goca di - Generate dependency injection container
• goca messages - Generate error messages and constants
• goca version - Display version information

Quick Reference

Command	Purpose	Auto-Integration
goca init	Create new project	Complete setup
goca feature	Generate full feature	Automatic
goca integrate	Wire existing features	Automatic
goca entity	Create entities only	Manual
goca usecase	Create use cases only	Manual
goca repository	Create repositories only	Manual
goca handler	Create handlers only	Manual
goca di	Generate DI container	Manual

Common Workflows

Workflow 1: Quick Start (Recommended)

# Initialize project
goca init myproject --module github.com/user/myproject

# Generate complete features
goca feature User --fields "name:string,email:string"
goca feature Product --fields "name:string,price:float64"

# Everything is integrated automatically!
go run cmd/server/main.go

Workflow 2: Layer-by-Layer

# Generate entity
goca entity Order --fields "customer:string,total:float64"

# Generate use case
goca usecase OrderService --entity Order

# Generate repository
goca repository Order --database postgres

# Generate handler
goca handler Order --type http

# Wire everything together
goca integrate --all

Workflow 3: Add to Existing Project

# Generate new feature
goca feature Payment --fields "amount:float64,method:string"

# Automatically integrated with existing features

Global Flags

All commands support these flags:

--help, -h      Show help for command
--verbose, -v   Enable verbose output
--dry-run       Show what would be generated without creating files

Examples by Use Case

Building a REST API

goca init ecommerce-api --module github.com/user/ecommerce
cd ecommerce-api

goca feature Product --fields "name:string,price:float64,stock:int"
goca feature Order --fields "customer:string,total:float64,status:string"
goca feature User --fields "name:string,email:string,role:string"

Building a Microservice

goca init payment-service --module github.com/user/payment
cd payment-service

goca feature Payment --fields "amount:float64,currency:string,status:string"
goca handler Payment --type grpc
goca handler Payment --type http

Building a CLI Tool

goca init data-processor --module github.com/user/processor
cd data-processor

goca feature DataProcessor --fields "input:string,output:string"
goca handler DataProcessor --type cli

Next Steps

Choose a command to learn more:

Essential Commands

• goca init - Start here
• goca feature - Fastest way to add features
• goca integrate - Wire everything together

Detailed Generation

• 🟡 goca entity - Domain layer
• 🔴 goca usecase - Application layer
• 🔵 goca repository - Infrastructure layer
• 🟢 goca handler - Adapter layer

Utilities

• goca di - Dependency injection
• 📝 goca messages - Messages and constants
• goca version - Version info