Blog API con Prisma 7

Una API RESTful robusta para un sistema de blogs, construida con Node.js, Express y Prisma ORM (v7). Utiliza SQLite como base de datos por defecto para facilitar el desarrollo local.

🚀 Características

• Gestión de Usuarios (Bio, Avatar, Roles).
• Gestión de Posts (Slug automático, Vistas, Categorías, Comentarios).
• Sistema de Comentarios.
• Clasificación por Categorías.
• Paginación y Filtrado en endpoints de listado.
• Arquitectura escalable con TypeScript.

🛠️ Requisitos Previos

• Node.js (v18 o superior recomendado)
• npm

📦 Instalación

1. Clona el repositorio:

   git clone <url-del-repositorio>
   cd blog-api

2. Instala las dependencias:

   npm install

3. Configura las variables de entorno:

   • El archivo .env ya viene preconfigurado con:

     DATABASE_URL="file:./dev.db"
     SERVER_PORT=3000

4. Ejecuta las migraciones de Prisma y genera el cliente:

   npx prisma migrate dev --name init
   npx prisma generate

5. (Opcional) Carga datos de prueba:

   npm run seed

🏃 Scripts Disponibles

• npm run dev: Inicia el servidor en modo desarrollo con tsx watch.
• npm start: Inicia el servidor en modo producción.
• npm run build: Compila el proyecto TypeScript a JavaScript.
• npm run seed: Ejecuta el script de seeding de la base de datos.

🛣️ API Endpoints

Usuarios (/api/users)

• GET /api/users: Listar todos los usuarios.
• GET /api/users/:id: Obtener detalles de un usuario específico (incluye sus posts publicados).

Posts (/api/posts)

• GET /api/posts: Listar posts (soporta query params page, limit, published).
• GET /api/posts/:slug: Obtener un post por su slug (incrementa el contador de vistas).
• POST /api/posts: Crear un nuevo post.
• PUT /api/posts/:id: Actualizar un post existente.
• DELETE /api/posts/:id: Eliminar un post.

📊 Modelo de Datos

erDiagram
    User ||--o{ Post : "escribe"
    User ||--o{ Comment : "escribe"
    Post ||--o{ Comment : "tiene"
    Post }o--o{ Category : "pertenece"

    User {
        Int id PK
        String email UK
        String password
        String name
        String bio
        String avatar
        Enum role
        DateTime createdAt
    }

    Post {
        Int id PK
        String title
        String slug UK
        String content
        String excerpt
        Boolean published
        Int views
        Int authorId FK
        DateTime createdAt
    }

    Category {
        Int id PK
        String name UK
        String slug UK
    }

    Comment {
        Int id PK
        String content
        Int postId FK
        Int authorId FK
        DateTime createdAt
    }

Loading

📄 Licencia

ISC -prisma