# 🔄 CI/CD Visual Workflow

## Complete Development to Production Pipeline

```
┌─────────────────────────────────────────────────────────────────────────┐
│                         DEVELOPMENT WORKFLOW                              │
└─────────────────────────────────────────────────────────────────────────┘

┌──────────────┐
│  Developer   │
│ Local Machine│
└──────┬───────┘
       │
       │ 1. Create feature branch
       ↓
┌──────────────────┐
│ feat/new-feature │
└──────┬───────────┘
       │
       │ 2. Make changes, commit with `npm run commit`
       │    (Conventional format: feat(api): add endpoint)
       ↓
┌──────────────────┐
│  Push to GitHub  │
└──────┬───────────┘
       │
       │ 3. Create Pull Request
       ↓
       │
       ├─────────────────────────────────────────────────────────────┐
       │                                                               │
       │           ┌──────────────────────────────────────┐          │
       │           │      DRONE CI - TEST PIPELINE        │          │
       │           │     (.drone.yml - test)              │          │
       │           └────────────┬─────────────────────────┘          │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Install Dependencies     │                      │
       │           │  npm ci                   │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Run Tests               │                      │
       │           │  npm test (11 tests)     │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Lint Commits            │                      │
       │           │  commitlint validation   │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │                        ✅ PASS / ❌ FAIL                     │
       │                                                               │
       └───────────────────────────────────────────────────────────────┘
       │
       ├─────────────────────────────────────────────────────────────┐
       │                                                               │
       │           ┌──────────────────────────────────────┐          │
       │           │   DRONE CI - PR LINT PIPELINE        │          │
       │           │  (.drone-pr-lint.yml)                │          │
       │           └────────────┬─────────────────────────┘          │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Lint PR Title           │                      │
       │           │  (feat(api): ...)        │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Lint All Commits        │                      │
       │           │  (conventional format)   │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │                        ✅ PASS / ❌ FAIL                     │
       │                                                               │
       └───────────────────────────────────────────────────────────────┘
       │
       │ 4. Code review & approval
       ↓
┌──────────────────┐
│  Merge to main   │
└──────┬───────────┘
       │
       │
       ├─────────────────────────────────────────────────────────────┐
       │                                                               │
       │           ┌──────────────────────────────────────┐          │
       │           │  DRONE CI - AUTO RELEASE PIPELINE    │          │
       │           │  (.drone-release.yml)                │          │
       │           └────────────┬─────────────────────────┘          │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Analyze Commits         │                      │
       │           │  (since last tag)        │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Determine Version       │                      │
       │           │  feat → MINOR            │                      │
       │           │  fix → PATCH             │                      │
       │           │  BREAKING → MAJOR        │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Run standard-version    │                      │
       │           │  • Bump package.json     │                      │
       │           │  • Update CHANGELOG.md   │                      │
       │           │  • Create git tag        │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Push Tag to GitHub      │                      │
       │           │  (triggers deployment)   │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │                        📦 Version: v1.1.0                    │
       │                                                               │
       └───────────────────────────────────────────────────────────────┘
       │
       │ Tag pushed (v1.1.0)
       ↓
       │
       ├─────────────────────────────────────────────────────────────┐
       │                                                               │
       │           ┌──────────────────────────────────────┐          │
       │           │  DRONE CI - BUILD & DEPLOY PIPELINE  │          │
       │           │  (.drone.yml - build-and-deploy)     │          │
       │           └────────────┬─────────────────────────┘          │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Install Dependencies     │                      │
       │           │  npm ci                   │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Run Tests               │                      │
       │           │  (validation)            │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Build & Prepare Files   │                      │
       │           │  • server.js             │                      │
       │           │  • package.json          │                      │
       │           │  • routes/, middleware/  │                      │
       │           │  • services/, utils/     │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Copy to Server (SCP)    │                      │
       │           │  → /var/www/pulse-server │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Install Prod Dependencies│                      │
       │           │  npm ci --only=production│                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Health Check (Before)   │                      │
       │           │  pm2 describe pulse-server│                     │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  PM2 Reload              │                      │
       │           │  (Zero-downtime)         │                      │
       │           │  • Stop instance 1       │                      │
       │           │  • Start new instance 1  │                      │
       │           │  • Stop instance 2       │                      │
       │           │  • Start new instance 2  │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Health Check (After)    │                      │
       │           │  • curl /health          │                      │
       │           │  • pm2 logs (20 lines)   │                      │
       │           │  • pm2 describe          │                      │
       │           └────────────┬─────────────┘                      │
       │                        │                                      │
       │           ┌────────────▼─────────────┐                      │
       │           │  Send Notification       │                      │
       │           │  📱 Telegram             │                      │
       │           │  ✅ Success / ❌ Failure │                      │
       │           └─────────────────────────┘                       │
       │                                                               │
       └───────────────────────────────────────────────────────────────┘
       │
       │ Deployment complete
       ↓
┌────────────────────┐
│   PRODUCTION       │
│   /var/www/        │
│   pulse-server     │
│                    │
│   PM2 Cluster:     │
│   • Instance 1 ✅  │
│   • Instance 2 ✅  │
│                    │
│   Health: ✅       │
│   Port: 3000       │
└────────────────────┘
```

