FarmaX

Sistema móvil de gestión farmacéutica desarrollado con Ionic y Angular, diseñado para facilitar la administración de medicamentos, clientes, compras, pagos, devoluciones y distribución dentro del ecosistema FarmaX.

La aplicación consume una API REST desarrollada en Yii2, permitiendo la autenticación de usuarios, la gestión de inventario farmacéutico y el control de operaciones comerciales mediante un sistema de roles y permisos.

---

Descripción General

FarmaX Mobile forma parte de una solución integral para la administración farmacéutica y permite gestionar procesos relacionados con:

• Administración de medicamentos.
• Gestión de componentes farmacológicos.
• Clasificación de medicamentos por categorías.
• Gestión de clientes.
• Registro y seguimiento de compras.
• Administración de pagos.
• Gestión de devoluciones.
• Administración de entidades comerciales.
• Gestión geográfica (países, estados, municipios y ciudades).
• Registro y autenticación de usuarios.
• Control de acceso basado en roles.

---

Tecnologías Utilizadas

Frontend

• Ionic 8
• Angular 20
• TypeScript
• SCSS
• Axios
• Capacitor 7

Backend

• Yii2 Framework
• PHP

Base de Datos

• MySQL

---

Requisitos Previos

Antes de ejecutar el proyecto, asegúrate de tener instalado:

Node.js

Se recomienda Node.js 18 o superior.

Verificar instalación:

node -v
npm -v

Instalación de Node.js

Puedes descargar Node.js desde:

https://nodejs.org/

Ionic CLI

Instalar Ionic globalmente:

npm install -g @ionic/cli

Verificar instalación:

ionic --version

Angular CLI (Opcional)

npm install -g @angular/cli

---

Clonar el Proyecto

git clone https://github.com/BlackFenix937/appfarmacia.git

Ingresar al directorio:

cd appfarmacia

---

Instalar Dependencias

npm install

---

Configuración de la API

FarmaX Mobile consume una API REST desarrollada en Yii2.

La URL base de la API se encuentra configurada en:

src/environments/environment.prod.ts

Configuración por defecto:

export const environment = {
  production: true,
  apiUrl: "http://localhost:8080/"
};

Ejecución Local

Si la API se ejecuta en la misma máquina que la aplicación, puedes mantener la configuración predeterminada.

Dispositivo Físico

Si deseas ejecutar la aplicación desde un teléfono o tablet conectado a la misma red, reemplaza localhost por la dirección IP local del servidor.

Ejemplo:

export const environment = {
  production: true,
  apiUrl: "http://192.168.1.100:8080/"
};

Verificaciones Recomendadas

Antes de iniciar la aplicación:

• Verificar que la API Yii2 esté en ejecución.
• Confirmar que la base de datos esté conectada.
• Validar que la URL configurada sea accesible desde el dispositivo.
• Confirmar que el puerto configurado se encuentre disponible.

---

Ejecutar el Proyecto

Iniciar servidor de desarrollo:

ionic serve

La aplicación estará disponible en:

http://localhost:8100

---

Estructura del Proyecto

src/app
│
├── login
├── registro
├── guard
├── services
├── components
│
├── medicamento
├── medicamento-crear
├── medicamento-detalle
│
├── componente
├── componente-crear
│
├── categoria-medicamento
├── categoria-medicamento-crear
├── categoria-medicamento-detalle
│
├── compra
├── compra-crear
├── compra-detalle
│
├── cliente
├── cliente-crear
├── cliente-detalle
│
├── pago
├── pago-crear
├── pago-detalle
│
├── devolucion
├── devolucion-crear
├── devolucion-detalle
│
├── factura
├── factura-detalle
│
├── entidad-comercial
├── entidad-comercial-crear
├── entidad-comercial-detalle
│
├── entidad-medicamento
├── entidad-medicamento-crear
├── entidad-medicamento-detalle
│
├── medicamentocomponente
├── medicamentocomponente-crear
├── medicamentocomponente-detalle
│
├── pais
├── estado
├── municipio
├── ciudad
│
├── tabs
├── tab1
├── tab2
└── tab3

---

Roles del Sistema

Usuario

• Inicio de sesión.
• Consulta de medicamentos.
• Registro de compras.
• Gestión de información personal.

Distribuidor

• Consulta de órdenes asignadas.
• Seguimiento de distribución.
• Actualización de estados de entrega.

Administrador

• Gestión completa de usuarios.
• Administración de medicamentos.
• Gestión de compras.
• Administración de pagos.
• Gestión de devoluciones.
• Administración de entidades comerciales.
• Configuración general del sistema.

---

Backend Requerido

Para el correcto funcionamiento de la aplicación es necesario contar con el proyecto backend FarmaX API desarrollado en Yii2 (farmaceutica).

El backend es responsable de:

• Autenticación de usuarios.
• Gestión de roles.
• Administración de medicamentos.
• Gestión de compras.
• Procesamiento de pagos.
• Persistencia de datos.

Enlace al repositorio del backend

https://github.com/BlackFenix937/farmaceutica

---

Licencia

Este proyecto fue desarrollado con fines académicos y de gestión farmacéutica.

---

Autor

BlackFenix937 || Andy de Jesús González Alcázar

Desarrollado como parte de un sistema integral de gestión farmacéutica basado en Ionic, Angular y Yii2.