moox

Proyecto Moox

Bienvenido al Proyecto Moox. Esta es una aplicación Laravel instalable y Monorepo para desarrollar nuestros complementos de filamentos, también conocidos como paquetes Laravel. Estamos en una etapa inicial de desarrollo, pero ya existen algunos complementos que podrías considerar útiles:

Paquetes

• Moox Skeleton, nuestro paquete Skeleton para crear nuevos complementos de filamentos
• Moox Builder, nuestro paquete Builder para crear recursos de filamentos
• Moox Core, requerido por todos nuestros paquetes, incluye elementos comunes
• Moox Jobs, gestiona colas de trabajos, trabajos fallidos y lotes en Filament

Algunos están en uso productivo pero aún no están documentados:

• Moox Expiry, define y automatiza la caducidad de tus registros
• Dispositivo de usuario Moox, administra los dispositivos de tus usuarios y decide cómo manejar lo desconocido
• Sesión de usuario de Moox, gestiona la sesión de tus usuarios (también en el contexto de los dispositivos)

Todos los demás paquetes están en pleno desarrollo:

• Moox Audit, registro y auditoría, relacionados con la seguridad y relacionados con el modelo
• Moox Flags, Flags contiene íconos Blade para países, idiomas y más
• Moox Locate, países, idiomas, monedas, prefijos de países, zonas horarias
• Enlace de inicio de sesión de Moox, envíe enlaces de inicio de sesión (también conocidos como enlaces mágicos) a sus usuarios
• Página de Moox, gestión de contenidos, actualmente abandonada ya que usamos Prensa
• Moox Passkey, ofrece a los usuarios la posibilidad de utilizar claves de acceso (Webauthn)
• Moox Permission, gestiona roles y permisos usando Spatie Permission
• Moox Press, usa WordPress sin usar WordPress, en Filament
• Moox Redis Model, use Redis como reemplazo de complemento para sus modelos
• Moox Security, gestiona la seguridad de tus contraseñas y otras funciones de seguridad
• Moox Sync, sincroniza registros de servidor a servidor, agrega lógica y transformadores
• Moox Trainings, automatiza formaciones, invitaciones y autovalidación
• Usuario Moox, gestiona tus usuarios en Filament y dales acceso a su perfil

Y hay algunas otras cosas que NO están en este repositorio:

• Moox DevOps, administre sus servidores, sitios e implementaciones de Forge
• Interfaz de usuario del servidor de respaldo Moox, interfaz de usuario de filamento para el servidor de respaldo Spatie Laravel
• Moox VS Code Extensions, nuestro paquete de extensión de código VS para desarrolladores de Filament

Instalación

La aplicación de desarrollo Laravel en la carpeta raíz de Moox Monorepo está diseñada para un desarrollo instantáneo con Laravel Herd, Laravel Valet, Laravel Sail o Laragon.

 # Create a .env file and adjust to your needs
cp .env.example .env

# Don't forget to create the database according .env

# Install via Composer
composer install

# Migrate and seed
php artisan migrate:fresh --seed

# Use Vite (for Laravel Sail on Windows: do it in Ubuntu, not inside the Sail container)
npm install
npm run dev

Cosas opcionales:

 # You can create a user then
php artisan make:filament-user

# You can use the custom composer.json
cp _custom/composer.json-example _custom/composer.json

# Run Sail (alternatively start Herd,Laragon or Valet)
./vendor/bin/sail up

# Rebuild the sail config if needed
./vendor/bin/sail down --rmi all -v
php artisan sail:install

# Remove broken symlinks if needed
# switching from Laragon to Sail for example
rm -Rf vendor/mooxphp

El administrador de Moox ahora está disponible en /moox, por ejemplo, https://moox.test/moox

Prensa Moox

Para instalar Moox Press, necesita un WordPress ejecutándose en /public/wp (u otro subdirectorio, configurado en .env).

Instalar un WordPress nuevo

Para instalar un WordPress nuevo, proporcionamos un comando artesanal, que se envía con el paquete Moox Press:

php artisan mooxpress:wpinstall

