Getting Started

This guide will help you set up the development environment and start working on the GitiNext backend.

📋 Prerequisites

Required:

  • Go 1.25+ - Download
  • Docker - Install
  • Docker Compose - Usually included with Docker
  • Git - Version control
  • PostgreSQL 15 (or via Docker)
  • Redis 7 (or via Docker)
  • GoLand or VS Code - IDE with Go support
  • buf - Protocol buffer tooling
  • psql - PostgreSQL client
  • Redis CLI - Redis client

🚀 Quick Start (5 minutes)

Step 1: Clone the Repository

cd /opt/cryptotel/enterprise/stacks/gitinext
git clone <repository-url> gitinext-golang
cd gitinext-golang

Step 2: Install Dependencies

# Initialize Go workspace
go work sync

# Download all dependencies
go mod download

# Install buf for protobuf
go install github.com/bufbuild/buf/cmd/buf@latest

Step 3: Start Infrastructure

# Start database and cache
docker-compose up -d postgres redis minio

# Wait for PostgreSQL to be ready
sleep 5

# Run migrations
cd services/wallet && go run cmd/migrator/main.go
cd ../..

Step 4: Run a Service

# Run wallet service
cd services/wallet
go run cmd/server/main.go

# In another terminal, run gateway
cd services/gateway
go run cmd/main.go

Step 5: Test the Service

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

# Create a test wallet (via gRPC or HTTP)
curl -X POST http://localhost:7080/api/v1/wallet/hd \
  -H "Content-Type: application/json" \
  -d '{
    "telegram_id": "123456789",
    "network": "TON",
    "wallet_type": "internal"
  }'

📁 Project Structure

gitinext-golang/
├── docs/                          # Documentation (you are here!)
├── services/                      # Microservices
│   ├── gateway/                   # API gateway (HTTP/gRPC)
│   ├── wallet/                    # Wallet service
│   ├── watcher/                   # Blockchain watchers
│   ├── account/                   # User accounts
│   ├── market/                    # Market data
│   ├── transaction/               # Transactions
│   ├── payment/                   # Payment gateways
│   ├── voucher/                   # Voucher systems
│   ├── support/                   # Support tickets
│   └── kyc/                       # KYC verification
├── packages/                      # Shared libraries
│   ├── logger/                    # Logging
│   ├── metrics/                   # Prometheus metrics
│   ├── database/                  # DB helpers
│   ├── errors/                    # Error handling
│   └── ...
├── shared-schema/                 # Protobuf definitions
│   ├── proto/                     # .proto files
│   └── proto-gen/go/              # Generated Go code
├── gitibot-back-main/             # Legacy Node.js (reference)
├── docker-compose.yaml            # Local development
└── Makefile                       # Build commands

🛠️ Development Workflow

Daily Workflow:

# 1. Pull latest changes
git pull origin main

# 2. Update dependencies
go mod download

# 3. Work on your feature/service
cd services/wallet
vim internal/wallet/service/signer/ton_signer.go

# 4. Run tests
go test ./...

# 5. Run service locally
go run cmd/server/main.go

# 6. Check logs
tail -f /var/log/wallet-service.log

# 7. Commit changes
git add .
git commit -m "Task 0.1: Implement TON signer"
git push

🧪 Testing

Run All Tests:

# From project root
make test

# Or manually
cd services/wallet && go test ./...

Run Specific Tests:

go test -v -run TestTONSigner ./internal/wallet/service/signer/

Integration Tests:

# Requires running services
make test-integration

🐳 Docker Development

Start All Services:

docker-compose up -d

View Logs:

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f wallet

Rebuild Service:

docker-compose up -d --build wallet

Stop Everything:

docker-compose down

📊 Database Management

Access Database:

# Via Docker
docker-compose exec postgres psql -U postgres -d wallet_core

# Direct connection
psql -h localhost -p 5432 -U postgres -d wallet_core

Run Migrations:

cd services/wallet
go run cmd/migrator/main.go

View Tables:

-- List all tables
\dt

-- Describe table
\d wallets

-- View indexes
\di

🔍 Debugging

Enable Debug Logging:

export LOG_LEVEL=debug
go run cmd/server/main.go

Use pprof for Profiling:

# Service exposes pprof on port 6060
go tool pprof http://localhost:6060/debug/pprof/heap

Check Metrics:

# Prometheus metrics
curl http://localhost:9092/metrics

📖 Next Steps

For New Developers:

  1. ✅ Read Architecture Overview
  2. ✅ Understand Database Schema
  3. ✅ Follow First Service Tutorial
  4. ✅ Check Migration Tasks

For Migration Work:

  1. ✅ Read Migration Overview
  2. ✅ Check current Phase Status
  3. ✅ Pick a task from Task Breakdown
  4. ✅ Follow implementation guide for that phase

For Feature Development:

  1. ✅ Read service guide (e.g., Wallet Service)
  2. ✅ Check API Reference for endpoints
  3. ✅ Write tests first (TDD)
  4. ✅ Implement feature
  5. ✅ Update documentation

🆘 Getting Help

Documentation:

  • Check relevant guide in /docs
  • Search issues on GitHub
  • Read inline code comments

Team Communication:

  • Slack: #gitinext-backend channel
  • Daily standup: 10:00 AM
  • Code review: GitHub PRs

Useful Commands:

# Search codebase
grep -r "functionName" services/

# Find usages
go list -f '{{.Dir}}' -m github.com/gitinext/gitinext-golang/...

# Format code
gofmt -w .

# Lint
golangci-lint run

💡 Tips & Best Practices

Do:

  • ✅ Write tests for all new code
  • ✅ Use shared packages (logger, metrics, database)
  • ✅ Handle errors properly (don’t ignore them)
  • ✅ Add context to all service methods
  • ✅ Use connection pools (don’t dial per request)
  • ✅ Add Prometheus metrics
  • ✅ Update documentation

Don’t:

  • ❌ Hardcode values (use config/env vars)
  • ❌ Log sensitive data (mnemonics, private keys)
  • ❌ Ignore linter warnings
  • ❌ Skip error handling
  • ❌ Use unbounded concurrency
  • ❌ Create per-request database connections

Ready to start coding? Pick a task from the Migration Guide! 🚀

© 2025 GitiNext - Enterprise Crypto Infrastructure | GitHub | Website