Skip to content
RightCapital Knowledge Base

Code Locations

Quick Reference

Section titled “Quick Reference”

Find code for integration-related functionality.

Repositories

Section titled “Repositories”
RepositoryPurposeURL
Retail APIMain backend, API integrationsweb-service/api
CollectorFile download serviceintegrations/collector
MorningstarSecurity data syncintegrations/morningstar
Admin Center APIAdmin backendadmin-center/api
PHP PackagesShared librariesphp-libs/packages

Retail API Directories

Section titled “Retail API Directories”

API-based Integrations

Section titled “API-based Integrations”
app/Integrations/
├── ApiBased/
│   ├── Connectors/           # Vendor API clients
│   ├── Integrators/          # Sync orchestration
│   ├── Requests/             # API endpoint definitions
│   └── Plugins/              # Shared functionality
├── {VendorName}/             # Vendor-specific code
│   ├── Connector.php
│   ├── Integrator.php
│   └── Requests/

SSO Controllers

Section titled “SSO Controllers”
app/Http/Controllers/Sso/
├── {VendorName}SsoController.php    # Vendor-specific SSO handlers
├── SamlController.php               # Generic SAML handling
└── ...

Integration Commands

Section titled “Integration Commands”
app/Console/Commands/
├── Integration/
│   ├── SyncCommand.php              # Nightly sync
│   ├── ImportCommand.php            # Manual import
│   └── ...

Database Models

Section titled “Database Models”
app/Models/
├── Integration.php                  # integrations table
├── IntegrationMapping.php           # integration_mappings table
├── IntegrationLog.php               # Logging model
└── ...

Shared Libraries

Section titled “Shared Libraries”

File-based Integration Library

Section titled “File-based Integration Library”
php-libs/packages/libs/integrations-file-based/
├── Parsers/                         # Vendor file parsers
├── Processors/                      # Data processing
└── ...

Location: integrations-file-based

Collector

Section titled “Collector”
collector/
├── src/
│   ├── Downloaders/                 # SFTP download logic
│   ├── Processors/                  # File processing
│   ├── Uploaders/                   # S3 upload logic
│   └── Finalizers/                  # LATEST file generation
├── config/
│   └── vendors/                     # Vendor configurations
└── ...

Key Files

Section titled “Key Files”
PurposeLocation
Integration routesroutes/api.php (search for “integration”)
OAuth callbacksapp/Http/Controllers/Integration/
Sync schedulingapp/Console/Kernel.php
Integration configconfig/integrations.php

Database Tables

Section titled “Database Tables”
TablePurpose
integrationsAdvisor-Vendor connections
integration_mappingsEntity mappings
integration_logsRequest/response logs
securitiesSecurity master data
positionsAccount positions

S3 Paths

Section titled “S3 Paths”
PathContent
rightcapital-prd/integrations/{vendor}/Collector output files
rightcapital-prd/logs/integration/{vendor}/File logs

Environment Variables

Section titled “Environment Variables”

Key environment variables for integrations:

VariablePurpose
INTEGRATION_S3_BUCKETS3 bucket for files
{VENDOR}_CLIENT_IDOAuth client ID
{VENDOR}_CLIENT_SECRETOAuth client secret
{VENDOR}_API_URLVendor API base URL

Source

Section titled “Source”