ARCH - Sistema de Gestión de Documentos para Proyectos de Ingeniería

ARCH es un sistema de gestión documental diseñado específicamente para equipos de ingeniería, con el propósito de almacenar, organizar y versionar los archivos críticos de cada proyecto. La aplicación proporciona una estructura jerárquica para proyectos, control de versiones para documentos, y esquemas personalizables según el tipo de proyecto.

Características Principales

• Gestión de Proyectos: Creación y organización jerárquica de proyectos
• Control de Versiones: Histórico completo de todas las versiones de documentos
• Esquemas Personalizables: Definición de tipos de documentos por proyecto
• Sistema de Permisos: Control de acceso granular basado en niveles de usuario
• Arquitectura Simple: Basada en archivos JSON para facilitar el mantenimiento y backups
• Seguridad: Validación de archivos y autenticación de usuarios

Requisitos del Sistema

• Python 3.8 o superior
• Dependencias listadas en requirements.txt
• 500MB de espacio en disco para la instalación inicial

Instalación

1. Clonar el repositorio:

   git clone https://github.com/tu-usuario/arch-document-manager.git
   cd arch-document-manager
   

2. Crear y activar un entorno virtual:

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   venv\Scripts\activate     # Windows
   

3. Instalar dependencias:

   pip install -r requirements.txt
   

4. Inicializar el sistema:

   python init_app.py
   

5. Crear archivo .env con la configuración:

   FLASK_APP=app.py
   FLASK_ENV=development
   SECRET_KEY=clave_secreta_generada_aleatoriamente
   STORAGE_PATH=storage
   

Ejecución

1. Iniciar la aplicación:

   flask run
   

2. Acceder a la aplicación en el navegador:

   http://localhost:5000
   

3. Iniciar sesión con las credenciales por defecto:

   • Usuario: admin
   • Contraseña: admin123

   IMPORTANTE: Cambiar la contraseña del administrador después del primer inicio de sesión.

Estructura de Directorios

document_manager/
│
├── app.py                  # Punto de entrada de la aplicación
├── config.py               # Configuración global
├── requirements.txt        # Dependencias del proyecto
├── README.md               # Este archivo
│
├── services/               # Lógica de negocio
├── utils/                  # Utilidades generales
├── middleware/             # Middleware para Flask
├── routes/                 # Endpoints de la API
├── static/                 # Archivos estáticos (CSS, JS)
├── templates/              # Plantillas HTML
├── tests/                  # Pruebas unitarias
└── storage/                # Almacenamiento de datos

Niveles de Usuario

• Nivel 0-999: Usuario básico (solo lectura)
• Nivel 1000-4999: Editor (puede subir documentos)
• Nivel 5000-8999: Gestor (puede crear y editar proyectos)
• Nivel 9000-9999: Administrador (acceso completo al sistema)

Backups

Se recomienda realizar backups regulares del directorio storage/:

# Script simple de backup
tar -czf backup-$(date +%Y%m%d).tar.gz storage/

Soporte

Si encuentra algún problema o tiene alguna sugerencia, por favor abra un issue en el repositorio del proyecto.

Licencia

Este proyecto está licenciado bajo los términos de la licencia MIT.

Running Tests

To run the test suite:

Credenciales de acceso por defecto:
    Usuario: admin
    Contraseña: admin123