PoetryHub
Start

Documentație PoetryHub

Ghid tehnic pentru stack-ul aplicației, rutele API, funcționalitățile produsului și instrumentele de dezvoltare. Folosește meniul vertical din sidebar — fiecare secțiune are submeniuri expandabile.

Arhitectură

PoetryHub este o aplicație full-stack construită cu Nuxt 3 (Vue 3 + Nitro). Frontend-ul și backend-ul trăiesc în același repo: paginile sunt în pages/, iar API-ul serverless în server/api/. Datele persistente sunt în PostgreSQL prin Prisma. Deploy-ul țintă este Vercel (preset Nitro vercel). 

Browser (Vue 3 + Pinia)
    ↓ useFetch / $fetch
Nitro API (server/api/**)
    ↓ Prisma Client
PostgreSQL (Neon / orice provider PG)

Organizare documentație

Stack → Frontend

Nuxt, Vue, Tailwind, Pinia, i18n, componente DS

Stack → Backend

Nitro handlers, JWT, OAuth Google, validare Zod

Stack → Bază de date

Modele Prisma, relații, lexicon Write

Stack → Deployment

Vercel, env vars, CI GitHub Actions

API

Referință completă endpoint-uri REST

Features

Citire, Write, carousel, cont, admin

Dev → Storybook

Componente izolate, CSF3, port 6006

Dev → Testare

Vitest, Playwright, structura tests/

Structură repo

  • pages/ — rute file-based (public, account, admin, docs)
  • components/ — UI reutilizabil + design system (components/ds/)
  • composables/ — logică client partajată (auth, reader prefs, carousel)
  • server/api/ — endpoint-uri Nitro
  • server/utils/ — utilitare server (auth, cache, payload home)
  • prisma/ — schema și migrări
  • tests/ — unit, API, component, e2e
  • .storybook/ — config Storybook 9

Comenzi utile

npm run dev          # Nuxt dev server (port 3000)
npm run storybook    # Storybook (port 6006)
npm test             # Vitest (unit + API + component)
npm run test:e2e     # Playwright (build + smoke)
npm run db:studio    # Prisma Studio