growqr-app/docs
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
docs/REPO_INVENTORY.md
-Puter e6685203fe feat: initial docs repo with project inventory and all documentation 
- Added REPO_INVENTORY.md with all repos, branches, remotes, and staging info
- Added .gitignore
- Synced all existing docs from local workspace
- Centralized documentation hub for GrowQR team
2026-06-22 15:04:27 +05:30

187 lines
9.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
Reference in New Issue View Git Blame Copy Permalink