## Pipeline States & Triggers

```
┌──────────────────────────────────────────────────────────────────────┐
│                         EVENT TRIGGERS                                │
└──────────────────────────────────────────────────────────────────────┘

Event                    │ Pipeline              │ File
─────────────────────────┼───────────────────────┼──────────────────────
PR Created/Updated       │ Test + PR Lint        │ .drone.yml +
                         │                       │ .drone-pr-lint.yml
─────────────────────────┼───────────────────────┼──────────────────────
Push to main (PR merge)  │ Auto-Release          │ .drone-release.yml
─────────────────────────┼───────────────────────┼──────────────────────
Tag Pushed (v*.*.*)      │ Release + Deploy      │ .drone.yml
─────────────────────────┼───────────────────────┼──────────────────────
Push to develop          │ Deploy to Staging     │ .drone.yml
```

## Version Bump Logic

```
┌──────────────────────────────────────────────────────────────────────┐
│                      VERSION DETERMINATION                            │
└──────────────────────────────────────────────────────────────────────┘

Commit Type             │ Version Bump          │ Example
────────────────────────┼───────────────────────┼──────────────────────
feat(scope): ...        │ MINOR (x.Y.z)         │ 1.0.0 → 1.1.0
────────────────────────┼───────────────────────┼──────────────────────
fix(scope): ...         │ PATCH (x.y.Z)         │ 1.0.0 → 1.0.1
────────────────────────┼───────────────────────┼──────────────────────
BREAKING CHANGE: ...    │ MAJOR (X.y.z)         │ 1.0.0 → 2.0.0
────────────────────────┼───────────────────────┼──────────────────────
docs, chore, style      │ NONE                  │ No version bump
────────────────────────┼───────────────────────┼──────────────────────
perf(scope): ...        │ PATCH (x.y.Z)         │ 1.0.0 → 1.0.1
```

## PM2 Process Flow

```
┌──────────────────────────────────────────────────────────────────────┐
│                      PM2 CLUSTER MODE                                 │
└──────────────────────────────────────────────────────────────────────┘

                    ┌─────────────────┐
                    │   Load Balancer │
                    │   (PM2 Master)  │
                    └────────┬────────┘
                             │
                ┌────────────┴────────────┐
                │                         │
       ┌────────▼────────┐       ┌───────▼─────────┐
       │   Instance 1    │       │   Instance 2    │
       │   Port: 3000    │       │   Port: 3000    │
       │   PID: 12345    │       │   PID: 12346    │
       └─────────────────┘       └─────────────────┘
                │                         │
                └────────────┬────────────┘
                             │
                    ┌────────▼────────┐
                    │  Health Monitor │
                    │  (Every 30s)    │
                    └─────────────────┘

Reload Process (Zero-Downtime):
1. Instance 2 continues serving ───┐
2. Stop Instance 1                 │
3. Start new Instance 1            │ Traffic served
4. Wait for ready signal           │ by Instance 2
5. Health check Instance 1     ────┘
6. Instance 1 serves traffic   ───┐
7. Stop Instance 2                 │
8. Start new Instance 2            │ Traffic served
9. Wait for ready signal           │ by Instance 1
10. Health check Instance 2    ────┘
11. Both instances serving     ────── Normal operation
```

## Health Check Flow

