Proyecto del curso de programación web | Policlinico La Trinidad

Caution

Dependencias

Este proyecto hace uso del framework de la web Astro.

A su vez Astro requiere de Node.Js, este se requiere que lo instale en su equipo.

Ademas, se utiliza el gestor de paquetes pnpm en este proyecto.

Por ultimo, se utilizará el framework de CSS: Tailwind CSS en este proyecto. Para agregar las dependencias de Tailwind CSS en el proyecto de Astro se debe utilizar este comando

pnpm add @astrojs/tailwind tailwindcss

Important

Para poder contribuir al proyecto

1. Hacer un fork del repositorio en GitHub

2. Clonar su repositorio (el del fork)

Clona el repositorio normalmente segun el editor que estes utilizando.

3. Realizar el siguiente comando

Despues de clonar el repositorio te dirijes a la carpeta donde se encuentra el proyecto y abres la terminal ahi. Tendras que utilizar el siguiente comando con pnpm(que es lo que se esta usando en el proyecto).

pnpm install

4. Comprobación

Para poder comprobar que todo este correcto tendra que correr el proyecto en localhost con el siguiente comando

pnpm run dev

5. Contribuye

Con todo esto ya podras realizar tus PR al proyecto desde el fork que usted creo

Utilizar la parte de la backend que lee bases de datos

esta parte de la backend lee bases de datos y producen JSONs que pueden ser leidos por una llamada de fetch() en el frontend. Esta parte del proyecto utiliza el framework de Laravel.

A su vez, Laravel requiere de Composer. Composer es un gestor de paquetes para PHP.

Obviamente todo esto necesita de PHP, aunque si tienes XAMPP, lo más probable es que también tengas PHP con el. En todo caso, instala PHP y añade la carpeta en donde está a tu PATH porque vamos a necesitarlo para algunos comandos. (También te recomiendo instalar 7zip en tu computadora, porque Composer usa 7zip para extraer paquetes descargados de su repositorio. Puedes revisar la sección Solución de problemas para más información).

Incluyendo una carpeta a PATH

En general, tu añades una carpeta a PATH para que todos sus ejecutables dentro de la dicha carpeta puedan utilizarse en cualquier lugar sin tener que especificar la ruta en donde están. Si no sabes incluir algo en tu path, sigue los siguientes pasos. Si sabes como incluir algo en PATH o si ya tienes PHP configurado en tu path (prueba a ejecutar php --version para probar), salta a Configurando el proyecto.

1. Busca "variables de entorno" y selecciona la opción "Editar las variables de entorno del sistema".
   

2. Pulsa el boton "Variables de entorno..."
   

3. Busca "Path" en "Variables del sistema", selecciónalo y pulsa "Editar"
   

4. En la pantalla que se muestra, Pulsa "Examinar..."
   

5. Busca la carpeta donde está instalado PHP (Con XAMPP, usualmente es instalado en "C:\xampp\php"), selecciónalo y presiona "Aceptar".
   

6. Finalmente, pulsa "Aceptar" en estas 3 ventanas para salir y guardar tus cambios.
   

7. Para probar que todo está correcto, abre una nueva ventana de la línea de comandos (importante, porque las ventanas de línea de comandos antes de la configuración no reconocerán el nuevo elemento en PATH) y ejecuta php --version. Si se configuró correctamente, debería mostrarse algo parecido a esto.
   

Configurando el proyecto

Una vez que tengas todo esto instalado, lo único que requieres es ir a la carpeta /api dentro del proyeto y ejecutar el siguiente comando para instalar las dependencias necesarias para el proyecto:

composer install

Luego necesitarías las bases de datos, está registrado para ejecutar en una base de datos de MySQL, pero puedes cambiarla en un archivo .env en la carpeta /api (DB_VENDOR), junto a número de puerto (DB_PORT), un usuario (DB_USERNAME) y contraseña (DB_PASSWORD)

Ahora puedes probar a crear tu base de datos manualmente, o ejecutando el siguiente comando:

php artisan migrate

Lo puedes rellenar de datos de la siguiente manera (por supuesto que también puedes hacerlo manualmente):

php artisan db:seed

Algunas funciones de la backend realizan lectura y escritura de datos. Para hacer visible dichos archivos escriba lo siguente en la consola

php artisan storage:link

Una vez con las bases de datos creadas y con datos, ejecuta una ventana de línea de comandos y escribe el siguiente comando para levantar el servidor de backend:

php artisan serve

Esto levantará un servidor en 127.0.0.1:8000 (o localhost:8000, son lo mismo. También puede que lo levante en un puerto distinto si el puerto 8000 ya está tomado).

Para acceder a las apis de la backend, utiliza la ruta http://localhost:8000/api/...

Por ejemplo:
Para recibir datos del backend acerca de los fármacos, ve a http://localhost:8000/api/farmacos y se mostrará un JSON que puedes utilizar en Astro con fetch(http://localhost:8000/api/farmacos)

Solución de problemas

git was not found in your PATH, skipping source download al usar composer install
Para este problema existen 3 soluciones, puedes escoger una de ellas (o puedes hacer todas si quieres)

1. Descarga 7zip y añadelo a tu PATH (Está en C:\Program Files\7-zip en una instalación usual)
2. Busca tu archivo php.ini (En PHP con XAMPP está en C:\xampp\php), y ábrelo con un editor de texto. Busca la siguiente línea ;extension=zip y quítale el punto y coma.
3. Añade Git a tu PATH (Está en C:\Program Files\Git\bin en una instalación usual)

🧞 Comandos

Command	Action
pnpm install	Installs dependencies
pnpm run dev	Starts local dev server at localhost:4321
pnpm run build	Build your production site to ./dist/
pnpm run preview	Preview your build locally, before deploying
pnpm run astro ...	Run CLI commands like astro add, astro check
pnpm run astro -- --help	Get help using the Astro CLI
composer install	Installs PHP dependencies
php artisan serve	Attempts to start a local dev server at localhost:8000