Initial MVP: full-stack music discovery app

Backend (FastAPI):
- User auth with email/password and Spotify OAuth
- Spotify playlist import with audio feature extraction
- AI recommendation engine using Claude API with taste profiling
- Save/bookmark recommendations
- Rate limiting for free tier (10 recs/day, 1 playlist)
- PostgreSQL models with Alembic migrations
- Redis-ready configuration

Frontend (React 19 + TypeScript + Vite + Tailwind):
- Landing page, auth flows (email + Spotify OAuth)
- Dashboard with stats and quick discover
- Playlist management and import from Spotify
- Discover page with custom query support
- Recommendation cards with explanations and save toggle
- Taste profile visualization
- Responsive layout with mobile navigation
- PWA-ready configuration

Infrastructure:
- Docker Compose with PostgreSQL, Redis, backend, frontend
- Environment-based configuration
This commit is contained in:
root
2026-03-30 15:53:39 -05:00
commit 155cbd1bbf
62 changed files with 7536 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
from sqlalchemy import String, Integer, Float, ForeignKey, JSON
from sqlalchemy.orm import Mapped, mapped_column, relationship
from app.core.database import Base
class Track(Base):
__tablename__ = "tracks"
id: Mapped[int] = mapped_column(primary_key=True)
playlist_id: Mapped[int] = mapped_column(ForeignKey("playlists.id", ondelete="CASCADE"), index=True)
title: Mapped[str] = mapped_column(String(500))
artist: Mapped[str] = mapped_column(String(500))
album: Mapped[str | None] = mapped_column(String(500), nullable=True)
spotify_id: Mapped[str | None] = mapped_column(String(255), nullable=True)
isrc: Mapped[str | None] = mapped_column(String(20), nullable=True)
preview_url: Mapped[str | None] = mapped_column(String(500), nullable=True)
image_url: Mapped[str | None] = mapped_column(String(500), nullable=True)
# Audio features from Spotify
tempo: Mapped[float | None] = mapped_column(Float, nullable=True)
energy: Mapped[float | None] = mapped_column(Float, nullable=True)
danceability: Mapped[float | None] = mapped_column(Float, nullable=True)
valence: Mapped[float | None] = mapped_column(Float, nullable=True)
acousticness: Mapped[float | None] = mapped_column(Float, nullable=True)
instrumentalness: Mapped[float | None] = mapped_column(Float, nullable=True)
genres: Mapped[list | None] = mapped_column(JSON, nullable=True)
playlist: Mapped["Playlist"] = relationship(back_populates="tracks")
from app.models.playlist import Playlist # noqa: E402, F811