Codebase

This page describes the core delivery structure: apps/web, apps/admin, and the 10 backend Workers.

Core directory layout

zship/
├── apps/
│   ├── web/                     # User-facing site (Astro + Vue)
│   └── admin/                   # Admin console (Nuxt + Element Plus)
├── backend/
│   ├── node1-auth-service/      # Auth, users, credits, API keys
│   ├── node2-support-service/   # Tickets, email, feedback
│   ├── node3-pay-service/       # Payments, pricing, webhooks
│   ├── node4-notify-service/    # Bark, Feishu, DingTalk
│   ├── node5-blog-service/      # Blog CMS
│   ├── node6-cdn-service/       # File upload, CDN
│   ├── node7-site-service/      # Banners, friend links, waitlist
│   ├── node8-prompt-service/   # Prompt library
│   ├── node9-checkin-service/   # Check-in rules, rewards
│   └── node10-ai-service/       # AI gateway, chat, sessions
├── packages/                    # Shared packages (used by core delivery)
│   ├── dashboard/               # Dashboard components, brand config
│   ├── backend-utils/           # Worker / admin utilities
│   ├── blog-engine/             # Blog markdown pipeline
│   ├── notify-utils/            # Notification helpers
│   └── nuxt-admin-layer/        # Admin Nuxt layer
└── scripts/                     # Dev Console, deploy scripts

Backend services (core)

Service	Directory	Role
Auth	node1-auth-service	Login, register, users, credits, API keys
Support	node2-support-service	Tickets, feedback, email
Pay	node3-pay-service	Stripe, Creem, pricing, webhooks
Notify	node4-notify-service	Push notifications
Blog	node5-blog-service	Blog CMS
CDN	node6-cdn-service	File upload, storage
Site	node7-site-service	Banners, friend links, waitlist
Prompt	node8-prompt-service	Prompt templates
Check-in	node9-checkin-service	Check-in rules, rewards
AI	node10-ai-service	AI gateway, multi-model chat

Value-added (not in core)

• zship-provider1-service — AI provider gateway (KIE, WaveSpeed AI), purchasable separately
• apps/landing, apps/web-nuxt — Optional marketing / alternate frontends

Next steps

• Deployment Guide — Deploy core stack