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

9.0 KiB
Raw Permalink Blame History

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
  • Current Sprint Issues: PRM-56 through PRM-70
  • Members: puter, divyansh242805, karthiksaiketha, kirti