How iwangbowen/zenith-admin works
Zenith Admin is a full-stack administrative platform: users operate feature pages in the web client, which calls the Hono server; server services enforce domain rules and persist data. The README documents broad business capabilities, while the sampled source only verifies selected CMS, reporting, deployment, and WebRTC behavior. The graph preserves major documented product areas without asserting unsampled internal call chains.
Main entry points: app.ts HTTP API · index.ts PostgreSQL data · deploy-engine.service.ts Host deployment · callManager.ts WebRTC calls
Components 23
User clients
- Admin web app
packages/web - Desktop client
packages/electron/src/main.ts - Monitoring UI
packages/web/src/pages/system/monitor/useMonitorRefreshController.ts - Analytics SDK
packages/analytics-sdk/src/index.ts - WebRTC calls
packages/web/src/webrtc/callManager.ts
API platform
- HTTP API
packages/server/src/app.ts - Auth and access
packages/server/src/middleware/auth.ts
Business domains
- Workflow engine
packages/server/src/lib/workflow-engine.ts - Workflow monitoring
packages/server/src/services/workflow/workflow-engine-introspection.service.ts - CMS content
packages/server/src/services/cms/cms-contents-query.service.ts - CMS themes
packages/server/src/cms/themes/registry.ts - AI assistant
packages/server/src/lib/ai/mastra-chat.ts - BI reports
packages/server/src/services/report/report-query-capacity.service.ts - Payment center
packages/server/src/lib/payment/index.ts - Notifications
packages/server/src/lib/notification/dispatch.ts - Host deployment
packages/server/src/services/ops/deploy-engine.service.ts
Runtime services
- Redis sessions/cache
packages/server/src/lib/redis.ts - Worker runtime
packages/server/src/bootstrap/workers.ts - File storage
packages/server/src/lib/file-storage.ts - Realtime gateway
packages/server/src/lib/ws-manager.ts
Persistence
- PostgreSQL data
packages/server/src/db/index.ts
Other components
- Administrator
- External providers
Connections 31
- Administrator → Admin web app: uses
- Admin web app → HTTP API: calls API
- Desktop client → Admin web app: hosts UI
- HTTP API → Auth and access: checks access
- HTTP API → Workflow engine: routes workflow
- HTTP API → CMS content: routes content
- HTTP API → AI assistant: routes assistant
- HTTP API → BI reports: routes reports
- HTTP API → Payment center: routes payments
- CMS content → PostgreSQL data: queries content
- CMS content → CMS themes: builds content URLs
- BI reports → PostgreSQL data: reads quota data
- BI reports → Redis sessions/cache: reads usage
- Workflow monitoring → PostgreSQL data: reads runtime state
- Workflow monitoring → Workflow engine: inspects queues
- Worker runtime → Workflow engine: executes jobs
- Worker runtime → Host deployment: runs tasks
- Host deployment → File storage: reads artifacts
- Host deployment → Notifications: sends completion
- Host deployment → PostgreSQL data: records runs
- Monitoring UI → HTTP API: requests snapshots
- Monitoring UI → External providers: opens event stream
- Analytics SDK → External providers: sends telemetry
- WebRTC calls → HTTP API: loads RTC config
- WebRTC calls → Realtime gateway: exchanges signaling
- WebRTC calls → External providers: streams peer media
- Payment center → External providers: uses payment channels
- AI assistant → External providers: uses model providers
- File storage → External providers: reads/writes objects
- Notifications → External providers: delivers messages
- HTTP API → PostgreSQL data: persists domain data