Git Repository¶

Repository structure, branches, and commit history

Repository Information¶

Item	Value
Production	`/opt/vitara-platform`
Development	`/home/ubuntu/vitara-platform`
Remote	(local deployment)
Current Branch	main
Last Commit	v3.0.0 (Feb 11, 2026)

Directory Structure¶

vitara-platform/
├── docker-compose.yml           # Docker orchestration
├── .env                         # Environment variables
├── CLAUDE.md                    # Development guidance
│
├── admin-dashboard/             # Main application (TypeScript)
│   ├── server/
│   │   ├── src/
│   │   │   ├── index.ts                  # Express app entry
│   │   │   ├── config/env.ts             # Environment config
│   │   │   ├── services/
│   │   │   │   ├── oscar.service.ts      # OSCAR EMR adapter (X-API-Key)
│   │   │   │   ├── clinic.service.ts     # Clinic management + EMR routing
│   │   │   │   ├── auth.service.ts       # JWT authentication
│   │   │   │   └── provider.service.ts   # Provider management
│   │   │   ├── routes/
│   │   │   │   ├── vapi-webhook.ts       # 14 Vapi tool endpoints
│   │   │   │   ├── api.ts                # Admin REST endpoints
│   │   │   │   └── auth.ts               # Auth endpoints
│   │   │   └── lib/prisma.ts             # Database client
│   │   ├── prisma/
│   │   │   ├── schema.prisma             # Database schema
│   │   │   └── seed.ts                   # Demo data
│   │   └── tests/                        # Unit tests
│   └── package.json
│
├── vapi-gitops/                  # v3.0 Vapi config-as-code
│   ├── resources/
│   │   ├── assistants/           # 9 assistant markdown prompts
│   │   │   ├── router-v3.md
│   │   │   ├── patient-id-en.md
│   │   │   ├── patient-id-zh.md
│   │   │   ├── booking-en.md
│   │   │   ├── booking-zh.md
│   │   │   ├── modification-en.md
│   │   │   ├── modification-zh.md
│   │   │   ├── registration-en.md
│   │   │   └── registration-zh.md
│   │   ├── tools/                # 14 tool YAML definitions
│   │   └── squads/
│   │       └── vitaravox-v3.yml  # Squad with 20 handoff routes
│   ├── src/push.ts               # GitOps push script
│   ├── .env.dev                  # Vapi API key (dev)
│   └── v2-reference/             # v2.3.0 backup configs
│
├── backups/                      # Vapi squad backups
│   └── vapi-20260210/
│       └── prompts-v2.4-gold/    # Gold master prompts
│
├── docs/                         # Planning documents
│   ├── V3-EPICS-AND-STORIES.md
│   └── V3-TOOL-INVENTORY.md
│
├── nginx/                        # Reverse proxy
│   ├── nginx.conf
│   └── conf.d/api.conf
│
├── database/                     # Database initialization
│   └── init.sql
│
└── scripts/                      # Deployment scripts
    ├── deploy.sh
    └── ssl-setup.sh

Key Files¶

Application Code¶

File	Purpose
`admin-dashboard/server/src/index.ts`	Express app entry, middleware
`admin-dashboard/server/src/routes/vapi-webhook.ts`	14 Vapi tool handlers + callMetadataCache
`admin-dashboard/server/src/routes/api.ts`	Admin REST endpoints
`admin-dashboard/server/src/services/oscar.service.ts`	OSCAR REST Bridge adapter (X-API-Key)
`admin-dashboard/server/src/services/clinic.service.ts`	Clinic management + EMR routing

Vapi GitOps (v3.0)¶

File	Purpose
`vapi-gitops/resources/assistants/*.md`	9 assistant prompts (YAML frontmatter + markdown)
`vapi-gitops/resources/tools/*.yml`	14 tool definitions
`vapi-gitops/resources/squads/vitaravox-v3.yml`	Squad with 20 handoff routes
`vapi-gitops/src/push.ts`	Push config to Vapi API

Database¶

File	Purpose
`admin-dashboard/server/prisma/schema.prisma`	Prisma schema (8 models)
`database/init.sql`	Initial SQL schema

Recent Commits¶

Feb 11 - fix: Router silent transfer leak — neutral tool descriptions
Feb 10 - feat: v3.0 9-agent dual-track squad deployed via Vapi GitOps
Feb 10 - feat: callMetadataCache, v3 params, appointment type validation
Feb 09 - feat: v2.3.0 AssemblyAI STT, silent transfers, slot collision
Feb 06 - feat: v2.2.0 caller phone auto-detect, booking-first flow
Feb 03 - feat: v2.1.0 Admin Vapi management, call log saving
Feb 02 - feat: v2.0.0 5-agent squad architecture
Jan 16 - fix: v1.5.1 Admin dashboard data display
Jan 14 - feat: v1.5.0 Admin system with per-clinic EMR control
Jan 14 - feat: v1.4.0 EMR abstraction layer (adapter pattern)

Branch Strategy¶

Branch	Purpose
`main`	Production-ready code
`develop`	Integration branch
`feature/*`	New features
`fix/*`	Bug fixes
`docs/*`	Documentation

Deployment Flow¶

Developer Machine
       │
       │ git push
       ▼
   Git Repository
       │
       │ SSH to server
       ▼
   Production Server
       │
       │ ./scripts/deploy.sh
       ▼
   Docker Compose
       │
       ├── vitara-db
       ├── vitara-voice-agent
       └── vitara-nginx

Development Workflow¶

Setup¶

# Clone repository
git clone <repo-url> /opt/vitara-platform
cd /opt/vitara-platform

# Copy environment
cp .env.example .env
# Edit .env with secrets

# Start services
docker compose up -d

Make Changes¶

# Create feature branch
git checkout -b feature/new-endpoint

# Make changes
# Test locally

# Commit
git add .
git commit -m "feat: Description"

# Push
git push origin feature/new-endpoint

Deploy¶

# On production server
cd /opt/vitara-platform
git pull origin main
./scripts/deploy.sh

Code Statistics¶

Metric	Count
Total Files	80+
TypeScript	~5,000 lines (server)
Vapi GitOps (YAML/MD)	9 assistants + 14 tools + 1 squad
SQL/Prisma	~300 lines
Shell	~300 lines
NGINX Config	~200 lines
Documentation	~70,000+ words