appAdmin

R Package Version

Internal Admin Dashboard for Artalytics Platform

Manage artist waiting lists, track whitepaper downloads, monitor lead conversion, and oversee the pilot program.

Overview

appAdmin is an internal-only Shiny application providing administrative tools for the Artalytics team. It integrates with the artauth package to manage leads, track engagement, and prepare for artist onboarding.

Key Features

• 🎨 Artist Waiting List - Review applications, update statuses, approve/reject artists
• 📄 Whitepaper Tracking - Monitor investor and artist interest
• 📊 Analytics Dashboard - Conversion metrics, trends, and insights
• 👤 Lead Management - Contact info, notes, and follow-up tracking
• 🔄 Status Workflow - Move artists through: pending → reviewing → invited → converted

Quick Start

Launch the App

# Install dependencies
pak::pkg_install("artalytics/appAdmin")

# Run the admin dashboard
appAdmin::run_app()

# Or with custom port
appAdmin::run_app(port = 8080)

Environment Requirements

# Required environment variables (set in .Renviron):
ART_PGUSER_SITE=shiny
ART_PGPASS_SITE=<your-password>
ART_PGHOST_SITE=artalytics-leads-do-user-16793376-0.d.db.ondigitalocean.com
ART_PGPORT_SITE=25060

# After setting environment variables, restart R and verify connection:
artauth::..dbc()
artauth::..dbd(cn)

Features

1. Waiting List Management

• View Applications - Searchable, filterable table of all artist signups
• Review Details - See full application with specialties, URLs, messages
• Update Status - Change status (pending, reviewing, invited, converted, rejected)
• Bulk Actions - Process multiple applications at once
• Export Data - Download CSV for offline review

2. Whitepaper Downloads

• Download Log - Who downloaded, when, user type (artist/investor/other)
• Contact Info - Email addresses for follow-up outreach
• Duplicate Detection - See if someone downloaded multiple times
• Statistics - Total downloads, unique users, breakdown by type

3. Analytics Dashboard

• Conversion Funnel - Website visitor → waitlist → invited → user
• Time Series - Signups over time, download trends
• Demographics - Artist specialties, geographic distribution (if tracked)
• Engagement Metrics - Response rates, time to conversion

4. Lead Actions

• Email Integration - Quick links to email artists (via artsend)
• Status History - Track when status changed, by whom
• Notes/Comments - Internal notes on applications
• Priority Flags - Mark high-value artists for early access

Screenshots

(Coming soon)

Architecture

appAdmin/
├── R/
│   ├── app-ui.R              # Main UI layout
│   ├── app-server.R          # Server logic
│   ├── mod-waitlist.R        # Waiting list module
│   ├── mod-whitepaper.R      # Whitepaper tracking module
│   ├── mod-analytics.R       # Analytics dashboard module
│   ├── utils-data.R          # Data loading utilities
│   └── appAdmin-package.R    # Package documentation
├── inst/
│   ├── app/
│   │   └── app.R             # App entry point
│   └── www/
│       ├── css/
│       │   └── custom.css    # Custom styling
│       └── js/
│           └── admin.js      # Client-side interactions
└── tests/
    └── testthat/

Security

⚠️ Internal Use Only

This application is designed for internal use by the Artalytics team only. It should:

• NOT be deployed publicly
• NOT be accessible without authentication (add basic auth or VPN access)
• NOT expose sensitive lead data

Recommended Deployment

1. Local Use - Run on team members’ machines
2. Internal Server - Deploy behind VPN with IP whitelist
3. Basic Auth - Use .htpasswd or Shiny Server Pro authentication
4. Environment Variables - Sensitive configs in .Renviron, not code

Initial Guidance

• First, review organization-wide standards:

• Next, review repository-specific guidance:

Environment Setup

• View this script to setup dev environment:

License

Proprietary - Artalytics, Inc.

Support

For questions or issues: - GitHub Issues: https://github.com/artalytics/appAdmin/issues - Internal Slack: #dev-admin-tools