Skip to content

TransitHub v0.1.1 - Initial Public Release

Choose a tag to compare

@deviseo deviseo released this 03 Jul 16:25

TransitHub v0.1.1 - Initial Public Release

This is the first public GitHub release of TransitHub.

TransitHub is a self-hosted multi-upstream operations hub for API service operators using sub2api or new-api. It focuses on practical day-to-day operations: upstream account management, balance and cost visibility, group multiplier tracking, scheduled pricing campaigns, auto-pricing rules, and notification delivery.

Current Features

Multi-Workspace Admin Operations

  • Manage multiple admin workspaces.
  • Switch between workspace-scoped admin accounts.
  • Keep upstream sites, dashboard sessions, group mappings, settings, and campaign data isolated by workspace.

Upstream Site Management

  • Add and manage multiple upstream sites.
  • Support sub2api and new-api compatible upstream platforms.
  • Support password-based connection and token-based connection where available.
  • Sync upstream metrics and cache key operational data.
  • Use stream-style sync progress for multi-site synchronization.

Dashboard Metrics

  • View operational metrics such as upstream balance, today cost, trends, and group usage.
  • Inspect upstream balance breakdowns.
  • Drill into key-level upstream usage for today cost analysis.
  • Configure balance filtering for dashboard views.

Group Multiplier Tracking

  • Capture group multiplier snapshots from upstream sites.
  • Track multiplier changes and history.
  • Keep platform labels and custom group type information.
  • Use multiplier changes as a basis for alerts and pricing decisions.

Group Mapping And Auto Pricing

  • Map local/admin groups to one or more upstream groups.
  • Configure auto-pricing rules for mapped groups.
  • Support fixed and percentage-based pricing adjustments.
  • Support pricing thresholds, minimum/maximum multiplier limits, and notification templates.

Group Rate Campaigns

  • Create draft, immediate, or scheduled pricing campaigns.
  • Select campaign targets by all groups, group type, manual selection, or current filter.
  • Support set, multiply, and add adjustment modes.
  • Track campaign states including scheduled, running, ending, ended, partial, failed, and cancelled.
  • Restore original group multipliers when campaigns end.

Notifications And Settings

  • Configure DingTalk, Feishu, and Telegram notification channels.
  • Test notification channels before using them.
  • Configure balance warnings, multiplier change alerts, auto-pricing notifications, and campaign notifications.
  • Manage refresh interval and runtime display settings.

Deployment

  • Docker-based production deployment.
  • PostgreSQL for persistent data.
  • Redis for sessions, cache, and scheduled runtime tasks.
  • Production Compose example now uses the Docker Hub image: deviseo/transithub:latest.

Docker Image

docker pull deviseo/transithub:latest

Digest:

sha256:5a60749516a3ba9223936a7c6f6f89e8a09f93951299d715cb8420782bf07d48

Documentation Updates

  • Updated README repository references to: https://github.com/deviseo/transit-hub
  • Updated Star History links to deviseo/transit-hub.
  • Updated Docker build examples to use deviseo/transithub:latest.
  • Updated production Docker Compose to use deviseo/transithub:latest.

Verification

The release image was built and pushed successfully.

Checked:

docker compose -f deploy/docker-compose.prod.yml config
docker build -f deploy/Dockerfile -t deviseo/transithub:latest .
docker push deviseo/transithub:latest

Notes:

  • This is the first GitHub release, so there is no previous GitHub release changelog.
  • Existing Docker Hub version tags before this release were 0.1.0 and 0.1.1.
  • The published latest image points to the current release build.