files-server-fastapi 0.1.0__py3-none-any.whl

files_server_fastapi/__init__.py

@@ -0,0 +1,20 @@
+# files_server_fastapi/__init__.py
+# Exporta todos los routers para que main.py pueda importarlos directamente.
+
+from files_server_fastapi.routers import (
+    area_router,
+    rol_router,
+    rutas_router,
+    permisos_router,
+    users_extend_router,
+    files_router,
+)
+
+__all__ = [
+    "area_router",
+    "rol_router",
+    "rutas_router",
+    "permisos_router",
+    "users_extend_router",
+    "files_router",
+]

files_server_fastapi/models/__init__.py

@@ -0,0 +1,16 @@
+# models/__init__.py
+from .area_model import Area
+from .rol_model import Rol
+from .rutas_model import Rutas
+from .permisos_model import Permisos, Permiso_user, Permiso_rol
+from .users_extend_model import Users_extend
+
+__all__ = [
+    "Area",
+    "Rol",
+    "Rutas",
+    "Permisos",
+    "Permiso_user",
+    "Permiso_rol",
+    "Users_extend",
+]

files_server_fastapi/models/area_model.py

@@ -0,0 +1,10 @@
+from typing import Optional
+from sqlmodel import Field
+from oauth2fast_fastapi import AuthModel
+
+class Area(AuthModel, table=True):
+    __tablename__ = "area"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    area_name: str = Field(nullable=False)
+    description: Optional[str] = Field(default=None)

files_server_fastapi/models/permisos_model.py

@@ -0,0 +1,31 @@
+from typing import Optional
+from sqlmodel import Field
+from oauth2fast_fastapi import AuthModel
+
+# Catálogo principal de permisos
+class Permisos(AuthModel, table=True):
+    __tablename__ = "permisos"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    permiso_name: str = Field(nullable=False)
+    description: Optional[str] = Field(default=None)
+
+
+# Tabla intermedia: Permisos por Usuario
+class Permiso_user(AuthModel, table=True):
+    __tablename__ = "permiso_user"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    id_user: int = Field(foreign_key="users.id")
+    id_permiso: int = Field(foreign_key="permisos.id")
+    ruta_id: int = Field(foreign_key="rutas.id")
+
+
+# Tabla intermedia: Permisos por Rol
+class Permiso_rol(AuthModel, table=True):
+    __tablename__ = "permiso_rol"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    id_rol: int = Field(foreign_key="rol.id")
+    id_permiso: int = Field(foreign_key="permisos.id")
+    ruta_id: int = Field(foreign_key="rutas.id")

files_server_fastapi/models/rol_model.py

@@ -0,0 +1,14 @@
+from typing import Optional
+from datetime import datetime, timezone
+from sqlmodel import Field
+from oauth2fast_fastapi import AuthModel
+
+def get_utc_now():
+    return datetime.now(timezone.utc)
+
+class Rol(AuthModel, table=True):
+    __tablename__ = "rol"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    role_name: str = Field(nullable=False)
+    description: Optional[str] = Field(default=None)

files_server_fastapi/models/rutas_model.py

@@ -0,0 +1,16 @@
+from typing import Optional
+from sqlmodel import Field
+from oauth2fast_fastapi import AuthModel
+
+class Rutas(AuthModel, table=True):
+    __tablename__ = "rutas"
+    
+    id: Optional[int] = Field(default=None, primary_key=True)
+    ruta: str = Field(nullable=False)
+    name: str = Field(nullable=False)
+    
+    # Llave foránea hacia Area
+    area_id: int = Field(foreign_key="area.id")
+    
+    # Auto-referencia para sub-rutas (puede ser nula si es ruta principal)
+    ruta_id: Optional[int] = Field(default=None, foreign_key="rutas.id")

files_server_fastapi/models/users_extend_model.py

@@ -0,0 +1,11 @@
+from sqlmodel import Field
+from oauth2fast_fastapi import AuthModel
+
+class Users_extend(AuthModel, table=True):
+    __tablename__ = "users_extend"
+    
+    # Es Primary Key y Foreign Key al mismo tiempo (Relación 1 a 1)
+    user_id: int = Field(primary_key=True, foreign_key="users.id")
+    
+    area_id: int = Field(foreign_key="area.id")
+    rol_id: int = Field(foreign_key="rol.id")

files_server_fastapi/routers/__init__.py

@@ -0,0 +1,16 @@
+# routers/__init__.py
+from files_server_fastapi.routers import area_router
+from files_server_fastapi.routers import rol_router
+from files_server_fastapi.routers import rutas_router
+from files_server_fastapi.routers import permisos_router
+from files_server_fastapi.routers import users_extend_router
+from files_server_fastapi.routers import files_router
+
+__all__ = [
+    "area_router",
+    "rol_router",
+    "rutas_router",
+    "permisos_router",
+    "users_extend_router",
+    "files_router",
+]

