Deployment & Infrastructure

Container Deployment

Docker Configuration

Multi-stage build for optimization
Node.js 18+ runtime
Production-ready configuration
Health check integration

Google Cloud Run

Serverless deployment
Automatic scaling
Environment variable configuration
Public endpoint access

CI/CD Pipeline

GitHub Actions

Automated testing
Docker image building
Google Cloud deployment
Environment-specific deployments

Deployment Strategy

Branch	Environment
`develop`	Development
`main`	Production

Automated releases with commit SHA tagging.

Monitoring & Logging

Logging

Structured logging with Winston
Request/response tracking
Error monitoring
Performance metrics

Health Monitoring

Health check endpoint
Database connectivity monitoring
External service status tracking

Configuration

Required Environment Variables

Application:

PORT=8080
ENV=development

Database:

DATABASE_URL=postgresql://user:password@host:port/database
PGSSLMODE=require

AI Services:

ANTHROPIC_API_KEY=your-anthropic-key
OPENAI_API_KEY=your-openai-key

Slack Integration:

SLACK_CLIENT_ID=your-client-id
SLACK_CLIENT_SECRET=your-client-secret
SLACK_REDIRECT_URI=https://your-domain.com/slack/oauth/callback
SLACK_SCOPES=chat:write,users:read,users:read.email,channels:read,im:read,im:write,files:read

Teams Integration:

TEAMS_APP_ID=your-app-id
TEAMS_APP_SECRET=your-app-secret

MCP Integration:

MCP_SERVER_URL=https://your-mcp-server.com

Authentication:

JWT_SECRET=your-jwt-secret

Storage:

GOOGLE_CLOUD_STORAGE_BUCKET=your-bucket-name
GOOGLE_APPLICATION_CREDENTIALS=path/to/service-account.json

Commercial API:

COMMERCIAL_API_URL=https://commercial-api-dev.credplatform.com/graphql

Development Setup

Prerequisites

Node.js 18+
PostgreSQL 13+
Google Cloud account
Slack workspace
Microsoft Teams tenant

Installation

git clone <repository>
cd cred-agent-ai
npm install
cp .env.example .env
# Configure environment variables
npm run start:dev

Database Setup

Run migrations
Configure connection string
Set up SSL if required

Platform Configuration

Configure Slack app in developer portal
Set up Teams bot in Azure
Configure OAuth redirects