https://github.com/anchundiatech/medilink-frontend
Frontend del portal de salud MediLink. Construido con React, Vite y Tailwind CSS para una gestión moderna de citas y teleasistencia.
https://github.com/anchundiatech/medilink-frontend
react react-router tailwind-css vite
Last synced: 3 months ago
JSON representation
Frontend del portal de salud MediLink. Construido con React, Vite y Tailwind CSS para una gestión moderna de citas y teleasistencia.
- Host: GitHub
- URL: https://github.com/anchundiatech/medilink-frontend
- Owner: anchundiatech
- Created: 2025-10-04T13:31:27.000Z (9 months ago)
- Default Branch: develop
- Last Pushed: 2025-10-08T22:20:10.000Z (9 months ago)
- Last Synced: 2025-10-12T12:50:02.525Z (9 months ago)
- Topics: react, react-router, tailwind-css, vite
- Language: JavaScript
- Homepage:
- Size: 689 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MediLink-Frontend 🩺✨
Documentación del frontend para la plataforma de telemedicina MediLink.
## Índice
1. [Descripción del Proyecto](#descripción-del-proyecto-️)
2. [Características Principales](#características-principales-)
3. [Tecnologías Utilizadas](#tecnologías-utilizadas-)
4. [Puesta en Marcha](#puesta-en-marcha-)
5. [Estructura del Proyecto](#estructura-del-proyecto-)
6. [Scripts Disponibles](#scripts-disponibles-)
7. [Cómo Contribuir](#cómo-contribuir-)
## Descripción del Proyecto 🗒️
**MediLink** es una plataforma web moderna diseñada para clínicas y centros de salud, con el objetivo de centralizar la gestión de citas, historiales médicos y la comunicación con pacientes. El sistema ofrece dos portales principales: uno para pacientes, enfocado en la autogestión de citas y acceso a su información; y otro para profesionales de la salud, enfocado en la administración de su agenda y la teleasistencia.
El proyecto busca resolver la fragmentación de los sistemas actuales, ofreciendo una experiencia de usuario unificada y segura, con interoperabilidad con sistemas EHR existentes a través del estándar FHIR.
## Características Principales 🚀
- 👤 **Portal de Pacientes:** Agendar, modificar y cancelar citas. Ver historial clínico y recibir recordatorios.
- 👨⚕️ **Portal de Profesionales:** Gestionar agenda con disponibilidad en tiempo real. Consultar historiales y lanzar teleconsultas.
- 🔐 **Autenticación Segura:** Sistema de registro y login con autenticación multifactor y control de permisos por rol.
- 📹 **Teleconsulta Integrada:** Videollamadas y chat seguro directamente en la plataforma.
- 🔄 **Integración con EHR (FHIR):** Capacidad para leer y escribir datos en sistemas de historias clínicas electrónicas compatibles con el estándar FHIR.
- 📱 **Diseño Responsivo:** Experiencia de usuario optimizada para dispositivos móviles, tablets y escritorio bajo el enfoque "Mobile First".
## Tecnologías Utilizadas 🛠️
Este proyecto utiliza un stack moderno y escalable.
## Puesta en Marcha 🏁
Sigue estos pasos para levantar el entorno de desarrollo local.
1. **Clonar el repositorio**
```bash
git clone git@github.com:anchundiatech/MediLink-Frontend.git
cd MediLink-Frontend
```
2. **Instalar dependencias**
Asegúrate de tener [pnpm](https://pnpm.io/installation) instalado.
```bash
pnpm install
```
3. **Configurar variables de entorno**
Crea un archivo `.env` en la raíz del proyecto a partir del archivo de ejemplo `.env.example`.
```bash
cp .env.example .env
```
Luego, edita el archivo `.env` con las URLs de la API y otras claves necesarias.
```env
VITE_API_GATEWAY_URL=http://localhost:3000/api
VITE_SOME_OTHER_KEY=your_key_here
```
4. **Ejecutar el servidor de desarrollo**
```bash
pnpm dev
```
La aplicación estará disponible en `http://localhost:5173` (o el puerto que indique Vite).
## Estructura del Proyecto 📁
El proyecto sigue una estructura organizada por funcionalidades para facilitar la mantenibilidad y escalabilidad.
```
src/
├── assets/ # Imágenes, fuentes y otros activos estáticos
├── components/ # Componentes de UI reutilizables (Botones, Inputs, etc.)
├── config/ # Configuración de la aplicación (ej. Axios, i18n)
├── features/ # Módulos de la aplicación (ej. auth, appointments)
├── hooks/ # Hooks personalizados de React
├── lib/ # Clientes de API, helpers y utilidades
├── pages/ # Vistas principales de la aplicación
├── providers/ # Context Providers de React
├── routes/ # Configuración del enrutado
├── styles/ # Estilos globales
└── App.tsx # Componente raíz de la aplicación
```
## Scripts Disponibles 📜
- `pnpm dev`: Inicia el servidor de desarrollo con Hot-Reload.
- `pnpm build`: Compila la aplicación para producción en la carpeta `dist/`.
- `pnpm lint`: Ejecuta ESLint para analizar el código en busca de errores y problemas de estilo.
- `pnpm preview`: Sirve localmente el contenido de `dist/` para previsualizar la build de producción.
## Cómo Contribuir 🤝
¡Las contribuciones son bienvenidas! Si deseas colaborar, por favor sigue estos pasos:
1. Haz un **Fork** de este repositorio.
2. Crea una nueva rama (`git checkout -b feature/nueva-funcionalidad`).
3. Realiza tus cambios y haz **Commit** (`git commit -m 'Añade nueva funcionalidad'`).
4. Haz **Push** a tu rama (`git push origin feature/nueva-funcionalidad`).
5. Abre un **Pull Request**.
Por favor, asegúrate de que tu código siga las guías de estilo del proyecto y pase el linter.