files_server_fastapi/routers/area_router.py

@@ -0,0 +1,26 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+from pgsqlasync2fast_fastapi.dependencies import get_db_session
+from files_server_fastapi.models.area_model import Area
+
+router = APIRouter(prefix="/areas", tags=["Gestión de Áreas"])
+
+@router.post("/", response_model=Area, summary="Crear una nueva Área")
+async def create_area(area: Area, db: AsyncSession = Depends(get_db_session)):
+    """
+    Guarda una nueva área en la base de datos.
+    """
+    db.add(area)
+    await db.commit()
+    await db.refresh(area)
+    return area
+
+@router.get("/", response_model=list[Area], summary="Obtener todas las Áreas")
+async def get_areas(db: AsyncSession = Depends(get_db_session)):
+    """
+    Devuelve la lista de todas las áreas registradas.
+    """
+    result = await db.execute(select(Area))
+    return result.scalars().all()

files_server_fastapi/routers/files_router.py

@@ -0,0 +1,123 @@
+import os
+from fastapi import APIRouter, HTTPException
+from datetime import datetime
+from pydantic import BaseModel
+
+router = APIRouter(prefix="/files", tags=["Archivos del Sistema"])
+
+# Directorio maestro (La ruta de red de Samba vista desde Windows)
+BASE_DIR = r"\\192.168.1.122\Compartido"
+
+@router.get("/list", summary="Listar archivos de una carpeta")
+async def list_directory(area: str, subpath: str = "/"):
+    # Seguridad básica: Evitar que un hacker suba de nivel con "../"
+    if ".." in subpath:
+        raise HTTPException(status_code=400, detail="Ruta inválida")
+        
+    safe_subpath = subpath.strip("/")
+    
+    if safe_subpath == "":
+        ruta_real = os.path.join(BASE_DIR, area.upper())
+    else:
+        ruta_real = os.path.join(BASE_DIR, area.upper(), safe_subpath)
+    
+    if not os.path.exists(ruta_real):
+        return []
+        
+    if not os.path.isdir(ruta_real):
+        raise HTTPException(status_code=400, detail="La ruta no es un directorio")
+
+    items = []
+    try:
+        with os.scandir(ruta_real) as ficheros:
+            for fichero in ficheros:
+                info = fichero.stat()
+                fecha_mod = datetime.fromtimestamp(info.st_mtime).strftime("%Y-%m-%d %H:%M")
+                
+                if fichero.is_dir():
+                    items.append({
+                        "name": fichero.name,
+                        "type": "folder",
+                        "updated": fecha_mod,
+                        "size": "",
+                        "locked": False
+                    })
+                else:
+                    size_kb = info.st_size / 1024
+                    size_str = f"{size_kb:.1f} KB" if size_kb < 1024 else f"{size_kb/1024:.1f} MB"
+                    items.append({
+                        "name": fichero.name,
+                        "type": "file",
+                        "updated": fecha_mod,
+                        "size": size_str,
+                        "locked": False
+                    })
+        
+        items.sort(key=lambda x: (x["type"] == "file", x["name"].lower()))
+        return items
+        
+    except PermissionError:
+        raise HTTPException(status_code=403, detail="Acceso denegado por el sistema operativo")
+
+
+# ==========================================
+# RUTAS: CREAR CARPETAS
+# ==========================================
+
+class FolderCreate(BaseModel):
+    area: str
+    subpath: str
+    folder_name: str
+
+@router.post("/folder", summary="Crear una nueva carpeta en el servidor")
+async def create_folder(req: FolderCreate):
+    if ".." in req.subpath or ".." in req.folder_name or "/" in req.folder_name:
+        raise HTTPException(status_code=400, detail="Nombre de carpeta o ruta inválida")
+
+    safe_subpath = req.subpath.strip("/")
+    
+    if safe_subpath == "":
+        ruta_final = os.path.join(BASE_DIR, req.area.upper(), req.folder_name)
+    else:
+        ruta_final = os.path.join(BASE_DIR, req.area.upper(), safe_subpath, req.folder_name)
+
+    try:
+        os.makedirs(ruta_final, exist_ok=False)
+        return {"message": "Carpeta creada exitosamente", "path": ruta_final}
+    except FileExistsError:
+        raise HTTPException(status_code=400, detail="Ya existe una carpeta con ese nombre aquí")
+    except PermissionError:
+        raise HTTPException(status_code=403, detail="El servidor rechazó el permiso de escritura")
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ==========================================
+# RUTA: ESCANEAR EL ÁRBOL DE CARPETAS
+# ==========================================
+
+def get_directory_tree(path_to_scan, base_name=""):
+    """Función recursiva de Python para leer subcarpetas"""
+    tree = []
+    try:
+        with os.scandir(path_to_scan) as entries:
+            for entry in entries:
+                if entry.is_dir():
+                    relative_path = os.path.join(base_name, entry.name).replace("\\", "/")
+                    tree.append({
+                        "name": entry.name,
+                        "path": f"/{relative_path}",
+                        "children": get_directory_tree(entry.path, relative_path)
+                    })
+    except PermissionError:
+        pass
+    return sorted(tree, key=lambda x: x["name"].lower())
+
+@router.get("/tree", summary="Obtener el árbol de carpetas de un área")
+async def get_area_tree(area: str):
+    area_path = os.path.join(BASE_DIR, area.upper())
+    
+    if not os.path.exists(area_path):
+        return []
+
+    return get_directory_tree(area_path)

