https://github.com/mastercloudapps-projects/realfood-shipping
https://github.com/mastercloudapps-projects/realfood-shipping
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mastercloudapps-projects/realfood-shipping
- Owner: MasterCloudApps-Projects
- License: apache-2.0
- Created: 2021-07-30T15:04:57.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-06-17T15:02:47.000Z (about 3 years ago)
- Last Synced: 2025-01-24T11:44:48.079Z (5 months ago)
- Language: Kotlin
- Size: 38.1 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Realfood-Shipping
Servicio de envíos del TFM del Master CloudApps de la URJC
### Autores
- Juan Antonio Ávila Catalán, [@juanaviladev](https://github.com/juanaviladev)
- Cristo Fernando López Cabañas, [@cristoflop](https://github.com/cristoflop)
Este servicio contiene toda la funcionalidad asociada a los clientes de la aplicación RealFood, esta aplicación consta
de los siguientes componentes:
- [GitHub - Realfood-Clients](https://github.com/MasterCloudApps-Projects/realfood-clients)
- [GitHub - Realfood-Restaurants](https://github.com/MasterCloudApps-Projects/realfood-restaurants)
- [GitHub - Realfood-Payments](https://github.com/MasterCloudApps-Projects/realfood-payments)
- [GitHub - Realfood-Shipping](https://github.com/MasterCloudApps-Projects/realfood-shipping)
Estos servicios se ha desarrollado siguiendo el estilo
de [Arquitectura Hexagonal](https://es.wikipedia.org/wiki/Arquitectura_hexagonal_(software))
Operaciones disponibles en el servicio:
Operaciones disponibles al iniciar sesion
- GET /api/shipments/{shipmentId} Seguimiento de un pedido
Operaciones de Publicación/Suscripción que ejecuta el servicio:
- [Publish] Shipment update Actualización del estado de un pedido
- [Consume] Send order request Petición de envío de un nuevo pedido
Diagrama de clases del dominio de la aplicación:
```mermaid
classDiagram
class Shipment
class Order
class Client
class Status {
<>
DELIVERED
IN_ROUTE
PENDING
}
class Shipment
Shipment o--> Status
Shipment o--> Client
Shipment o--> Order
```
Ejemplo de diagrama de clases para el caso de uso Track Shipment:
## Despliegue
### Docker
- Despliegue de recursos (Solo BD y broker de RabbitMq)
```
$ docker-compose -f deploy/docker-compose.yml up --build
```
- Despliegue completo (Recursos y servicio de shipping)
```
$ docker-compose -f deploy/docker-compose-prod.yml up --build
```
- Para observar que se han creado los contenedores:
```
$ docker ps
```
Software recomendado: [Docker desktop](https://www.docker.com/) / [Rancher desktop](https://rancherdesktop.io/)
### Kubernetes
En la carpeta de /deploy están los manifiestos para desplegar los recursos y el servicio
- Arrancar el servicio de minikube
```
$ minikube start
```
- Arrancar broker de RabbitMQ
```
$ kubectl apply -f rabbitmq-pv.yaml
$ kubectl apply -f rabbitmq-pv-claim.yaml
$ kubectl apply -f rabbitmq-deployment.yaml
$ kubectl apply -f rabbitmq-service.yaml
```
- Arrancar BD de clientes
```
$ kubectl apply -f postgres-pv.yaml
$ kubectl apply -f postgres-pv-claim.yaml
$ kubectl apply -f postgres-deployment.yaml
$ kubectl apply -f postgres-service.yaml
```
- Arrancar Servicio de envíos
```
$ kubectl apply -f app-deployment.yaml
$ kubectl apply -f app-service.yaml
```
- Para observar que se han desplegado los servicios:
```
$ kubectl get deployments
$ kubectl get services
```
- Si se quiere levantar todo directamente:
```
$ kubectl apply -f .
```
Software recomendado: [k8sLens](https://k8slens.dev/)