Homebanking App

DEMO

demo.mp4

Ejecución con Docker

1. Buildear backend

./backend/mvnw -f ./backend/pom.xml clean package -DskipTests

2. Buildear frontend

npm --prefix client/ run build

3. Para arrancar por primera vez la aplicación, cuando no están creadas las imagenes y contenedores ejecutamos:

sudo docker compose up --build

Si ya tenemos nuestros contenedores listos, ejecutamos

sudo docker compose up

4. Dirigirse a http://localhost:3000 para acceder a la landing page.

Ejecución sin Docker

En caso de querer ejecutar de forma local sin usar Docker, los pasos son los siguientes:

1. Clonar repositorio

2. Configurar archivo application.properties en /backend/src/main/resources/application.properties, siguiendo el formato:

spring.application.name=backend
spring.datasource.url=jdbc:postgresql://localhost:5432/<DB_NAME>
spring.datasource.username=<DB_USER>
spring.datasource.password=<DB_PASSWORD>

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect

security.jwt.key.private=<SECRET_KEY>
security.jwt.user.generator=<TOKEN_ISSUER_NAME>

3. Buildear backend:

./backend/mvnw -f ./backend/pom.xml clean package -DskipTests

4. Correr backend:

java -jar ./backend/target/*.jar

5. Instalar dependencias del frontend:

npm --prefix client/ install

6. Correr frontend con los siguientes comandos. a. Para correr en modo dev npm --prefix client/ run dev b. Para servir el front buildeado

   npm --prefix client/ run build
   npm --prefix client/ install -g serve
   npx --prefix client/ serve dist
   

7. Luego acceder a http://localhost:5174 en caso de estar corriendo en modo dev o http://localhost:3000 en caso de estar corriendo serve. Los puertos pueden variar en caso de una configuración distinta o si los puertos default están ocupados, de todas formas se informan por la terminal.

Información útil

• El servidor del frontend (servidor serve) corre en el puerto 3000 (en host y en el contenedor de docker)
• El servidor del backend corre en el puerto 8080 (en host y en el contenedor de docker)
• La base de datos postgres corre en el puerto 5432 en docker y 5433 en host

Tecnologías y herramientas usadas

• Java 17 + Spring Boot + Hibernate JPA
• Spring Security + JWT (auth)
• Postgresql
• React
• Serve (servidor de frontend buildeado)