Specyfikacja techniczna
Konieczne jest poprawienie działania połączenia Trust Wallet przy przejściu na landing page dokładnie przez link w nagłówku profilu TikTok.
Obecnie landing page i połączenie portfela działają przy otwieraniu w zwykłej przeglądarce, a także przy niektórych innych sposobach przejścia. Problem występuje dokładnie w następującym scenariuszu:
TikTok → link w nagłówku profilu → wbudowana przeglądarka TikTok → landing page → naciśnięcie przycisku Get Your Card / „Zamów kartę” → otwarcie Trust Wallet → uruchomienie istniejącego scenariusza WalletConnect.
Przy otwieraniu landing page przez link w nagłówku profilu TikTok po naciśnięciu przycisku Trust Wallet nie otwiera się, pojawia się nieskończone ładowanie lub przycisk w ogóle nie reaguje.
Co należy zrobić
- Przeanalizować aktualną implementację landing page i samodzielnie określić przyczynę, dla której przejście z TikTok WebView do Trust Wallet nie działa.
- Poprawić dokładnie łańcuch przejścia:
link w nagłówku profilu TikTok → wbudowana przeglądarka TikTok → landing page → przycisk połączenia → aplikacja Trust Wallet → istniejące połączenie przez WalletConnect/Reown.
- Po naciśnięciu przycisku powinno otwierać się dokładnie aplikacja Trust Wallet, a nie:
- oficjalna strona Trust Wallet;
- strona pobierania aplikacji;
- lista wyboru innych portfeli;
- nieskończone ładowanie;
- pusta strona pośrednia;
- zwykła przeglądarka bez dalszego połączenia.
- Po otwarciu Trust Wallet powinien uruchamiać się ten sam istniejący scenariusz WalletConnect, który już działa przy otwieraniu landing page przez zwykłą mobilną przeglądarkę.
- Konieczne jest zachowanie już istniejącej funkcjonalności landing page. Nie trzeba na nowo opracowywać WalletConnect, logiki płatności, transakcji, smart kontraktów ani innych części projektu, które już znajdują się w plikach źródłowych i działają poza TikTok.
- Nie można zmieniać ani łamać istniejącej logiki po połączeniu portfela. Zadanie polega na poprawieniu problematycznego przejścia z TikTok WebView do już istniejącego działającego scenariusza.
- Rozwiązanie musi działać:
- na iPhone i Android;
- przy przejściu dokładnie z linku w nagłówku profilu TikTok;
- w wbudowanej przeglądarce TikTok;
- na aktualnych wersjach TikTok i Trust Wallet;
- bez przypisania do konkretnego modelu telefonu.
- Nie można zakłócać aktualnej pracy landing page:
- w Safari;
- w Chrome;
- w innych zwykłych mobilnych przeglądarkach;
- przy przejściu z Telegramu;
- przy przejściu z Instagrama;
- przy bezpośrednim otwarciu linku.
- Rozwiązanie nie powinno być sztywno przypisane do jednej domeny. Domeny mogą się zmieniać, dlatego logika powinna być przenośna.
Po załadowaniu plików na inną domenę nie powinno być konieczności przepisywania kodu pod każdy nowy adres. Dozwolone jest tylko dodanie nowej domeny do Reown Project Domains, jeśli tego wymaga Reown.
- Jeśli TikTok blokuje zwykły deep link lub universal link, konieczne jest samodzielne wdrożenie działającego sposobu przejścia przez odpowiednią kombinację:
- linki Trust Wallet;
- WalletConnect/Reown;
- deep link lub universal link;
- poprawny fallback;
- strona pośrednia lub otwarcie w zewnętrznej przeglądarce — tylko jeśli bez tego technicznie niemożliwe jest zapewnienie bezpośredniego otwarcia.
Przy tym wynik powinien być wygodny i zrozumiały dla użytkownika, bez zawieszeń i nieskończonego ładowania.
- Konieczne jest poprawne przetworzenie cache'owania plików. Po zwykłym załadowaniu gotowego archiwum na hosting powinna otwierać się aktualna wersja, bez konieczności ręcznego wyjaśniania użytkownikowi, jak czyścić stary cache TikTok.
W razie potrzeby należy dodać versioning, cache-busting lub inne poprawne przetwarzanie cache'a bezpośrednio w projekcie.
- Wszystkie niezbędne komunikaty, przyciski fallback i instrukcje powinny być częścią gotowego rozwiązania. Zamawiający nie powinien samodzielnie dopisywać kodu ani zbierać rozwiązania z oddzielnych fragmentów.
Format pracy
Po wyborze wykonawcy zostanie przekazany ZIP-archiwum aktualnego landing page.
Dostęp do konta TikTok, Trust Wallet, frazy seed, kluczy prywatnych i osobistych kont nie jest udostępniany.
Jeśli do pracy wystarczy ZIP-archiwum, wykonawca samodzielnie wprowadza zmiany i zwraca gotowy poprawiony ZIP.
Jeśli rzeczywiście potrzebny jest dostęp do serwera lub hostingu, przed rozpoczęciem pracy należy konkretnie wyjaśnić:
- dlaczego jest potrzebny;
- jakie pliki lub ustawienia będą sprawdzane;
- dlaczego tej pracy nie można wykonać przez ZIP-archiwum.
Sprawdzenie wyniku
Wykonawca powinien samodzielnie sprawdzić pełny scenariusz:
publiczny profil TikTok → link w nagłówku profilu → TikTok WebView → landing page → przycisk Get Your Card → otwarcie Trust Wallet → uruchomienie istniejącego scenariusza WalletConnect/Reown.
Sprawdzenie linku z wiadomości prywatnych TikTok nie jest akceptowane, ponieważ to inny scenariusz i działało wcześniej.
Sprawdzenie tylko przez Safari, Chrome lub zwykłą przeglądarkę również nie jest wykonaniem zadania.
Wykonawca powinien dostarczyć:
- gotowy poprawiony ZIP-archiwum;
- link do testowego środowiska;
- wideo z pełnego działania scenariusza dokładnie przez link w nagłówku profilu TikTok;
- potwierdzenie sprawdzenia na iOS i Android;
- krótkie opisane wprowadzone zmiany i pliki, które zostały zmienione.
Praca uznawana jest za wykonaną tylko po tym, jak na zainstalowanej wersji przechodzi cały łańcuch, wskazany w specyfikacji.
Po prostu otwarcie landing page z TikTok nie jest uznawane za wynik.
Po prostu otwarcie Trust Wallet bez uruchomienia istniejącego scenariusza WalletConnect również nie jest uznawane za wynik.
Automatyczne testy, emulacja User-Agent i sprawdzanie linków z wiadomości prywatnych nie zastępują faktycznego sprawdzenia przez link bio TikTok na rzeczywistym urządzeniu.
Ważne warunki wykonania pracy
Przed przyjęciem projektu upewnij się, że masz niezbędną wiedzę, doświadczenie, urządzenia i techniczne możliwości samodzielnego wykonania i sprawdzenia dokładnie wskazanego scenariusza.
Jeśli nie masz konta TikTok z możliwością dodania klikalnego linku w nagłówku profilu, nie masz fizycznego urządzenia iPhone lub Android lub nie możesz samodzielnie sprawdzić wymaganego łańcucha, należy o tym poinformować przed przyjęciem projektu, a nie po zgłoszeniu wykonanej pracy.
Proszę szanować czas innych i nie przyjmować projektu z założeniem, że główną kontrolę, poszukiwanie błędów, ciągłe instalowanie nowych archiwów i nagrywanie diagnostycznych wideo będzie wykonywał zamawiający.
Nie należy całkowicie polegać na AI przy wykonywaniu tego zadania. AI może być używane tylko jako narzędzie pomocnicze. Do pracy potrzebna jest rzeczywista wiedza:
- JavaScript;
- mobilne WebView;
- deep links i universal links;
- WalletConnect/Reown;
- specyfiki iOS i Android;
- zachowanie wbudowanej przeglądarki TikTok;
- cache'owania i wdrażania projektów webowych.
Wykonawca powinien samodzielnie analizować kod, znajdować przyczynę problemu, testować wynik i odpowiadać za faktyczną funkcjonalność rozwiązania.
Nie można zastępować uzgodnionego scenariusza podobnym. W szczególności przejście z wiadomości prywatnych TikTok nie jest zastąpieniem przejścia z linku w nagłówku profilu.
Nie należy zgłaszać, że praca została wykonana, jeśli sprawdzona została tylko część łańcucha. Wszystkie ograniczenia i niemożność sprawdzenia poszczególnych punktów należy zgłosić przed przyjęciem projektu.
Jeśli po zapoznaniu się z zadaniem rozumiesz, że technicznie nie możesz zapewnić wymaganego wyniku, proszę, nie przyjmuj projektu. To pozwoli zaoszczędzić czas obu stron.
