Saltar a contenido

🛠️ Herramientas de Línea de Comandos

LibreFolio proporciona el script dev.py para tareas de administración. Esta página cubre los comandos más relevantes para los administradores del sistema.

👩‍💻 Para Desarrolladores

Para comandos específicos de desarrollo (construcción del frontend, ejecutor de pruebas, sincronización de API, auditoría de i18n), consulte la Guía de Instalación para Desarrolladores.

🚀 Instalación

Instale todas las dependencias del proyecto (Python y Node.js):

./dev.py install

🖥️ Servidor (Producción)

▶️ Iniciar el Servidor

# Standard start
./dev.py server

# With auto-calculated workers (2 × (CPU-1))
./dev.py server --workers N

# Kill existing process on port before starting
./dev.py server --force

Multi-worker

Para producción, use --workers para ejecutar múltiples workers de Uvicorn. Esto mejora la capacidad de procesamiento y se recomienda para cualquier despliegue con más de 1 núcleo de CPU.

👤 Gestión de Usuarios

La gestión de usuarios se realiza a través de los subcomandos ./dev.py user:

# Create a user (first user becomes admin automatically)
./dev.py user create <username> <email> <password>

# List all users
./dev.py user list

# Reset a user's password
./dev.py user reset <username> <new_password>

# Promote a user to admin
./dev.py user promote <username>

# Demote an admin to regular user
./dev.py user demote <username>

⚙️ Gestión del Sistema

🔧 Inicializar Configuración Global

./dev.py user init-settings

Puebla la base de datos con la Configuración Global predeterminada si esta aún no existe.

🗄️ Migraciones de Base de Datos

# Apply pending migrations
./dev.py db upgrade

🗄️ Reinicio de base de datos

./dev.py db create-clean recrea la base de datos desde cero — se pierden todos los datos. Úselo solo si necesita empezar desde cero.

📚 Documentación

# Build and deploy MkDocs documentation to GitHub Pages
./dev.py mkdocs deploy

# Generate gallery screenshots (requires running server + test data)
./dev.py mkdocs gallery

📋 Árbol Completo de Comandos

Para obtener una lista completa de todos los comandos disponibles:

./dev.py --help

👩‍💻 Comandos de Desarrollador

Comandos adicionales para flujos de trabajo de desarrollo: