Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yul1b3th/edu-front
Este repositorio contiene los recursos de una aplicación web llamada EduMap Barcelona, que permite visualizar y analizar datos sobre el acceso y la equidad en la educación en los distritos de Barcelona, utilizando mapas interactivos y datos de OpenData Barcelona.
https://github.com/yul1b3th/edu-front
angular-cli mapbox tailwindcss typescript
Last synced: about 1 month ago
JSON representation
Este repositorio contiene los recursos de una aplicación web llamada EduMap Barcelona, que permite visualizar y analizar datos sobre el acceso y la equidad en la educación en los distritos de Barcelona, utilizando mapas interactivos y datos de OpenData Barcelona.
- Host: GitHub
- URL: https://github.com/yul1b3th/edu-front
- Owner: Yul1b3th
- Created: 2024-10-22T11:39:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-24T12:14:02.000Z (3 months ago)
- Last Synced: 2024-10-25T01:14:29.113Z (3 months ago)
- Topics: angular-cli, mapbox, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://edu-front-ebon.vercel.app
- Size: 442 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EduMap Barcelona
## Descripción
**EduMap Barcelona** es una aplicación web que permite a los usuarios visualizar
y analizar datos relacionados con el acceso y la equidad en la educación de los
diferentes distritos de Barcelona.
La aplicación presenta mapas interactivos que muestran los siguientes
indicadores clave por distrito:
- Rentas medias familiares anuales
- Establecimientos educativos de educación infantil
- Establecimientos educativos de educación primaria
- Establecimientos educativos de educación secundaria
Estos datos provienen de **OpenData Barcelona**, garantizando que la información
sea de acceso público y esté actualizada.
Este proyecto fue desarrollado como parte de la hackatón de la **IT Academy**,
realizada el 22 de octubre de 2024, por un equipo compuesto por profesionales
de: [**Data Analyst**](#equipo-data), [**Back-End**](#equipo-back-end) y
[**Front-End**](#equipo-front-end).
## Demo
Puedes ver la demostración de la aplicación en
[EduMap](https://edu-front-delta.vercel.app/).
## Características
- **Visualización Interactiva**: La aplicación ofrece mapas interactivos que
permiten a los usuarios explorar y analizar datos educativos de manera
intuitiva y dinámica.
- **Indicadores Clave**: Muestra información relevante, como rentas medias
familiares anuales y la ubicación de establecimientos educativos (infantil,
primario y secundario) en cada distrito de Barcelona.
- **Acceso a Datos Públicos**: Utiliza datasets de OpenData Barcelona,
asegurando que la información sea accesible y actualizada para todos los
usuarios.
- **Diseño Responsivo**: La interfaz está diseñada para ser compatible con
dispositivos móviles y de escritorio, ofreciendo una experiencia uniforme en
todas las plataformas.
- **Integración con API**: Conexión directa con el backend para gestionar datos
de manera eficiente y en tiempo real.
## Interacción con la API "EduMap"
Este proyecto frontend se integra con la API
[EduMap](https://github.com/amarinite/hackatonITAcademy), la cual sigue una
arquitectura RESTful, facilitando su integración y uso. Puedes explorar la
[documentación de la API](https://hackatonitacademy-4eb658690555.herokuapp.com/webjars/swagger-ui/index.html)
para obtener detalles sobre los endpoints, métodos HTTP y estructura de los
datos.
## Tecnologías Utilizadas
- [HTML5](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/HTML5)
- [SCSS](https://sass-lang.com/)
- [TypeScript](https://www.typescriptlang.org/)
- [Angular CLI](https://angular.dev/) versión 18.2.9
- [Mapbox](https://www.mapbox.com/)
- [Tailwind CSS](https://tailwindcss.com/)
## Requisitos
- Node.js y npm instalados en tu sistema. Descárgalos desde
[nodejs.org](https://nodejs.org/).
- Angular CLI instalado globalmente. Instálalo con el siguiente comando:
```bash
npm install -g @angular/cli
```
## Instalación y Despliegue
### Instalación
1. Clona el repositorio:
```bash
git clone https://github.com/Yul1b3th/edu-front.git
```
2. Ingresa al directorio del proyecto:
```bash
cd edu-front
```
3. Instala las dependencias:
```bash
npm install
```
4. Ejecuta la aplicación en modo desarrollo:
```bash
ng serve -o
```
### Despliegue
1. Ejecuta el comando de construcción para compilar la aplicación Angular:
```bash
ng build --prod
```
2. Los archivos generados se almacenarán en el directorio `dist/`. Puedes
desplegar estos archivos en un servidor web o en un servicio de alojamiento
que admita aplicaciones web estáticas.
## Pruebas Unitarias con Karma y Jasmine
Este proyecto cuenta con pruebas unitarias implementadas utilizando **Karma** y
**Jasmine**.
- **Servicio _EduService_**:
El servicio **_EduService_** incluye pruebas para garantizar que los datos se
obtienen correctamente desde la API, las cuales verifican: la obtención de
datos de renta de los distritos, asegurando que se recuperen adecuadamente; la
recuperación de datos relacionados con la educación infantil; la correcta
obtención de los datos de educación primaria; y la confirmación de que se
puedan obtener correctamente los datos de educación secundaria.
Para ejecutar las pruebas del servicio **_EduService_**, utiliza el comando:
```bash
ng test --include src/app/path/to/your/edu.service.spec.ts
```
- **Componente _AppComponent_**:
El componente **_AppComponent_** tiene una prueba para verificar su correcta
creación. Se asegura de que el componente se inicialice correctamente y esté
disponible para su uso en la aplicación.
Para ejecutar las pruebas del componente **_AppComponent_**, utiliza el
comando:
```bash
ng test --include src/app/path/to/your/app.component.spec.ts
```
Para ejecutar todas las pruebas en el proyecto, utiliza este comando:
```bash
ng test
```
## Equipo
El equipo está compuesto por un grupo de profesionales apasionados por la
tecnología y la innovación, especializados en las siguientes áreas:
#### Equipo Data:
- [Esteban Piliponsky](https://github.com/epili50)
- [Rodrigo Padilla](https://github.com/ErrePad)
- [Simone Solieri](https://github.com/sisolieri)
#### Equipo Back End:
- [Alba Marquez](https://github.com/amarinite)
- [Diego Kurcbart](https://github.com/dKurbi)
- [Miguel Granado](https://github.com/Mettanoia)
#### Equipo Front End:
- [Alessandro De Pietri Tonelli](https://github.com/adptCode)
- [Carlos Martinez](https://github.com/carlos-full-stack)
- [Francesc Ferrer](https://github.com/fran-cesc)
- [Yulibeth Rivero](https://github.com/Yul1b3th)
## Contribuciones
Si deseas colaborar en este proyecto o informar sobre problemas, no dudes en
crear un "issue" o enviar un "pull request."