Metadata-Version: 2.5
Name: files-server-fastapi
Version: 0.1.60
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.4.4
Requires-Dist: psycopg2-binary>=2.9
Requires-Dist: python-dotenv
Requires-Dist: wsgidav>=4.3
Description-Content-Type: text/markdown

# files-server-fastapi

Este repositorio es un paquete Python desarrollado con **FastAPI**. Actúa como un puente integral para la gestión de un servidor de archivos físico (**Samba**) utilizando **PostgreSQL** para administrar la estructura virtual de rutas y el control de acceso basado en roles (RBAC) de los usuarios.

## Características Principales

- **Gestión Avanzada de Usuarios (RBAC)**: Autorización en niveles (Usuarios, Administrador de Área, Administrador Global) para segmentar el acceso a los recursos.
- **Sincronización Transparente Samba/Linux**: Utiliza `setfacl` y `smbpasswd` para traducir los permisos web directamente en la capa de sistema de archivos de Linux.
- **Servidor WebDAV**: Incluye integración nativa vía WSGI con clientes WebDAV.
- **Auditoría y Papelera**: Registro de actividades, archivos recientes y una papelera de reciclaje lógica para evitar pérdida de información.

## Documentación

Para instalar y comprender el funcionamiento interno del paquete, puedes consultar los siguientes documentos:

- 👉 [**Guía de Instalación (Installation Guide)**](docs/installation_guide.md)
- 👉 [**Documentación Técnica Detallada (Technical Reference)**](docs/technical_reference.md)
- 👉 [**Documentación de capa web y samba**](docs/system_architecture_and_samba.md)