docs(adr): propuesta de motor de busqueda y facetas (Fase 5 Etapa 3) #44

2026-08-25T23:10:45Z

devops commented

2026-08-25 23:10:45 +00:00

Etapa 1 (auditoria/propuesta, sin codigo de produccion) de la Etapa 3 de Fase 5, segun lo pedido. NO mergear hasta aprobacion explicita de la propuesta -- Etapa 2 (implementacion) no arranca todavia.

Resumen de lo verificado contra documentacion oficial (no memoria):

Medusa no tiene modulo Meilisearch propio; el Search Module nativo es de Medusa 2.19+. El plugin comunitario @rokmohar/medusa-plugin-meilisearch v2.x requiere esa version. Nuestro backend esta en Medusa 2.18.0 -> version compatible es la linea ^1.4.1 del plugin (Medusa >=2.15 <2.19). Documentado como deuda tecnica si se sube Medusa despues.
Impacto de recursos evaluado contra el estado real del host (swap al 100%, 351MiB libres reales) -- mismo tipo de contencion que el incidente de Gitea. Meilisearch recomendado sobre Typesense por menor huella de RAM y por ser el unico con integracion Medusa mantenida compatible; comparacion breve porque la diferencia ya es decisiva.
Diseno de indexacion, sincronizacion (mismo patron de subscriber por eventos que revalidate-storefront.ts, sumando product-category.*) y UI de facetas/autocompletado (reutiliza catalog-client.tsx y CatalogProvider.searchProducts ya existentes).

ADR nuevo: docs/decisiones/0006-motor-busqueda-facetas.md. Cross-referencia agregada en ADR 0004. Entrada nueva en mkdocs.yml.

Etapa 1 (auditoria/propuesta, sin codigo de produccion) de la Etapa 3 de Fase 5, segun lo pedido. NO mergear hasta aprobacion explicita de la propuesta -- Etapa 2 (implementacion) no arranca todavia. Resumen de lo verificado contra documentacion oficial (no memoria): - Medusa no tiene modulo Meilisearch propio; el Search Module nativo es de Medusa 2.19+. El plugin comunitario `@rokmohar/medusa-plugin-meilisearch` v2.x requiere esa version. Nuestro backend esta en Medusa 2.18.0 -> version compatible es la linea `^1.4.1` del plugin (Medusa >=2.15 <2.19). Documentado como deuda tecnica si se sube Medusa despues. - Impacto de recursos evaluado contra el estado real del host (swap al 100%, 351MiB libres reales) -- mismo tipo de contencion que el incidente de Gitea. Meilisearch recomendado sobre Typesense por menor huella de RAM y por ser el unico con integracion Medusa mantenida compatible; comparacion breve porque la diferencia ya es decisiva. - Diseno de indexacion, sincronizacion (mismo patron de subscriber por eventos que `revalidate-storefront.ts`, sumando `product-category.*`) y UI de facetas/autocompletado (reutiliza `catalog-client.tsx` y `CatalogProvider.searchProducts` ya existentes). ADR nuevo: `docs/decisiones/0006-motor-busqueda-facetas.md`. Cross-referencia agregada en ADR 0004. Entrada nueva en `mkdocs.yml`.

devops added 1 commit 2026-08-25 23:10:45 +00:00

docs(adr): propuesta de motor de busqueda y facetas (Fase 5 Etapa 3)

Build and Push Docs Portal / Escaneo de Secretos (Gitleaks) (pull_request) Successful in 32s

Details

Build and Push Docs Portal / Construir y publicar Docs Portal (pull_request) Skipped

Details

5ce7030c4d

Etapa 1 (auditoria/propuesta, sin codigo) de la Etapa 3 de Fase 5:
motor de busqueda y filtros facetados reales, reemplazando el
filtrado/conteo 100% client-side que dejo la sub-fase 3 de Etapa 2.

Verificado contra documentacion oficial vigente (no memoria de
entrenamiento):
- Medusa no tiene modulo de busqueda propio integrado con
  Meilisearch; el Search Module nativo llego en Medusa 2.19, y el
  plugin comunitario @rokmohar/medusa-plugin-meilisearch se conecta a
  el solo desde su version ^2.0.0 (requiere Medusa >=2.19). Nuestro
  backend corre Medusa 2.18.0 -- la version compatible es la linea
  ^1.4.1 del plugin (Medusa >=2.15 <2.19), documentada como deuda
  tecnica explicita si se sube Medusa mas adelante.
- Impacto de recursos evaluado contra el estado real del host (swap
  al 100%, mismo tipo de contencion que el incidente de Gitea):
  Meilisearch recomendado sobre Typesense por menor huella de RAM y
  por ser el unico con integracion Medusa mantenida para nuestra
  version -- comparacion mantenida breve porque la diferencia es
  clara, sin profundizar mas de lo necesario.
- Diseno de indexacion (campos buscables/filtrables/ordenables),
  sincronizacion (mismo patron de subscriber por eventos que
  revalidate-storefront.ts, sumando product-category.* al set de
  eventos) y UI de facetas/autocompletado (reutiliza catalog-client.tsx
  y CatalogProvider.searchProducts ya existentes, sin componentes
  nuevos).

Cross-referencia agregada en ADR 0004 (que ya habia identificado
Meilisearch como paso natural) y entrada nueva en mkdocs.yml.

Etapa 2 (implementacion) NO arranca hasta aprobacion explicita de esta
propuesta.

devops added 2 commits 2026-08-26 19:56:26 +00:00

Merge main into fix/adr0006-motor-busqueda-facetas 31782a2838

docs(adr): marcar ADR 0006 como aceptada, nota de implementación

Build and Push Docs Portal / Escaneo de Secretos (Gitleaks) (pull_request) Successful in 51s

Details

Build and Push Docs Portal / Construir y publicar Docs Portal (pull_request) Skipped

Details

c243f02ec4

Aprobada tras el diagnóstico de memoria del host (swap saturado
resuelto, ~500-700MiB liberados al desactivar monitoring). Agrega
nota de implementación con 3 desviaciones reales encontradas al
verificar el código fuente del plugin en el tag v1.4.1 antes de
escribir código: no hace falta subscriber propio (el plugin trae los
suyos), las rutas del plugin no devuelven facetDistribution (se
agrega una ruta Store API propia), y se conecta vía plugins: no
modules:. Ninguna cambia la decisión, solo el cómo.

devops closed this pull request

2026-10-02 05:07:23 +00:00

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: devops/apps-registry#44