# Hiki: Plataforma para descubrir manga y seguir sus precios

> Una plataforma para descubrir manga y comparar precios, en la web y en Android, que reúne productos de varias librerías, con enriquecimiento de metadatos de cuatro bases de datos de anime, seguimiento diario de precios y stock, un espacio de compraventa de segunda mano, un mapa de tiendas y soporte multilingüe.

URL: https://larch.ee/es/work/hiki/
Publicado: 2025-04-01
Producto en línea: https://hiki.world
Estudio: larch (https://larch.ee/es/) · hello@larch.ee

## El problema

Los fans del manga no tienen una forma fácil de descubrir qué hay disponible en las librerías de su zona. Los productos están repartidos entre varias tiendas, con nombres inconsistentes, sin filtros por género y sin forma de comparar precios ni de seguir los cambios de stock.

## Nuestra solución

Construimos Hiki como un catálogo full-stack de manga con seguimiento de precios que reúne productos de varias librerías, los enriquece con metadatos de bases de datos de anime y lo presenta todo en una interfaz rápida, filtrable y multilingüe, en la web y en una app nativa para Android.

## Funciones clave

### Agregación inteligente de productos

Unos scrapers automatizados se ejecutan cada día y recogen datos de producto de varias librerías: nombres, precios, descuentos, disponibilidad e imágenes. La detección de cambios señala las novedades, las bajadas de precio y los cambios de stock, para que los usuarios no se pierdan ninguna actualización.

### Enriquecimiento de metadatos

Los nombres de producto que dan las librerías suelen ser ruidosos e inconsistentes. Nuestro pipeline de enriquecimiento orquesta varias API para resolverlos:

- **AniList**: fuente principal de puntuaciones, géneros, etiquetas, sinopsis y portadas
- **Shikimori**: traducción de títulos para nombres de producto en cirílico
- **Jikan y Kitsu**: fuentes de metadatos de respaldo para los casos límite

El sistema genera variantes inteligentes de cada título, maneja caracteres cirílicos y latinos, y resuelve incluso los nombres de producto más destrozados hasta su entrada canónica de manga.

### Filtros avanzados

Los usuarios pueden filtrar por 21 géneros de manga, más de 100 etiquetas, rango de precios, descuento, disponibilidad y tienda de origen. La búsqueda de texto completo funciona sobre los nombres de producto en todos los idiomas disponibles.

### Interfaz multilingüe

Toda la plataforma funciona en varios idiomas, incluidos los nombres de los géneros, las traducciones de las etiquetas y los elementos de la interfaz, y está construida con next-intl y enrutamiento por idioma.

### Compraventa

La gente publica manga, figuras de anime, ropa y vinilos de segunda mano, en la web y en la app para Android. Un anuncio lleva un precio en lei (MDL), el estado, el idioma de la edición, la ciudad del vendedor en Moldavia y de una a cinco fotos.

Un administrador revisa cada anuncio antes de que se publique, y cualquier cambio lo devuelve a revisión. Un anuncio aprobado sigue publicado 30 días; después caduca y se puede renovar. Los compradores contactan con los vendedores por Telegram y pueden denunciar un anuncio; Hiki no gestiona ningún pago.

### Mapa de tiendas

Los lectores buscan una edición exacta (por título, tomo o ISBN) y eligen una ciudad. El mapa muestra las tiendas de Librarius y Cărturești en Moldavia que la tienen, con precio y stock, dirección y teléfono, y horario. Un filtro «abierto ahora», la ordenación por distancia y las indicaciones para llegar les ayudan a elegir tienda.

Los datos de las tiendas salen de las páginas de cada establecimiento en las webs de las propias cadenas y se sincronizan cada noche. El mapa funciona con Google Maps en la web y en Android.

## Aspectos técnicos clave

### Frontend
- **Next.js 15** con React 19 y el App Router
- **Sistema de diseño neobrutalista**: bordes gruesos de 2px, sombras desplazadas y una estética inspirada en el manga, con las tipografías Lacquer y Pangolin
- **next-intl** para una i18n completa con enrutamiento por idioma
- Componentes de **shadcn/ui** adaptados al tema neobrutalista

### App para Android
- App nativa en **Kotlin** hecha con **Jetpack Compose** y Material 3, disponible en [Google Play](https://play.google.com/store/apps/details?id=world.hiki)
- El mismo back end en **FastAPI** y el mismo proyecto de **Firebase** que la app web: Google Sign-In con Firebase Auth y notificaciones push con Firebase Cloud Messaging
- **Hilt**, **Retrofit**, **Room** y **Coil**, con **Maps Compose** para el mapa de tiendas
- El catálogo con búsqueda, filtros y ordenación, páginas de producto y de autor, Shuffle, Listas con reacciones, la compraventa, el mapa de tiendas, sorteos y un perfil
- Está en camino una app para iOS en **SwiftUI**

### Backend
- **FastAPI** (Python) con MongoDB asíncrono vía Motor
- Scrapers con **aiohttp**, con limitación de peticiones y backoff exponencial
- **Orquestador de enriquecimiento multi-API** que resuelve títulos en 4 bases de datos de anime
- **Google Cloud Scheduler** para el scraping diario automatizado
- **Cloud Armor** con restricciones geográficas y lista de rastreadores permitidos

### Infraestructura
- Frontend y backend desplegados en **Google Cloud Run**
- **MongoDB** para un almacenamiento flexible de documentos con índices compuestos
- **Cloud Build** para el despliegue continuo con cada push a main

## Resultados

Hiki da a los fans del manga un único lugar para descubrir, comparar y seguir cada título de manga disponible cerca de ellos. La plataforma gestiona cientos de productos y sigue sus precios y su stock cada día.