El comando necesita cierta optimización y se ejecuta sólo "la mitad" en Windows.

Paquetes personalizados

Nuestro Monorepo está preparado para ser un doble agente:

• Desarrollar un proyecto público o privado.
• mientras contribuye al proyecto Moox

Esto se hace admitiendo paquetes personalizados en la aplicación de desarrollo de nuestro Monorepo. ¿Suena interesante? Lea en _custom/README.md.

Desarrollo

• Ejecute npm run build antes de confirmar porque las pruebas automatizadas en GitHub necesitan un manifiesto de vite que funcione
• ¿ php artisan migrate --database=sqlite para reflejar los cambios en la base de datos de prueba?
• Utilice https://marketplace.visualstudio.com/items?itemName=adrolli.tallui-laravel-livewire-tailwind con VS Code
• Utilice https://github.com/mooxphp/builder para crear sus propios paquetes
• Consulte CONTRIBUCIÓN para obtener más detalles.

Derivación

• main es la versión estable actual, protegida contra ramas, confirma automáticamente todos los paquetes, implementada en li
• feature/... prefije todas las ramas de características, cree sus solicitudes de extracción directamente en la página principal

Utilice ramas basadas en problemas, antepongales feature/ (por ejemplo, feature/38-welcome-view) para pruebas automatizadas y análisis de código.

Se compromete

Sus mensajes de confirmación se fusionarán en Changelog.md, lo que significa que pasarán a formar parte de la documentación. Por favor, asegúrese de

• Comience con uno de estos tipos.
  • Bump = cambio de versión menor, mayor si se usa como Bump!
  • Limpiar = eliminar cosas antiguas o código no utilizado
  • Deps = cambiar dependencias
  • Devops = GH y automatización
  • Documentos = documentación
  • Hazaña = característica
  • Arreglar = corrección de errores
  • Idioma = traducción
  • Pruebas = pruebas de escritura
  • Wip = trabajo en progreso
• para cambios importantes agregue "!" a cualquier tipo para crear un lanzamiento importante
• seguido del nombre corto del paquete, en []
  • Todos: varios o todos los paquetes
  • Repo - cosas Monorepo
  • Centro
  • Constructor
  • Empleos
  • ...
• hacer referencia a un problema, vinculado por número de problema, por ejemplo, #138
• prepare el cierre automático del problema usando "Cerrar #138"

Ejemplos válidos

• Wip[Core]: Feature register assets wip #123
• Fix[All]: Update all packages Close #321
• Feat[Monorepo]: Update dev app Close #22
• Bump![ChartComponents]: Major Updates
• Feat![PackageBuilder]: This will become a major release #23

Lea más sobre las confirmaciones convencionales.

Solicitudes de extracción

Cree un PR para main . Utilice confirmaciones convencionales como se explicó anteriormente.

Semver

Usamos versiones semánticas, escritas como 1.2.3 para

1. Lanzamientos importantes
2. Lanzamientos menores
3. Lanzamientos de corrección de errores

Visite Semver.org para obtener más información.

Lanzamientos

Actualmente se realiza manualmente, pero está en camino una función de liberación automática.

Pruebas

Probamos Moox usando:

• Monorepo
  • Larastan, PHPStan Nivel 5
  • Pinta de Laravel, reparador de PHP CS
  • Codacy y clima de código
• Paquetes
  • Larastan, PHPStan Nivel 5
  • Pinta de Laravel, reparador de PHP CS
  • Parásito

Asegúrese de utilizar las mismas herramientas en VS Code (nuestro paquete de extensión de VS Code cubre esto) o realice las comprobaciones manualmente antes de comprometerse con la rama de desarrollo:

• PHPStan: composer analyse o ./vendor/bin/phpstan analyse , para paquetes ../../vendor/bin/phpstan analyse
• Pest: composer test o ./vendor/bin/pest , para paquetes ../../vendor/bin/pest
• Cobertura: composer test-coverage o ./vendor/bin/pest --coverage , para paquetes ../../vendor/bin/pest --coverage
• Pint: composer format o ./vendor/bin/pint , para paquetes ../../vendor/bin/pint