files_server_fastapi/routers/permisos_router.py

@@ -0,0 +1,36 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+from pgsqlasync2fast_fastapi.dependencies import get_db_session
+from files_server_fastapi.models.permisos_model import Permisos, Permiso_user, Permiso_rol
+
+router = APIRouter(prefix="/permisos", tags=["Gestión de Permisos"])
+
+# --- Catálogo Maestro ---
+@router.post("/", response_model=Permisos, summary="Crear Permiso Maestro")
+async def create_permiso(permiso: Permisos, db: AsyncSession = Depends(get_db_session)):
+    db.add(permiso)
+    await db.commit()
+    await db.refresh(permiso)
+    return permiso
+
+@router.get("/", response_model=list[Permisos], summary="Ver Permisos Maestros")
+async def get_permisos(db: AsyncSession = Depends(get_db_session)):
+    result = await db.execute(select(Permisos))
+    return result.scalars().all()
+
+# --- Asignaciones Intermedias ---
+@router.post("/asignar-usuario", response_model=Permiso_user, summary="Asignar permiso a un Usuario")
+async def assign_user(permiso: Permiso_user, db: AsyncSession = Depends(get_db_session)):
+    db.add(permiso)
+    await db.commit()
+    await db.refresh(permiso)
+    return permiso
+
+@router.post("/asignar-rol", response_model=Permiso_rol, summary="Asignar permiso a un Rol")
+async def assign_rol(permiso: Permiso_rol, db: AsyncSession = Depends(get_db_session)):
+    db.add(permiso)
+    await db.commit()
+    await db.refresh(permiso)
+    return permiso

files_server_fastapi/routers/rol_router.py

@@ -0,0 +1,20 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+from pgsqlasync2fast_fastapi.dependencies import get_db_session
+from files_server_fastapi.models.rol_model import Rol
+
+router = APIRouter(prefix="/roles", tags=["Gestión de Roles"])
+
+@router.post("/", response_model=Rol, summary="Crear un nuevo Rol")
+async def create_rol(rol: Rol, db: AsyncSession = Depends(get_db_session)):
+    db.add(rol)
+    await db.commit()
+    await db.refresh(rol)
+    return rol
+
+@router.get("/", response_model=list[Rol], summary="Obtener todos los Roles")
+async def get_roles(db: AsyncSession = Depends(get_db_session)):
+    result = await db.execute(select(Rol))
+    return result.scalars().all()

files_server_fastapi/routers/rutas_router.py

@@ -0,0 +1,20 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+from pgsqlasync2fast_fastapi.dependencies import get_db_session
+from files_server_fastapi.models.rutas_model import Rutas
+
+router = APIRouter(prefix="/rutas", tags=["Gestión de Rutas"])
+
+@router.post("/", response_model=Rutas, summary="Registrar una Ruta")
+async def create_ruta(ruta: Rutas, db: AsyncSession = Depends(get_db_session)):
+    db.add(ruta)
+    await db.commit()
+    await db.refresh(ruta)
+    return ruta
+
+@router.get("/", response_model=list[Rutas], summary="Obtener todas las Rutas")
+async def get_rutas(db: AsyncSession = Depends(get_db_session)):
+    result = await db.execute(select(Rutas))
+    return result.scalars().all()

files_server_fastapi/routers/users_extend_router.py

@@ -0,0 +1,33 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+from pgsqlasync2fast_fastapi.dependencies import get_db_session
+from files_server_fastapi.models.users_extend_model import Users_extend
+
+router = APIRouter(prefix="/users-extend", tags=["Extensión de Usuarios"])
+
+@router.post("/", response_model=Users_extend, summary="Vincular Usuario con Área y Rol")
+async def create_user_extend(user_ext: Users_extend, db: AsyncSession = Depends(get_db_session)):
+    db.add(user_ext)
+    await db.commit()
+    await db.refresh(user_ext)
+    return user_ext
+
+@router.get("/", response_model=list[Users_extend], summary="Ver vínculos de usuarios")
+async def get_users_extend(db: AsyncSession = Depends(get_db_session)):
+    result = await db.execute(select(Users_extend))
+    return result.scalars().all()
+
+# ==========================================
+# RUTA: Buscar Rol y Área por user_id
+# ==========================================
+@router.get("/by-user/{user_id}", summary="Obtener Área y Rol de un Usuario específico")
+async def get_user_permissions(user_id: int, db: AsyncSession = Depends(get_db_session)):
+    result = await db.execute(select(Users_extend).where(Users_extend.user_id == user_id))
+    user_ext = result.scalars().first()
+    
+    if not user_ext:
+        return {"role_id": None, "area_id": None}
+    
+    return {"role_id": user_ext.rol_id, "area_id": user_ext.area_id}

