Audstruct – AI-Assisted Music Platform (Prototype Monorepo)

Audstruct is an early-stage, AI-assisted full-stack prototype exploring the architecture of a music-focused SaaS platform (web app + API + workers + shared packages). It is designed to validate product structure and backend flows (auth, credits, billing, job orchestration) rather than ship a finished AI music engine.

Built with modern AI-assisted development tooling (Codexz) alongside manual system design, configuration, integration decisions, and iteration.

---

What’s Implemented

• Monorepo structure with shared packages and consistent tooling
• Web app (Next.js) with marketing + app routes
• Admin app scaffold
• API service (NestJS) with modules for auth, credits, billing, and jobs
• Generation worker (Python) with mock/demo generation flow
• Notify worker (TypeScript) with placeholder heartbeat behavior
• Docker Compose local development environment
• Documentation stubs under docs/ (architecture, runbooks, threat model)

---

What’s Experimental / Stubbed

• Real AI music generation pipelines and model inference
• Production-grade job queues and retry handling
• Hardened Stripe billing and webhook processing
• Production hardening (security, rate limits, monitoring, scaling)

---

Tech Stack

• Frontend: Next.js (App Router), React, Tailwind
• Backend: NestJS (Fastify)
• Workers: Python (gen worker), TypeScript (notify worker)
• Data / Infra: Prisma schema, Docker Compose (Postgres, Redis, MinIO)
• Tooling: pnpm workspaces, Turborepo

---

Monorepo Layout

apps/
  web/          # Next.js marketing + studio app
  api/          # NestJS API service
  admin/        # Admin UI scaffold

workers/
  gen-worker/   # Python generator (demo/placeholder)
  notify-worker # Notification worker

packages/
  ui/           # Shared UI components
  types/        # Shared types and schemas
  config/       # Shared lint / Tailwind config

scripts/        # Seed and ops scripts
docs/           # Architecture / runbooks / threat model
infra/          # Dockerfiles and infra stubs

---

Getting Started (Local Development)

Requirements

• Node.js 20+
• pnpm (npm install -g pnpm)
• Docker + Docker Compose
• Python 3.11+ (for the generation worker)

---

Install dependencies

pnpm install

---

Environment variables

Create a local environment file from the example:

cp .env.example .env

.env.example contains only placeholder development values.
Do not commit real secrets.

---

Run with Docker

docker compose up --build

Expected local URLs:

• Web app: http://localhost:3000
• API: http://localhost:4000
• Admin: http://localhost:3100
• Gen worker: http://localhost:8000

---

Seed demo data (optional)

pnpm ts-node scripts/seed.ts

---

Notes

This repository is a prototype scaffold intended for architectural exploration and rapid iteration.
Several flows are intentionally simplified or mocked to keep development flexible.

---

License

MIT