# Hiki: Piattaforma per scoprire manga e monitorarne i prezzi

> Una piattaforma per scoprire manga e confrontarne i prezzi, sul web e su Android, che aggrega i prodotti di diverse librerie, con metadati arricchiti da quattro database di anime, monitoraggio quotidiano di prezzi e disponibilità, un marketplace dell’usato, una mappa dei negozi e supporto multilingue.

URL: https://larch.ee/it/work/hiki/
Pubblicato: 2025-04-01
Prodotto online: https://hiki.world
Studio: larch (https://larch.ee/it/) · hello@larch.ee

## Il problema

I fan dei manga non hanno un modo semplice per scoprire cosa c’è nelle librerie della loro zona. I prodotti sono sparsi tra diversi rivenditori, con nomi incoerenti, senza filtri per genere e senza un modo per confrontare i prezzi o seguire le variazioni di disponibilità.

## La nostra soluzione

Abbiamo costruito Hiki come catalogo di manga e tracker dei prezzi full-stack: aggrega i prodotti di diverse librerie, li arricchisce con i metadati dei database di anime e presenta tutto in un’interfaccia veloce, filtrabile e multilingue, sul web e in un’app Android nativa.

## Funzionalità chiave

### Aggregazione intelligente dei prodotti

Scraper automatici girano ogni giorno e raccolgono i dati dei prodotti da diverse librerie: nomi, prezzi, sconti, disponibilità e immagini. Il rilevamento delle modifiche segnala nuovi arrivi, cali di prezzo e cambi di disponibilità, così gli utenti non perdono nessun aggiornamento.

### Arricchimento dei metadati

I nomi dei prodotti che arrivano dalle librerie sono spesso confusi e incoerenti. La nostra pipeline di arricchimento orchestra più API per risolverli:

- **AniList**: fonte principale per punteggi, generi, tag, sinossi e copertine
- **Shikimori**: traduzione dei titoli per i nomi di prodotto in cirillico
- **Jikan e Kitsu**: fonti di metadati di riserva per i casi limite

Il sistema genera varianti intelligenti dei titoli, gestisce sia i caratteri cirillici sia quelli latini e riconduce anche i nomi di prodotto più storpiati alla scheda canonica del manga.

### Filtri avanzati

Gli utenti possono filtrare per 21 generi di manga, oltre 100 tag, fascia di prezzo, sconto, disponibilità e negozio di origine. La ricerca full-text funziona sui nomi dei prodotti in tutte le lingue supportate.

### Interfaccia multilingue

L’intera piattaforma supporta più lingue, compresi i nomi dei generi, le traduzioni dei tag e gli elementi dell’interfaccia, grazie a next-intl e a un routing basato sulla lingua.

### Marketplace

Le persone mettono in vendita manga, figure di anime, abbigliamento e vinili usati, sul web e nell’app Android. Un annuncio ha un prezzo in lei (MDL), le condizioni, la lingua dell’edizione, la città del venditore in Moldavia e da una a cinque foto.

Un admin controlla ogni annuncio prima che vada online, e qualsiasi modifica lo rimanda in revisione. Un annuncio approvato resta online per 30 giorni, poi scade e si può rinnovare. Gli acquirenti contattano i venditori su Telegram e possono segnalare un annuncio; Hiki non gestisce pagamenti.

### Mappa dei negozi

I lettori cercano un’edizione precisa (per titolo, volume o ISBN) e scelgono una città. La mappa mostra i negozi Librarius e Cărturești in Moldavia dove è disponibile, con prezzo e disponibilità, indirizzo e telefono, e orari di apertura. Un filtro «aperti ora», l’ordinamento per distanza e le indicazioni stradali li aiutano a scegliere un negozio.

I dati dei negozi arrivano dalle pagine delle filiali pubblicate dai rivenditori stessi e vengono sincronizzati ogni notte. La mappa usa Google Maps sul web e su Android.

## Aspetti tecnici

### Frontend
- **Next.js 15** con React 19 e App Router
- **Design system neubrutalista**: bordi marcati da 2px, ombre sfalsate, estetica ispirata ai manga con i font Lacquer e Pangolin
- **next-intl** per una i18n completa con routing basato sulla lingua
- Componenti **shadcn/ui** personalizzati con il tema neubrutalista

### App Android
- App nativa in **Kotlin** sviluppata con **Jetpack Compose** e Material 3, online su [Google Play](https://play.google.com/store/apps/details?id=world.hiki)
- Lo stesso back end **FastAPI** e lo stesso progetto **Firebase** dell’app web: Google Sign-In con Firebase Auth, notifiche push con Firebase Cloud Messaging
- **Hilt**, **Retrofit**, **Room** e **Coil**, con **Maps Compose** per la mappa dei negozi
- Il catalogo con ricerca, filtri e ordinamento, le pagine di prodotti e autori, Shuffle, le Liste con reazioni, il marketplace, la mappa dei negozi, i giveaway e un profilo
- Un’app iOS in **SwiftUI** è in arrivo

### Backend
- **FastAPI** (Python) con MongoDB asincrono tramite Motor
- Scraper **aiohttp** con rate limiting e backoff esponenziale
- **Orchestratore di arricchimento multi-API** che risolve i titoli su 4 database di anime
- **Google Cloud Scheduler** per gli scraping giornalieri automatizzati
- **Cloud Armor** con restrizioni geografiche e allowlist per i crawler

### Infrastruttura
- Frontend e backend rilasciati entrambi su **Google Cloud Run**
- **MongoDB** per un’archiviazione flessibile di documenti con indici composti
- **Cloud Build** per il CD a ogni push su main

## Risultati

Hiki offre ai fan dei manga un unico posto per scoprire, confrontare e seguire ogni titolo di manga disponibile nella loro zona. La piattaforma gestisce centinaia di prodotti e ne monitora prezzi e disponibilità ogni giorno.