-
Cloná el repo en tu compu: Bajate el proyecto con el comando
git clone https://github.com/Gonzalo2504/ProyectoHtal.git
-
Metete en la carpeta del proyecto:
cd ProyectoHtal -
Configurá la base de datos y el token: Creá un archivo config.py en el root del proyecto y meté las siguientes variables:
DATABASE_URL = "mysql+mysqlconnector://<usuario>:<contrasena>@localhost:3306/<base_de_datos>" SECRET_KEY = "<clave_secreta>" ALGORITHM = "HS256" TOKEN_EXPIRE = 6
-
Armá un entorno virtual:
python3.10 -m venv myvenv
-
Activá el entorno virtual:
-
En Windows:
.\myvenv\Scripts\activate
-
En macOS y Linux:
source myvenv/bin/activate
-
-
Instalá las dependencias del proyecto con este comando:
pip install -r app/requirements.txt
-
Para inicializar la base de datos se debe ejecutar el siguiente comando:
-
Instalar Alembic: Asegúrate de tener Alembic instalado en tu entorno virtual.
pip install alembic
-
Inicializar Alembic: Inicializa el entorno de Alembic en tu proyecto.
alembic init alembic
-
Configurar Alembic: Abrí el archivo
alembic.iniy configura la cadena de conexión a tu base de datos.sqlalchemy.url = mysql+mysqlconnector://<usuario>:<contraseña>@localhost:3306/<nombre_de_la_base_de_datos>En la carpeta /migrations
env.py:from app.models.models import Base target_metadata = Base.metadata -
Generar una Migración: Genera una nueva migración basada en los cambios en tus modelos.
alembic revision --autogenerate -m "crear tabla roles" -
Aplicar la Migración: Aplica las migraciones a tu base de datos.
alembic upgrade head
¡Listo! Con esto la base de datos debería estar creada. Si hay algún problema, fijate en los logs de Alembic.
-
-
Corré el servidor:
uvicorn app.main:app --reload
-
Crear el primer administrador:
-
Editar la ruta de creación de administradores: Abre el archivo
administrador_routes.pyque se encuentra en la carpetaroutesy quita temporalmente elDependsque verifica el rol de usuario en la funcióncreate_administrador.Cambia de esto:
@router.post("/administradores/", response_model=Administrador) def create_administrador(administrador: AdministradorCreate, db: Session = Depends(get_db), current_user: Usuario = Depends(get_user_by_role([1]))): return crud_administradores.create_administrador(db=db, administrador=administrador)
A esto:
@router.post("/administradores/", response_model=Administrador) def create_administrador(administrador: AdministradorCreate, db: Session = Depends(get_db)): return crud_administradores.create_administrador(db=db, administrador=administrador)
-
Crear el primer administrador: Usa una herramienta como
Postmanocurlpara enviar una solicitudPOSTa la ruta/administradores/con los datos necesarios para crear un nuevo administrador.Ejemplo de comando
curl:curl -X POST "http://localhost:8000/administradores/" -H "Content-Type: application/json" -d '{ "nombre": "Admin", "apellido": "Principal", "dni": 12345678, "email": "admin@example.com", "telefono": "1234567890", "usuario": "adminuser", "contrasena": "adminpass", "rol_id": 1 }'
-
Revertir los cambios en
administrador_routes.py: Después de crear el primer administrador, vuelve a colocar el código original enadministrador_routes.pypara reactivar la verificación del rol de usuario:@router.post("/administradores/", response_model=Administrador) def create_administrador(administrador: AdministradorCreate, db: Session = Depends(get_db), current_user: Usuario = Depends(get_user_by_role([1]))): return crud_administradores.create_administrador(db=db, administrador=administrador)
-
Probar las primeras consultas a la API: Con el primer administrador creado, puedes proceder a probar las primeras consultas a la API para asegurarte de que todo funcione correctamente.
-
-
Acceder a la documentación de la API:
Una vez que el servidor esté en ejecución, puedes acceder a la documentación de la API en:
http://localhost:8000/docsEsta documentación es generada automáticamente por FastAPI y te permite interactuar con los endpoints de la API directamente desde el navegador. Puedes probar solicitudes, ver los modelos de datos y explorar todas las rutas disponibles.
-
Después de crear el administrador, se pueden crear pacientes, médicos y enfermeros:
-
Los
rol_idson:1para administradores2para médicos3para enfermeros
-
Para crear estos usuarios, primero debes hacer login en la ruta
/loginutilizando el nombre de usuario y contraseña creados para cada usuario. Esto te proporcionará un token que podrás usar para hacer las solicitudes a las rutas protegidas. -
Ejemplo de solicitud
POSTpara hacer login:curl -X POST "http://localhost:8000/login/" -H "Content-Type: application/json" -d '{ "usuario": "adminuser", "contrasena": "adminpass" }'
-
El login te devolverá un token JWT que debes incluir en el encabezado
AuthorizationcomoBearer <token>para las siguientes solicitudes. -
Ejemplo de cómo usar el token para crear un médico:
curl -X POST "http://localhost:8000/medicos/" -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{ "nombre": "Doctor", "apellido": "Smith", "dni": 87654321, "especialidad": "Cardiología", "email": "doctor@example.com", "telefono": "0987654321", "usuario": "doctoresmith", "contrasena": "docpass" }'
-
Recuerda que la contraseña será hasheada en el backend antes de ser almacenada en la base de datos, asegurando así la seguridad de los datos del usuario.
-
Verificación de roles: En las rutas, asegurate de revisar qué acciones puede realizar cada usuario según su rol_id.
-
¡Listo! Con estos pasos vas a tener el proyecto corriendo y la API en funcionamiento. Si se traba algo, revisá los logs y las rutas para ver qué puede estar fallando. ¡Éxitos!