Files
temp/docs/reference/cloud/cloud_features.md
T

244 lines
6.6 KiB
Markdown

# Cloud-Only Features Analysis
Features that need removal or replacement for self-hosted CleverAgents.
## Summary
- Total cloud features identified: 15
- Features to remove: 6
- Features to replace: 9
- Go files affected: 35
## Replacement Strategies
### Features to Remove
These features should be completely removed:
- **billing_ui** (high priority)
- Web-based billing and subscription UI
- Notes: Replace with self-host cost estimation guide
- **api_proxy** (high priority)
- Cloud API key proxying service
- Notes: Users manage their own provider API keys
- **old_api_versions** (medium priority)
- Backward compatibility with old API versions
- Notes: CleverAgents starts fresh with v1 only
- **cloud_backups** (low priority)
- Automated cloud backups
- Notes: Provide backup scripts and best practices
- **push_notifications** (low priority)
- Mobile/desktop push notifications
- Notes: Focus on CLI/TUI notifications
- **legacy_models** (low priority)
- Support for deprecated model versions
- Notes: Remove support for EOL models
### Features to Replace
These features need local alternatives:
- **managed_auth** (high priority)
- Cloud-based authentication service
- Replacement: Local auth with optional LDAP/SAML
- Notes: Implement local user management with pluggable auth
- **email_service** (high priority)
- Cloud email service integration
- Replacement: SMTP configuration with local mail server
- Notes: Support standard SMTP with templates
- **usage_limits** (medium priority)
- Usage-based limits and quotas
- Replacement: Configurable local limits
- Notes: Make limits configurable via settings
- **usage_telemetry** (medium priority)
- Usage tracking and analytics
- Replacement: Opt-in local telemetry with OpenTelemetry
- Notes: Default to disabled, provide local dashboard option
- **api_keys_cloud** (medium priority)
- Cloud-managed API keys
- Replacement: Local API key management
- Notes: Store encrypted keys locally
- **cdn_assets** (medium priority)
- CDN-hosted static assets
- Replacement: Bundle assets in distribution
- Notes: Include all assets in package
- **org_management** (medium priority)
- Cloud-based organization management
- Replacement: Local team management with roles
- Notes: Simplified local team structure
- **error_reporting** (low priority)
- Centralized error reporting service
- Replacement: Local error logging with optional export
- Notes: Use structured logging with export options
- **team_sync** (low priority)
- Real-time team state synchronization
- Replacement: Database-based sync for multi-user mode
- Notes: Use DB polling or websockets locally
## Detailed Analysis by Category
### Billing
Payment processing and subscription management
#### Billing Ui
- **Action**: remove
- **Priority**: high
- **Description**: Web-based billing and subscription UI
- **Replacement**: Documentation on self-hosting costs
- **Notes**: Replace with self-host cost estimation guide
#### Usage Limits
- **Action**: replace
- **Priority**: medium
- **Description**: Usage-based limits and quotas
- **Functionality**:
- API call limits
- Storage quotas
- Team size limits
- **Replacement**: Configurable local limits
- **Notes**: Make limits configurable via settings
### Telemetry
Usage tracking and analytics
#### Usage Telemetry
- **Action**: replace
- **Priority**: medium
- **Description**: Usage tracking and analytics
- **Replacement**: Opt-in local telemetry with OpenTelemetry
- **Notes**: Default to disabled, provide local dashboard option
#### Error Reporting
- **Action**: replace
- **Priority**: low
- **Description**: Centralized error reporting service
- **Replacement**: Local error logging with optional export
- **Notes**: Use structured logging with export options
### Managed Auth
Centralized authentication service
#### Managed Auth
- **Action**: replace
- **Priority**: high
- **Description**: Cloud-based authentication service
- **Functionality**:
- OAuth providers
- SSO integration
- Password reset emails
- Email verification
- **Replacement**: Local auth with optional LDAP/SAML
- **Notes**: Implement local user management with pluggable auth
#### Api Keys Cloud
- **Action**: replace
- **Priority**: medium
- **Description**: Cloud-managed API keys
- **Functionality**:
- Key generation
- Key rotation
- Usage tracking per key
- **Replacement**: Local API key management
- **Notes**: Store encrypted keys locally
### Cloud Storage
Cloud-based data storage
#### Cloud Backups
- **Action**: remove
- **Priority**: low
- **Description**: Automated cloud backups
- **Functionality**:
- Automated S3 backups
- Point-in-time recovery
- Cross-region replication
- **Replacement**: Local backup documentation
- **Notes**: Provide backup scripts and best practices
#### Cdn Assets
- **Action**: replace
- **Priority**: medium
- **Description**: CDN-hosted static assets
- **Replacement**: Bundle assets in distribution
- **Notes**: Include all assets in package
### Notifications
Cloud notification services
#### Email Service
- **Action**: replace
- **Priority**: high
- **Description**: Cloud email service integration
- **Functionality**:
- Invite emails
- Password reset
- Notifications
- Reports
- **Replacement**: SMTP configuration with local mail server
- **Notes**: Support standard SMTP with templates
#### Push Notifications
- **Action**: remove
- **Priority**: low
- **Description**: Mobile/desktop push notifications
- **Replacement**: In-app notifications only
- **Notes**: Focus on CLI/TUI notifications
### Rate Limiting
Cloud-based rate limiting
### Team Management
Centralized team/org management
#### Org Management
- **Action**: replace
- **Priority**: medium
- **Description**: Cloud-based organization management
- **Functionality**:
- Org creation
- Member management
- Role assignment
- Billing per org
- **Replacement**: Local team management with roles
- **Notes**: Simplified local team structure
#### Team Sync
- **Action**: replace
- **Priority**: low
- **Description**: Real-time team state synchronization
- **Functionality**:
- Real-time updates
- Presence tracking
- Shared contexts
- **Replacement**: Database-based sync for multi-user mode
- **Notes**: Use DB polling or websockets locally
### Api Proxying
API key management and proxying
#### Api Proxy
- **Action**: remove
- **Priority**: high
- **Description**: Cloud API key proxying service
- **Functionality**:
- Hide user API keys
- Rate limit per user
- Usage tracking
- Cost allocation
- **Replacement**: Direct API usage with user keys
- **Notes**: Users manage their own provider API keys