```
┌──────────────────────────────────────────────────────────────────────┐
│                      HEALTH CHECK PROCESS                             │
└──────────────────────────────────────────────────────────────────────┘

Before Deployment:
┌─────────────────┐
│ Check PM2 Status│
│ pm2 describe    │
└────────┬────────┘
         │
         ↓
┌─────────────────┐
│ Current Version │
│ Uptime, Memory  │
└─────────────────┘

After Deployment:
┌─────────────────┐
│ Wait 5 seconds  │
│ (app startup)   │
└────────┬────────┘
         │
         ↓
┌─────────────────┐
│ Check PM2 Status│
│ pm2 describe    │
└────────┬────────┘
         │
         ↓
┌─────────────────┐
│ Review Logs     │
│ pm2 logs --20   │
└────────┬────────┘
         │
         ↓
┌─────────────────┐
│ Test /health    │
│ curl localhost  │
└────────┬────────┘
         │
         ├──── ✅ Status 200 ────→ SUCCESS
         │
         └──── ❌ Non-200 ────────→ FAILURE
                                     │
                                     ↓
                              ┌──────────────┐
                              │ Auto-restart │
                              │ (Max 10x)    │
                              └──────────────┘
```

## File Distribution

```
┌──────────────────────────────────────────────────────────────────────┐
│                      FILES DEPLOYED TO SERVER                         │
└──────────────────────────────────────────────────────────────────────┘

/var/www/pulse-server/
├── server.js                    ✅ Main entry point
├── package.json                 ✅ Dependencies manifest
├── package-lock.json            ✅ Locked versions
├── .env.production              ✅ Environment variables
├── ecosystem.config.js          ✅ PM2 configuration
├── routes/
│   ├── api.js                   ✅ Main API router
│   ├── ai.js                    ✅ AI endpoints
│   ├── enrichment.js            ✅ Repository analysis
│   └── github.js                ✅ GitHub data
├── middleware/
│   └── index.js                 ✅ Custom middleware
├── services/
│   ├── openRouterService.js     ✅ AI service
│   └── githubService.js         ✅ GitHub service
├── utils/
│   └── index.js                 ✅ Utilities
├── logs/
│   ├── error.log                📝 Error logs
│   └── out.log                  📝 Output logs
└── node_modules/                📦 Production dependencies

❌ NOT DEPLOYED:
├── .git/                        (Git repository)
├── tests/                       (Test files)
├── docs/                        (Documentation)
├── .drone.yml                   (CI config)
└── devDependencies              (Dev packages)
```

## Notification Flow

```
┌──────────────────────────────────────────────────────────────────────┐
│                      TELEGRAM NOTIFICATIONS                           │
└──────────────────────────────────────────────────────────────────────┘

Pipeline Event       │ Notification Type │ Content
─────────────────────┼───────────────────┼──────────────────────────
Deployment Success   │ ✅ Success        │ Repo, branch, commit,
                     │                   │ author, message
─────────────────────┼───────────────────┼──────────────────────────
Deployment Failure   │ ❌ Failure        │ Repo, branch, commit,
                     │                   │ author, error details
─────────────────────┼───────────────────┼──────────────────────────
New Release Created  │ 🎉 Release        │ Tag, version, author
─────────────────────┼───────────────────┼──────────────────────────
PR Lint Failed       │ ❌ Lint Error     │ PR number, title,
                     │                   │ validation errors
```

## Timeline Example

```
┌──────────────────────────────────────────────────────────────────────┐
│                    TYPICAL DEPLOYMENT TIMELINE                        │
└──────────────────────────────────────────────────────────────────────┘

Time    │ Event                          │ Duration │ Status
────────┼────────────────────────────────┼──────────┼────────────────
00:00   │ PR Created                     │ -        │ Triggered
00:01   │ Test Pipeline Started          │ ~2 min   │ Running
00:03   │ Tests Complete ✅              │ -        │ Passed
00:03   │ PR Lint Started                │ ~30 sec  │ Running
00:04   │ PR Lint Complete ✅            │ -        │ Passed
00:05   │ Code Review                    │ ~10 min  │ Manual
00:15   │ PR Merged to main              │ -        │ Merged
00:15   │ Auto-Release Started           │ ~1 min   │ Running
00:16   │ Version Bumped (v1.1.0)        │ -        │ Complete
00:16   │ Tag Pushed                     │ -        │ Triggered
00:16   │ Deploy Pipeline Started        │ ~3 min   │ Running
00:17   │ Build Complete                 │ ~30 sec  │ Complete
00:17   │ Files Copied to Server         │ ~20 sec  │ Complete
00:18   │ Dependencies Installed         │ ~1 min   │ Complete
00:19   │ PM2 Reload                     │ ~10 sec  │ Complete
00:19   │ Health Checks                  │ ~10 sec  │ Passed ✅
00:19   │ Notification Sent 📱           │ -        │ Complete
────────┼────────────────────────────────┼──────────┼────────────────
Total:  │ From PR to Production          │ ~19 min  │ SUCCESS ✅
```

---

**This visual workflow represents the complete CI/CD pipeline for Pulse Server.**