Cómo está construido Opplook.

Backend

PHP ^8.4, Laravel ^13.0, Sanctum ^4.3 (Bearer). API-first.

Frontend

Separado en otro repositorio. El anterior (Angular 18) está archivado; hay uno nuevo planificado.

Datos y colas

MySQL en producción, SQLite en tests. Cola con driver database (Redis planificado, sin hacer).

Servicios externos

Stripe (con cliente propio, StripeApiClient), Google Places API (New), Nominatim / OpenStreetMap.

Testing

PHPUnit ^12.5, Paratest y Mockery.

Análisis estático

Larastan nivel 6 sobre app, config, database y routes con baseline, y phpstan-strict.neon nivel 8 sobre los directorios nuevos. phpat para reglas de arquitectura. Laravel Pint.

Los errores de la API usan un envoltorio uniforme {success, code, message} (ApiErrorCode y ApiException). La auditoría web incluye también heurísticas para detectar píxeles de SEM y anuncios en redes, documentadas como tales: son aproximadas.

1. 1

   Composer

   composer validate --strict y composer audit.

2. 2

   Lint

   Pint y comprobación de TODOs.

3. 3

   Stan

   Larastan con las dos configuraciones y un guard que impide que crezca el baseline.

4. 4

   Tests · SQLite

   Suite completa en paralelo.

5. 5

   Tests · MySQL

   Suite completa con migrate:fresh sobre MySQL.

• Larastan nivel 6 con baseline, más nivel 8 estricto en el código nuevo.
• Tests de arquitectura con phpat: los controladores no dependen de infraestructura, HTTP ni base de datos, ni llaman a HTTP o usan sleep directamente.
• Http::preventStrayRequests() falla cualquier llamada HTTP sin simular.

1. El giro del producto

   La propuesta del 14 de septiembre de 2026 cambió Opplook de listas de leads que se desbloqueaban con créditos a una herramienta de ventas por suscripción para agencias de marketing y diseño web y freelancers de España.

   El modelo anterior tenía el cliente equivocado, chocaba con las condiciones de Google Maps Platform (almacenar y exportar contenido de Places), era difícil de poner precio y no tenía puertas de calidad.

2. Puertas de calidad antes que funciones

   La fase 0 fue Pint, Larastan, Paratest, CI y la subida a PHP 8.4 y Laravel 13. El código heredado tenía tests que fallaban y tests que llamaban a la red real, así que no se podía confiar en nada de lo que se construyera encima.

3. Contratos y fakes para cada servicio externo

   Cada servicio externo (GooglePlacesInterface, GeocodingInterface, WebAuditInterface) tiene una gemela Fake* enlazada por configuración. Http::preventStrayRequests() hace fallar cualquier llamada HTTP no simulada en los tests: ninguna prueba toca la red por accidente.

   $fakeMode = config('webaudit.fake_mode', false);$class = $fakeMode ? FakeWebAuditService::class : WebAuditService::class;$this->app->singleton(WebAuditInterface::class, $class);

4. Scoring V2 detrás de un feature flag

   Las dos tablas de pesos, V1 y V2, conviven detrás de SCORING_V2_ENABLED y devuelven la misma forma de API. V2 sube el peso de los fallos detectados en la auditoría web, que son más fáciles de vender que un simple «no tiene web», sin cambiar el contrato.

   'no_website' => 15,                      // Lowered: harder sell than web-audit gaps'no_https' => 30,                        // Raised: SSL upsell is easy + urgent'no_mobile_viewport' => 25,              // Raised: mobile-first is now a baseline requirement'no_analytics' => 22,                    // Raised: GA/GTM pitch — easy and recurring'no_whatsapp' => 18,                     // Raised: primary ES/LATAM contact channel// Señales NEGATIVAS (filtros) - RESTAN puntos'too_many_reviews' => -10,'high_rating' => -5,

5. Idempotencia en la facturación

   Checkout y cancelación usan la cabecera X-Idempotency-Key, y los cambios de créditos pasan por un servicio de libro mayor (ledger). Un reintento no puede cobrar ni descontar dos veces.

6. Una única fuente de verdad para los planes

   Planificado, no hecho: un archivo de configuración con una interfaz de repositorio y una instantánea de derechos por suscripción.