GitHub Actions Workflows

The DashClicks Back-End repository uses GitHub Actions for comprehensive CI/CD automation, including testing, linting, Docker image building, coverage reporting, and deployment workflows. All workflows are located in .github/workflows/ and provide automated quality assurance and deployment capabilities.

📋 Workflow Overview

The repository contains 7 workflows for CI/CD automation:

🏗️ Build & Deployment

• build.docker.yaml - Multi-service Docker image builder
• common.docker.yaml - Reusable Docker build workflow template
• tag-trigger.yaml - Version tag deployment trigger

🧪 Testing & Quality

• unit-tests.yml - Node.js and Deno test runner
• lint-check.yaml - Code quality validation
• generate-coverage.yaml - Coverage reporting and badge generation

🔔 Notifications

• pr-review-reminder.yaml - PR review notifications

🔄 Workflow Triggers

Workflow	Trigger Events	Services Affected	Purpose
Docker Build	Manual dispatch, Workflow call	12 microservices	Container image building
Unit Tests	Pull requests, Manual dispatch	Node.js & Deno	Test execution
Lint Check	Pull requests	Changed files	Code quality validation
Coverage	Push to prod branch	All services	Coverage reporting
Tag Trigger	Version tags (v*)	All services	Production deployment
PR Reminder	PR opened/reopened	N/A	Team notifications
Common Docker	Called by other workflows	Individual services	Reusable build template

🏗️ Services Supported

Workflows support 12 microservices:

API Services

• api-internal - Internal business logic
• api-external - Third-party integrations
• api-ai - AI service (Deno-based)

Gateway & Communication

• dashboard-gateway - Frontend proxy
• socket-conversation - Real-time messaging
• socket-general - General real-time events

Background Processing

• queue-manager-general - Background jobs
• queue-manager-puppeteer - Browser automation
• notifications - Email/SMS notifications

Utilities

• callrail-proxy - CallRail API proxy
• currency-converter - Currency conversion
• misc-proxy - General proxy service

🛠️ Technology Stack

Node.js Services (11 services)

• Testing: Jest with MongoDB Memory Server 6.0.9
• Linting: ESLint with JSON output
• Build: Docker with shared file copying
• Dependencies: pnpm/npm with caching

Deno Service (1 service - AI)

• Testing: Deno test runner with coverage
• Linting: Deno lint, format, and type checking
• Build: Deno Docker builds

🔧 Infrastructure Configuration

Docker Registry

gcr.io/dash-208313/dashclicks-[env]-[service]

Environment Types

• Development: Feature branch builds
• Staging: Custom tag deployments
• Production: Version tag releases

Caching Paths

• Node.js: ~/.pnpm, ~/.npm
• MongoDB: /tmp/mongodb-binaries
• Docker: Registry layer caching

📊 Validation Requirements

Pre-merge Checks

1. Lint Check: ESLint errors block execution
2. Unit Tests: Jest and Deno test execution
3. Type Safety: Deno TypeScript validation
4. Coverage: 40% branch, 50% function minimum

Automated Outputs

• PR Comments: Test and lint results with collapsible sections
• Coverage Badges: SVG badge updates to .github/coverage.svg
• Webhook Notifications: Discord/Slack PR notifications
• Artifacts: 7-14 day retention for test results

🚀 Execution Flows

Pull Request Flow

PR Creation → Lint Check → Unit Tests → Review

Production Flow

Version Tag → Docker Build → Image Push → Draft Release

📋 Workflow Documentation

Build & Deployment

• build.docker.yaml - Multi-service Docker image builder
• common.docker.yaml - Reusable Docker build template
• tag-trigger.yaml - Version tag deployment trigger

Testing & Quality

• unit-tests.yml - Node.js and Deno test runner
• lint-check.yaml - Code quality validation
• generate-coverage.yaml - Coverage reporting and badges

Notifications

• pr-review-reminder.yaml - PR review notifications

🔧 Required Configuration

Repository Variables

PR_REMINDER_WEBHOOK_URL: Team notification webhook

Repository Secrets

GKE_SA_KEY: Google Cloud service account key
GKE_PROJECT: Google Cloud project ID
PACKAGE_TOKEN: GitHub Packages authentication
COVERAGE_GENERATE_TOKEN: Coverage badge update token
GITHUB_TOKEN: Automatic GitHub API access

📈 Technical Specifications

Runtime Requirements

• Node.js: Version 18 and 20 support
• Deno: Version 2.1.7
• MongoDB: Memory Server 6.0.9
• Chrome: Latest for Puppeteer tests

Coverage Thresholds

• Branch Coverage: 40% minimum
• Function Coverage: 50% minimum
• Line Coverage: 50% minimum
• Statement Coverage: 50% minimum

---

🔗 Related Documentation

• Service Documentation - Individual service details
• Common Documentation - Shared infrastructure