Navegación de administrador

Los títulos y la clasificación en el AdminPanel se pueden ajustar en las configuraciones de los paquetes, pero esta es la clasificación predeterminada que mantiene todo en su lugar:

 - Dashboard
- Main - 1000
    - Expiry - 1100
    - Notifications - 1800
- Content - 2000
    - Posts - 2100
    - Pages - 2200
    - Media - 2300
    - Categories - 2400
    - Tags - 2500
    - Comments - 2600
- Custom - 3000
    - ...
- Meta - 4000
    - Wp Meta...
- Custom - 5000
    - ...
- Users - 6000
    - App users - 6010 (Moox Users, Moox Press Users 6015)
    - Site users - 6020
    - Customers - 6030
    - Registrations - 6100
    - Roles - 6200
    - Permissions - 6201
    - Devices - 6300
    - Sessions - 6400
    - Login-Links - 6500
    - Password-Tokens - 6600
    - Passkeys - 6700
- System - 7000
    - Audit - 7500
    - Options (Press) - 7900
- Jobs - 8000
    - Job manager - 8001
    - ...
- Tools - 9000
    - Sync - 9500
    - Backup - 9800
    - Builder - 9990

Colaboradores

Moox está hecho por estas buenas personas y bots...

Alf Drollinger ? ? ?️	Aziz Gasim ?️	kimspeer ?️	Weblate (bot) ?	Robot Moox ?	Jesse Reinhold	Morlock ? ?
Sam Bola ?	Kim Speer ?️ ️	Cambio de Laravel ?	mikagrich	somogyi.zoltan	Igor Clauss	Greg RG
Allan Nordhøy ?	Jana Brot	Milo Ivir ?	mika	Todos los contribuyentes ?	Freek Van der Herten ?	renovar[bot] ?
acciones de github [bot] ?	robot dependiente[bot] ?	Mikachu	simón	Kalpesh Mahida	Rowlin	Mark van den Broek
Sebastián De Deyne	Peter Forret	Ettore Atalan ?	p-paul	Salh

Esta tabla es generada por All Contributors Bot. Para agregar contribuyentes utilice el siguiente comando en cualquier comentario de un problema o PR:

@all-contributors please add @github-user for code

Normalmente utilizamos "código" y "traducción", pero existen otros tipos posibles enumerados en AllContributers.org. Realice solo una solicitud a la vez, ya que nos encontraremos con conflictos de fusión si intenta agregar varios contribuyentes sin fusionar el RP en el medio.

Contribuir

¡Agradecemos cada contribución! Sería fantástico si:

• Cree un problema en el repositorio que mejor se adapte y agregue información sobre el problema o la idea. Le responderemos en un par de días.
• Crea una solicitud de extracción en este Monorepo. No haga relaciones públicas con nuestros repositorios de solo lectura, no están preparados para cambios de código. Sólo el monorepo cuenta con puertas de calidad y pruebas automatizadas.
• Traduce Moox usando Weblate.
• Cuéntele a otras personas sobre Moox o enlácenos con nosotros.
• Considere una donación o patrocinio.

Traducción

Moox se traduce con Weblate. Por supuesto, también puedes editar directamente los archivos de traducción en los paquetes, pero usar una plataforma de traducción con todas las funciones como Weblate podría ser más conveniente.

Licencia

Moox es un software gratuito de código abierto con licencia MIT.

Algunos de los proyectos de los que dependemos se publican bajo una licencia diferente. Hacemos todo lo posible para asegurarnos de que estas licencias permitan el uso tanto privado como comercial y no impongan ninguna restricción.

Si nota algún problema con la licencia de Moox o cualquier dependencia, envíenos un correo electrónico a [email protected].

Seguridad

Como se mencionó anteriormente, utilizamos verificaciones de código automatizadas y auditorías de seguridad para garantizar que nuestro código esté libre de vulnerabilidades de seguridad.

Lea nuestra Política de seguridad para obtener más información sobre la seguridad o informar una posible vulnerabilidad. NO utilice el rastreador de problemas para informar problemas relacionados con la seguridad.