Sobre Castris
Demo opensource opinado de facturación electrónica + panel cliente para hosting español.
Castris es una plataforma completa de facturación y panel cliente diseñada específicamente para empresas de hosting en España con cumplimiento fiscal automático (Verifactu AEAT). Sirve simultáneamente como base reutilizable para forks comerciales y como referencia de integración para los paquetes Lara* del ecosistema AichaDigital.
¿Qué es esto y qué no es?
Es una demo. Concretamente:
- Un repositorio público bajo licencia AGPL-3.0 que cualquiera puede clonar, ejecutar y aprender.
- Una referencia de cómo integrar los paquetes Lara* (larabill, lara-verifactu, laratickets, lararoi, lara100) en una app Laravel real.
- El punto de partida (no el producto final) para los forks comerciales
castris.comyaicha.es.
No es:
- Un servicio en producción. No hay infraestructura corriendo, no hay clientes reales, no hay datos personales.
- Un producto SaaS que puedas contratar. La forma de usarlo es desplegarlo tú o forkearlo.
- Una solución certificada lista para empezar a facturar mañana. La integración con AEAT está, pero el setup fiscal serio requiere consultoría.
Stack y arquitectura
- Backend: Laravel 13 + Livewire 4 + PHP 8.4+.
- Frontend: Tailwind CSS 4 con tokens propios
lf-*y 4 temas inlined (cupcake, abyss, corporate, sunset). - Base de datos: MariaDB 10.6+ o MySQL 8+ (UUID v7 universal en toda la app, STD-001 del ecosistema).
- Testing: Pest. Suite actual con cientos de tests Feature + Browser.
- Documentación: ADRs en
docs/architecture/, lecciones endocs/lessons-learned.md, README y CONTRIBUTING al día.
Los paquetes Lara* son repos independientes publicados en Packagist. Las decisiones arquitectónicas que sobrevivieron a la primera versión se conservan en los ADR; las que se revisaron, también, con su superseded explícito.
¿Quién está detrás?
Aicha Digital desarrolla soluciones de facturación electrónica para el mercado español desde 2016. El proyecto está mantenido por Abdelkarim Mateos como single-dev opensource — sin equipo asalariado, sin SLAs, sin promesas. Issues y PRs en GitHub se atienden cuando hay capacidad real.
Cómo contribuir
Lee primero CONTRIBUTING.md. Cubre commit conventions, code style (Pint), análisis estático (PHPStan), testing (Pest) y proceso ADR. Bugs de los paquetes Lara* van en el repo del paquete específico, no aquí.
Contacto
Para asuntos generales: abdelkarim@aichadigital.es. Para reportes de seguridad: ver política de seguridad del repositorio.