Project Structure

Structure Overview

Bunship follows a monorepo collaboration model with clear responsibility boundaries:

• Web product layer: marketing, app workspace, admin, docs
• API domain layer: business rules, workflows, and third-party orchestration
• Shared capability layer: authentication, data contracts, UI primitives, reusable blocks

Domain Boundaries

Product surfaces

• Marketing: conversion pages and growth funnels
• App workspace: user-facing business workflows
• Admin console: operational governance and data operations
• Docs center: onboarding, integrations, and operation playbooks

Business services

• Billing and wallet lifecycle
• Affiliate and reward settlement
• AI generation and queue management
• Storage and content distribution
• CMS and publishing workflows

Shared foundations

• Identity and session model
• Data model and migration lifecycle
• Design system and reusable interaction patterns

Collaboration Rules

1. Keep business behavior and docs updates in the same PR.
2. Keep schema changes and release changes synchronized.
3. Use feature-level ownership to avoid cross-domain coupling.