# GrowQR Repository Inventory

> Last updated: 2026-06-22
> This document catalogs every repository, branch, and remote in the GrowQR ecosystem.

---

## 📍 Quick Links

| Platform | Org | URL |
|---|---|---|
| **Gitea (Primary)** | `growqr-app` | https://git.openputer.com/growqr-app |
| **Gitea (Legacy)** | `puter` | https://git.openputer.com/puter |
| **GitHub** | `GrowQR-Code` | https://github.com/GrowQR-Code |
| **GitHub** | `Growqr-org` | https://github.com/Growqr-org |
| **GitHub** | `Prmsnls` | https://github.com/Prmsnls |
| **Docs** | `growqr-app/docs` | https://git.openputer.com/growqr-app/docs |
| **Linear** | `PRM` team | https://linear.app/prmsnls/team/PRM |

---

## 🟢 Active Repositories (In Development)

### 1. `growqr-backend` — Main API Backend
| | |
|---|---|
| **Description** | Core backend API: auth, users, missions, agents, events, orchestration, QScore integration |
| **Stack** | Node.js / TypeScript / Drizzle ORM / RivetKit / Express / tRPC |
| **Canonical Remote** | `https://git.openputer.com/puter/growqr-backend.git` |
| **Staging Branch** | **`staging-rosh`** ← active development |
| **Production Branch** | `main` |
| **Other Branches** | `staging`, `chore/release`, `service-rest-events`, `subagents-microservice`, `checkpoint/pre-mission-actions-20260606-031159` |
| **Mirror** | `https://github.com/GrowQR-Code/growqr-backend` (if exists) |
| **VPS Deploy** | `gqr-temp` (`/opt/growqr/growqr-backend`) |
| **Linear Issues** | PRM-41, PRM-42, PRM-63–69 |

### 2. `growqr-dashboard` — Next.js Dashboard Frontend
| | |
|---|---|
| **Description** | Main user-facing dashboard: home, onboarding, missions, agents, QScore, analytics |
| **Stack** | Next.js 14 / React / TypeScript / Tailwind / shadcn |
| **Canonical Remote** | `https://git.openputer.com/puter/growqr-dashboard.git` |
| **Secondary Remote** | `dashboard-ui` → `https://github.com/GrowQR-Code/dashboard-ui.git` |
| **Staging Branch** | **`staging-rosh`** ← active development |
| **Production Branch** | `main` |
| **Other Branches** | `staging`, `prd-new-ui`, `dashboard-ui-mission-rebrand`, `backup/mission-action-queue-ui-20260605`, `checkpoint/pre-mission-actions-20260606-031159` |
| **VPS Deploy** | `gqr-temp` (`/opt/growqr/growqr-dashboard`) |
| **Linear Issues** | PRM-36, PRM-48, PRM-49, PRM-52, PRM-55, PRM-56–62 |

### 3. `interview-service` — AI Interview Agent
| | |
|---|---|
| **Description** | Voice + text interview practice with AI avatars, LiveAvatar integration, scoring |
| **Stack** | Node.js / Python / FastAPI / WebSocket / LiveAvatar API |
| **Canonical Remote** | `gitea` → `https://git.openputer.com/growqr-app/interview-service.git` |
| **GitHub Remote** | `origin` → `https://github.com/GrowQR-Code/interview-service.git` |
| **Staging Branch** | **`staging`** |
| **Production Branch** | `main` |
| **Other Branches** | `dashboard-service-rest-integration`, `pr-1`, `pr-1-updated`, `q-score` |
| **VPS Deploy** | `gqr-temp` (port 18007) |
| **Linear Issues** | PRM-50 |

### 4. `roleplay-service` — AI Roleplay Agent
| | |
|---|---|
| **Description** | Roleplay scenarios for job prep, behavioral interviews, negotiation practice |
| **Stack** | Node.js / Python / FastAPI / WebSocket |
| **Canonical Remote** | `gitea` → `https://git.openputer.com/growqr-app/roleplay-service.git` |
| **GitHub Remote** | `origin` → `https://github.com/GrowQR-Code/roleplay-service.git` |
| **Staging Branch** | **`staging`** |
| **Production Branch** | `main` |
| **Other Branches** | `dashboard-service-rest-integration`, `feat/planning-edit-leaderboard-demo`, `pr-1-updated` |
| **VPS Deploy** | `gqr-temp` (port 18008) |
| **Linear Issues** | PRM-50 |

### 5. `qscore_service` — QScore Calculation Engine
| | |
|---|---|
| **Description** | QX Score computation, origination events, score delivery, analytics pipeline |
| **Stack** | Python / FastAPI / UV |
| **Canonical Remote** | `gitea` → `https://git.openputer.com/puter/qscore-service.git` |
| **GitHub Remotes** | `origin` → `https://github.com/GrowQR-Code/qscore-service.git`, `github` → `https://github.com/Prmsnls/QScore-service.git` |
| **Staging Branch** | **`staging`** |
| **Production Branch** | `main` |
| **Other Branches** | `admin-ui`, `feature/quotients-from-pillars` |
| **VPS Deploy** | `gqr-temp` (port 18009) |
| **Linear Issues** | PRM-45, PRM-69 |

