chore: archivos de comunidad (contributing, security, plantillas de issue/PR)

Completa el checklist de Community Standards de GitHub.

Author: webrek

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,41 @@
+name: Bug report
+description: Report a problem with the package
+labels: ["bug"]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you expect, and what did you get instead?
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Roles / permissions logic
+        - MongoDB backend / queries
+        - Middleware / gates / Blade directives
+        - Migrations / seeding
+        - Docs
+    validations:
+      required: true
+  - type: input
+    id: package-version
+    attributes:
+      label: Package version
+    validations:
+      required: true
+  - type: input
+    id: php-laravel
+    attributes:
+      label: PHP and Laravel version
+    validations:
+      required: true
+  - type: input
+    id: mongo-version
+    attributes:
+      label: MongoDB version
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/webrek/laravel-mongo-permission/security/advisories/new
+    about: Please report security issues privately, not as public issues.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,22 @@
+name: Feature request
+description: Suggest an idea for the package
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem would this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+<!-- Describe what this PR changes and why. -->
+
+## Summary
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation
+
+## Checklist
+
+- [ ] `vendor/bin/phpunit` passes locally (with MongoDB running)
+- [ ] `vendor/bin/phpstan analyse` passes (level 5)
+- [ ] Added or updated tests
+- [ ] Updated `CHANGELOG.md`

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contribuir
+
+Gracias por tomarte el tiempo de contribuir.
+
+## Para empezar
+
+```bash
+git clone https://github.com/webrek/laravel-mongo-permission
+cd laravel-mongo-permission
+composer install
+```
+
+Necesitas la extensión `mongodb` de PHP y un MongoDB corriendo. Las pruebas se
+conectan usando estas variables de entorno (con estos valores por defecto):
+
+```bash
+export MONGO_DB_HOST=127.0.0.1
+export MONGO_DB_PORT=27017
+export MONGO_DB_DATABASE=permission_test
+```
+
+## Antes de abrir un pull request
+
+CI corre las pruebas en toda la matriz de PHP (8.2–8.5) y Laravel (12 y 13),
+más análisis estático y pruebas de mutación. Localmente:
+
+```bash
+vendor/bin/phpunit                                        # pruebas
+vendor/bin/phpstan analyse --memory-limit=1G              # análisis estático (nivel 5)
+vendor/bin/infection --threads=max                        # pruebas de mutación
+```
+
+## Lineamientos
+
+- Mantén los _pull requests_ enfocados; un cambio lógico por PR.
+- Agrega o actualiza pruebas para cualquier cambio de comportamiento. Las
+  correcciones de errores deben venir con una prueba que falle antes del arreglo.
+- Que PHPStan siga pasando sin bajar el nivel.
+- Actualiza `CHANGELOG.md` bajo el encabezado `Unreleased`.

SECURITY.md

@@ -0,0 +1,15 @@
+# Política de seguridad
+
+## Versiones soportadas
+
+La última versión menor publicada recibe correcciones de seguridad.
+
+## Reportar una vulnerabilidad
+
+Por favor no abras un _issue_ público para problemas de seguridad. Repórtalos de
+forma privada a través del
+[formulario de avisos de seguridad de GitHub](https://github.com/webrek/laravel-mongo-permission/security/advisories/new).
+
+Puedes esperar una primera respuesta en unos pocos días hábiles. Una vez lista
+la corrección, se publica una versión parchada y el aviso se divulga dando
+crédito a quien lo reportó, salvo que prefiera el anonimato.