https://github.com/feguedi/rng-web-hapi
Generador de Números Pseudoaleatorios por medio de los métodos congruencial mixto y congruencial multiplicativo. API Rest con HapiJS y cliente web con ReactJS
https://github.com/feguedi/rng-web-hapi
api d3js excel hapijs msexcel nodejs reactjs swagger
Last synced: 2 months ago
JSON representation
Generador de Números Pseudoaleatorios por medio de los métodos congruencial mixto y congruencial multiplicativo. API Rest con HapiJS y cliente web con ReactJS
- Host: GitHub
- URL: https://github.com/feguedi/rng-web-hapi
- Owner: feguedi
- Created: 2021-07-28T03:37:24.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-07-28T10:53:40.000Z (about 4 years ago)
- Last Synced: 2025-06-20T16:13:13.823Z (4 months ago)
- Topics: api, d3js, excel, hapijs, msexcel, nodejs, reactjs, swagger
- Language: JavaScript
- Homepage:
- Size: 396 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Generador de Números Pseudo aleatorios
## Descripción
Generador de números pseudo-aleatorios donde el usuario pueda elegir el tipo de método para generarlos.
Siguiendo el libro _"Simulación. Un enfoque práctico"_ del autor **Raúl Coss Bú**, el autor sugiere dos tipos de métodos congruenciales para poder experimentar en una simulación: congruencial mixto y congruencial multiplicativo.
> Estos números se consideran pseudoaleatorios, porque aunque pasan todas las pruebas estadísticas de aleatoriedad, ellos son de hecho completamente determinísticos.
Parte del proyecto es utilizar una API para que pueda generarse un archivo, ya sea JSON o CSV, mediante una solicitud. En cambio, si se quiere obtener un archivo de Excel con los números, se debe ingresar directamente a la versión web.
## API
El backend funciona a manera de API Rest. Los siguientes son los parámetros necesarios (utilizando el método HTTP GET) para que el web service pueda responder adecuadamente:
| Variable | Descripción | Tipo de dato |
| :---: | :--- | :---: |
| x* | Semilla | _**número**_ |
| a* | Multiplicador | _**número**_ |
| c | Constante aditiva | _**número**_ |
| m* | Módulo | _**número**_ |
| metodo* | Método congruencial | _**mixto / multiplicativo**_ |
*requerido
### Ejemplos
#### Fetch
```javascript
const params = new URLSearchParams()
params.set('x', 4)
params.set('a', 5)
params.set('c', 8)
params.set('m', 7)
params.set('metodo', 'multiplicativo')
fetch(`https://rng.gudin.io/data?${params.toString()}`)
.then(response => response.json())
.then(console.log)
.catch(console.error)
```
#### Axios
```javascript
axios({
method: 'get',
url: 'https://rng.gudin.io/data'
params: {
'x': 4,
'a': 5,
'c': 8,
'm': 7,
'metodo': 'multiplicativo',
}
})
.then(({ data }) => console.log(data))
.then((err) => console.error(err))
```
#### cUrl
```sh
curl -X GET "https://rng.gudin.io/data?x=4&a=5&c=8&m=7&metodo=multiplicativo"
```
## Documentación
El plugin [__*hapi-swagger*__](https://www.npmjs.com/package/hapi-swagger) nos permite fácilmente generar una documentación de la API para OpenAPI. En este proyecto la ruta para verla es:
> http://localhost:8010/docs/api
Si quisiéramos modificar esa ruta, tendríamos que modificar el archivo ``server/plugins/documentation.js`` y cambiar el campo __*documentationPath*__.
## Pendientes
### Front end
* Cliente en ReactJS
* Gráfica en D3
* Recibir un arreglo como valores a gráficar
* Interacción para visualizar los datos
### Back end
* ~~Agregar salida de datos con un archivo de Excel, JSON o CSV~~
* Pruebas unitarias
* Documentación del código
## Notas
* [Aquí](https://github.com/SheetJS/js-xlsx/tree/master/demos/server) algunos ejemplos de la librería SheetJS con Node
* Este proyecto es una refactorización del [proyecto en Express y Handlebars](https://github.com/feguedi/rng-web) (inconcluso)