files_server_fastapi-0.1.0.dist-info/METADATA

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: files-server-fastapi
+Version: 0.1.0
+Summary: Este repositorio es un paquete python desarrollado con FastAPI, gestiona la comunicación con un servidor Samba y utiliza PostgreSQL para administrar rutas de archivos y el control de acceso basado en roles (RBAC) de los usuarios.
+Project-URL: Homepage, https://github.com/AldoBP/files-server-fastapi
+Project-URL: Repository, https://github.com/AldoBP/files-server-fastapi
+Project-URL: Issues, https://github.com/AldoBP/files-server-fastapi/issues
+Author: Aldo Blancas
+License: MIT License
+        
+        Copyright (c) 2026 Aldo Blancas
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: fastapi,fileserver,postgresql,rbac,samba
+Classifier: Framework :: FastAPI
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Requires-Dist: oauth2fast-fastapi==0.2.2
+Description-Content-Type: text/markdown
+
+# files-server-fastapi
+Este repositorio es un paquete python desarrollado con FastAPI, gestiona la comunicación con un servidor Samba y utiliza PostgreSQL para administrar rutas de archivos y el control de acceso basado en roles (RBAC) de los usuarios.

files_server_fastapi-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+files_server_fastapi/__init__.py,sha256=Q0cbh7qIDBh-5pTMdXsT0AlAYpF34AUmH5x_Z6YGFgI,415
+files_server_fastapi/models/__init__.py,sha256=CDgpF4fYMOxnPhmfhvFKOrBX5Wx2sK-33p5WsEJJubQ,343
+files_server_fastapi/models/area_model.py,sha256=H1gQGBitF_NKyWYb5VvP5gzCMz3cq1Y-niD8qmJpJTQ,322
+files_server_fastapi/models/permisos_model.py,sha256=1K55EXIAfztS1h7V71XdDidvLm1GoKtxvDCwKyjpsfw,1040
+files_server_fastapi/models/rol_model.py,sha256=_s2-GvELyKkO8MOcNkBBLDXh7uqhD02r5QxvkTJbVkI,418
+files_server_fastapi/models/rutas_model.py,sha256=F9yw-QRC5Kxppe0mVsV-_4o1fw3w2ePcdbPNIOBck4A,542
+files_server_fastapi/models/users_extend_model.py,sha256=ymxq7uyL6NIdPdtEDSrRBm8r9FEpTUJgwuMVXq-hrpA,387
+files_server_fastapi/routers/__init__.py,sha256=C3McTrLaCU4aGilI_1LppwXxuGMbHHTkHDV4RMmHCVc,495
+files_server_fastapi/routers/area_router.py,sha256=zhiwqdoP8zji5I-yWT8M59G8KXfIJdi8wvW_MiNm5Yo,897
+files_server_fastapi/routers/files_router.py,sha256=oXGfaPmdGNab3d9BKdh-JIBkKimhaFWbbgVFrJ_11NY,4532
+files_server_fastapi/routers/permisos_router.py,sha256=t2EbZfdfIDZbHMIdYaXTLMfNRxduprcgEJPIeVe4Mug,1453
+files_server_fastapi/routers/rol_router.py,sha256=X1kUaeXTxpW6mdVvyEiPhuJI03jdy72fI3m3XbRfpCA,746
+files_server_fastapi/routers/rutas_router.py,sha256=5lc32V1hYFcIF9YE-W9tuPjgEXcQ3uVtSw-z8Ibr9xo,763
+files_server_fastapi/routers/users_extend_router.py,sha256=lLfa1skH0kk4tcZbDm-DGMgtLG39pvKHYvkTmH09xrk,1455
+files_server_fastapi-0.1.0.dist-info/METADATA,sha256=rGI-viKWMsRo4MJ4FFUcboqlIvFpQ4v-fapNXiuAGVc,2396
+files_server_fastapi-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+files_server_fastapi-0.1.0.dist-info/licenses/LICENSE,sha256=18y0AU3LAKBdqAnqG_ROAcKOYf6dTXXYRS19tqZrrx4,1069
+files_server_fastapi-0.1.0.dist-info/RECORD,,

files_server_fastapi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

files_server_fastapi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aldo Blancas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.