orcapracticas / gql Goto Github PK

Utiliza la opción del mock, para generar datos falsos por lo cual considerar las tareas siguientes,

• #10 Instalación de causual
• #11 Crear mocks
• Configurar la opcion addMockFunctionsToSchema
• Resolver el siguiente query

{
    cursos {
        id
        titulo
        descripcion
        profesor{
            id
            nombre
            nacionalidad
            genero
            cursos{
                id
            }
        }
        raiting
        comentarios{
            id
            nombre
            cuerpo
        }
    }
}

Instalación de dependnecias para la integracion con react

Dependencies

• apollo-boost : Permite crear el cliente de conexion al servidro GQL
• graphql-tag: Permite crear un literal string el cual sera interpretado como el query que sera enviado al servidor GQL
• react
• react-apollo: Permite la integracion con react
• react-dom

Development Dependencies

• react-scripts

Los querys que se estarán ejecutando del lado de graphql necesitan una estructura base de la cual si lo vemos son muy genéricos por lo que seria recomendable crear un script que permite agilizar la estructuración de los querys.

Nota: Recordemos que estamos utilizando objection como ORM

Estructura de los querys.

// Comando que permite instertar un registro
Profesor.query().insert(args.profesor)

// Comando que permite actualizar un registro
Profesor.query().patchAndFetchById(args.profesorId, args.profesor)

// Comando que permite borrar un registro
 Profesor.query().findById(args.profesorId).then((profesor) => {
        return Profesor.query().deleteById(args.profesorId).then((filasBorradas) => {
          if (filasBorradas > 0) return profesor
          throw new Error(`El profesor con id ${args.profesorId} no se pudo eliminar`)
        })
      })

Al contar con la respuesta delos issues #30 #31, se procederá a realizar la configuracion y armado del desarrollo con react, el cual tiene que cumplir co.

• Listado de cursos

Crear script que permite llenar las tablas creadas en el issue #14, es necesario que la data se fake por lo que se recomienda utilizar la dependencia casual esta instalación se resolvió en el issue #10,

• Crear script para poblar la tabla de Cursos
• Crear script para poblar la tabla de Profesores
• Crear script para poblar la tabla de Comentarios

Instalación inicial de las dependencias necesarias para iniciar el proyecto

Dependencies

• body-parser
• express
• graphql
• graphql-server-express
• graphql-tools

Development Dependencies

• babel-cli
• babel-minify
• babel-plugin-inline-json-import
• babel-preset-env
• babel-register
• nodemon

Es necesario tener la capacidad de

• Editar un cursos
• Borrar un cursos
• Agregar un cursos

Es necesario instalar nuevas dependencias para poder realizar la integración

• axios
• json-server

Es necesario tener la capacidad de

• Editar un Comentario
• Borrar un Comentario
• Agregar un Comentario

Es necesario generar los los resolvers los cales permiten realizar el mapeo de los datos correspondientes a nuestros esquemas.

• Crear mocks que para cada entidad necesaria
• Realizar la configuración para llenar los datos de las instancias definidas en el schema
• Al terminar las 2 tareas anteriores es necesario resolver el siguiente query

{
    cursos {
        id
        titulo
        descripcion
        profesor{
            id
            nombre
            nacionalidad
            genero
            cursos{
                id
            }
        }
        raiting
        comentarios{
            id
            nombre
            cuerpo
        }
    }
}

Al terminar el curso es necesario realizar la implementación de las nuevas de los paquete instalados, el mas importante es

• Instalar nuevas dependencias
• Realizar nuevas configuraciones de ser necesario
• Adaptar codificación a las novedades que ofrece Apollo

Durante el curso se implementara el uso una base esta base estara integrada en sqlite, por lo que es necesario instalar las siguientes dependencias.

• Crear rama add/DataBase

• sqlite3: Gesto de base de datos

• objection: un ORM para Node.js que pretende mantenerse al margen y hacer que sea tan fácil como sea posible utilizar toda la potencia de SQL y el motor de base de datos subyacente.

• knex: (Generador de consutltas para Postgres, MSSQL, MySQL, MariaDB, SQLite3, Oracle, and Amazon Redshift ), diseñado para ser flexible y portatil.

Como ejemplo final es necesario usar un api que nos regrese un json para esto tenemos que tener resuelto el issue #38

Al borrar un usuario es necesario que se muestre un error como lo que vemos.

{
  "data": {
    "profesorDelete": null
  },
  "errors": [
    {
      "errorCode": "A55",
      "name": "GraphQLError",
      "mensaje": "El registro con el id 44 no se puede elmiar"
    }
  ]
}

Al contar con la instalación de casual es necesario crear los siguientes mocks

• Mock Cursos
• Mock Profesores
• Mock Comentarios

Tomar en cuenta que los datos que contiene el mock serán aleatorios

Al contar con las instalaciones que se marcan en le issue #30 en necesario crear los comandos

• Comando para correr el App
• Comando para correr el servidor de GQL

Al resolver los issues #14 #15 es necesario crear los modelos para cada una de las dependencias.

• Modelo Cursos
• Modelo Comentarios
• Modelo Profesores

Al terminar con los issues #13 #14 #15 #17, se procedera a realizar la configuración para la base de datos

• Crear archivo db.sqlite (Base de Datos)

• Crear archivo de configuracion knexfile.js

• Crear comando db:migration dentro de package.json, dicho comando tiene que permitir crear las tablas indicadas en el issue #14

• Crear comando db:seed dentro de package.json, dicho comando tiene que cargar data usando los scripts creados en el issue #15

Nota: Para poder realizar pruebas es recomendable instalar sqllite3 al tenerlo instalado corremos el comando sqllite3 [ruta de la BD] esto habilitara la consola en la cual podremos ejecutar comandos de SQL

Es necesario instalar la dependencias casual como dependencia de desarrollo

• Instalar casual

Al realizar la configuración inicial (#2) se genero un Schema solo con la finalidad de que todo funcionaba correctamente, Es importante realizar la planificación del Schema que se utilizara durante el curso por lo que en necesario cumplir con las tareas siguientes.

• Diagrama base del Schema
• Creación del schema
• Colocar comentarios por entidad creada
• Indicar si algún campo puede ser obsoleto en un futuro.

Es necesario crear los scripts que contrariaran las tablas que tendrán relación con los schemas creados en el issue #4,

• Proponer estructura de carpetas
• Tabla para Cursos
• Tabla para Profesores
• Tabla para Comentarios

Es necesario realizar una busqueda utilizando union

Crear readme describiendo de manera muy breve como se corre el proyecto

Por buenas prácticas se recomienda modularizar el contenido del esquema.

• Separar Resolvers
• Separa Schemas
• El ejemplo donde se usaban generar carpeta donde el ejemplo quede intacto
• Colocar comentarios relacionados al desarrollo para facilitar el entendimiento de terceros

al resolver el issue #17 es necesario realizar la integración de los modelos para que GQL pueda extraer los datos correspondientes de sqlite

Acciones realizadas

• Inicializacion del server de express
• Creación del schema base
• Configuración de las dependencias en .babelrc
• Configuración del archivo .gitignore
• Seteo de comando para iniciar el server

Es necesario tener la capacidad de

• Editar un Profesor
• Borrar un Profesor
• Agregar un Profesor