### 6. `growqr-app` — Legacy Monorepo (Partial)
| | |
|---|---|
| **Description** | Legacy monorepo containing dashboard-service, frontend, orchestrator, resume-builder, user-service, social-branding, nginx, scripts |
| **Stack** | Mixed (Next.js, Node.js, Python) |
| **Canonical Remote** | `gitea` → `https://git.openputer.com/growqr-app/growqr-app.git` |
| **GitHub Remote** | `origin` → `https://github.com/GrowQR-Code/growqr-app` |
| **Staging Branch** | **`staging`** |
| **Production Branch** | `main` |
| **Other Branches** | `dashboard-service-rest-integration`, `migration/legacy-to-contract`, `pr-1` |
| **Subdirectories** | `dashboard-service`, `frontend`, `orchestrator`, `resume-builder`, `user-service`, `social-branding`, `nginx`, `scripts` |
| **Linear Issues** | PRM-41, PRM-42, PRM-46 |

### 7. `agent-social-branding` — Social Branding Agent
| | |
|---|---|
| **Description** | LinkedIn content generation, brand score, personal branding pipeline |
| **Stack** | Python / FastAPI |
| **Canonical Remote** | `gitea` → `https://git.openputer.com/growqr-app/agent-social-branding.git` |
| **GitHub Remote** | `origin` → `https://github.com/Growqr-org/agent-social-branding` |
| **Active Branch** | **`main`** |
| **Other Branches** | `feature-update`, `handoff-phase-1` |
| **Linear Issues** | PRM-70 |

### 8. `docs` — Project Documentation (This Repo)
| | |
|---|---|
| **Description** | Central documentation hub: runbooks, architecture, PRDs, playbooks, meeting notes |
| **Canonical Remote** | `https://git.openputer.com/growqr-app/docs.git` |
| **Active Branch** | **`main`** |

---

## 🟡 Archived / Deferred Repositories

> Located in `/archived/`. These are not actively deployed but retain code history.

| Repo | Description | Gitea Remote | GitHub Remote | Active Branch |
|---|---|---|---|---|
| `assessment-service` | Skills assessment & quiz engine | `growqr-app/assessment-service` | `GrowQR-Code/assessments` | `feature/autocourse-pipeline` |
| `courses_service` | Course content & video delivery | `growqr-app/courses_service` | `GrowQR-Code/courses` | `feature/autocourse-pipeline` |
| `growqr-next-frontend` | Earlier Next.js dashboard iteration | `puter/growqr-next-frontend` | `GrowQR-Code/workflows--dashboard` | `main` |
| `marketplace-service` | Job marketplace / gig board | `growqr-app/marketplace-service` | `GrowQR-Code/marketplace` | `main` |
| `matchmaking-service` | Job-candidate matching engine | `growqr-app/matchmaking-service` | `GrowQR-Code/matchmaking` | `main` / `feat/matchmaking-scraping` |
| `pathways-service` | Career pathway recommendations | `growqr-app/pathways-service` | `GrowQR-Code/pathways` | `main` / `pr-1-review` |

---

## 🌐 Staging Environment (VPS `gqr-temp`)

| Service | Local Port | Public URL | Docker Project |
|---|---|---|---|
| Dashboard | 13000 | `https://dashboard-staging.gqr.puter.wtf` | `growqr-dashboard-staging` |
| Backend API | 18012 | `https://backend-staging.gqr.puter.wtf` | `growqr-backend-staging` |
| Backend Gitea | 13001 | `https://backend-gitea-staging.gqr.puter.wtf` | `growqr-backend-staging` |
| Interview Service | 18007 | `https://interview-staging.gqr.puter.wtf` | `interview-service-staging` |
| Roleplay Service | 18008 | `https://roleplay-staging.gqr.puter.wtf` | `roleplay-service-staging` |
| QScore Service | 18009 | `https://qscore-staging.gqr.puter.wtf` | `qscore-service-staging` |
| Resume Builder | 18010 | `https://resume-staging.gqr.puter.wtf` | `resume-builder-staging` |
| User Service | 18011 | `https://user-staging.gqr.puter.wtf` | `user-service-staging` |
| Rivet Engine | 16420–21 | Internal | `growqr-backend-staging` |

**VPS IP:** `168.144.123.127` (Debian 13)  
**Deploy Root:** `/opt/growqr/`  
**Caddyfile:** `/etc/caddy/Caddyfile`

---

## 🏷️ Branch Naming Conventions

| Prefix | Meaning |
|---|---|
| `main` | Production-ready code |
| `staging` | Pre-production integration branch |
| `staging-rosh` | **Active feature development branch** (backend + dashboard) |
| `feat/*` | Feature branches |
| `chore/*` | Maintenance / tooling |
| `checkpoint/*` | Pre-change snapshots with timestamp |
| `backup/*` | Manual backup branches |
| `migration/*` | Legacy-to-new migration work |

---

## 🔄 Sync Workflow

1. **Local dev** → commit to `staging-rosh` (backend/dashboard) or `staging` (services)
2. **Push** to Gitea origin
3. **VPS** pulls via Git credential store (`~/.git-credentials`)
4. **Docker compose** restart on VPS for deploy
5. **No SCP/tar** — all sync is Git-based

---

## 📋 Related Linear Resources

- **Team:** PRM (Prmsnls)
- **Project:** [GrowQR](https://linear.app/prmsnls/project/growqr)
- **Current Sprint Issues:** PRM-56 through PRM-70
- **Members:** puter, divyansh242805, karthiksaiketha, kirti