MALINSKI Asystent

Instrukcja obslugi — pelna mapa workflow

Osobisty asystent AI dostepny 24/7 przez WhatsApp. Baza wiedzy z wyszukiwaniem semantycznym, inteligentny kalendarz trzech biznesow, zarzadzanie zadaniami, proaktywne powiadomienia, analytics i eksport danych.

Zaloguj sie do panelu

Jak dzialaja poszczegolne sciezki

Kazdy typ wiadomosci ma zdefiniowany pipeline przetwarzania. Oto pelna mapa.

🎤 Notatka glosowa (voice note)
1
Wyslij nagranie audio na WhatsApp
Dowolna dluga wiadomosc glosowa. Mozesz mowic po polsku.
2
Transkrypcja (OpenAI Whisper)
Audio zamieniane na tekst. Wspiera polski i angielski.
3
Detekcja intencji: pytanie czy notatka?
Jesli mowisz «co wiem o projekcie MAKO?» — system odpowie z bazy wiedzy (Voice Q&A). Jesli mowisz «kalendarz spotkanie jutro o 14» — utworzy wydarzenie. W pozostalych przypadkach — zapisze jako notatke.
4
Analiza AI (Claude Haiku)
Generuje: podsumowanie, kategorie, tagi, kluczowe wnioski, przypisanie do projektu.
5
Ekstrakcja Action Items
Jesli mowisz «trzeba wyslac oferte do piatku» — AI automatycznie tworzy zadanie z deadline.
6
Smart Connections + Embedding
System szuka powiazanych notatek w bazie i generuje wektor semantyczny (pgvector) do wyszukiwania.
7
Potwierdzenie na WhatsApp
Dostajesz podsumowanie: kategoria, tagi, projekt, insight. Jesli wyciagnieto zadania — ich lista.
🔍 Wyszukiwanie semantyczne
1
#s zapytanie (lub #q dla Q&A)
#s — zwraca liste trafien. #q — AI odpowiada na pytanie na podstawie znalezionych notatek.
2
Semantic Search (pgvector + cosine similarity)
System szuka po znaczeniu, nie po slowach kluczowych. «wycena klienta» znajdzie notatke o «cennik» i «oferta». Fallback na ILIKE jezeli brak embeddingu.
3
Odpowiedz
#s: top 5 trafien z podsumowaniem. #q: Claude Haiku generuje odpowiedz na podstawie kontekstu z bazy, cytujac zrodla.
📅 Kalendarz Multi-Business
1
Utworz wydarzenie: #sp, #r, #g lub formularz w panelu
#sp — spotkanie MALINSKI.AI. #r — rejs RIBY.PL. #g — gra miejska GRY MIEJSKIE. Lub przycisk «+» w panelu webowym z formularzem Google Calendar-style.
2
AI parser (Claude Haiku) — NLP po polsku
«spotkanie jutro o 14 w Warszawie z Janem Kowalskim» — AI rozumie date, godzine, miasto, klienta. Jesli brakuje czasu trwania — dopyta.
3
Kalkulacja buforow dojazdu
Deterministyczna matryca 7 miast z Gdyni. Spotkanie w Warszawie? +5h30. Gra w Toruniu? Caly dzien. Rejs z Sopotu? +30 min. Detekcja konfliktow z istniejacymi wydarzeniami.
4
Baza klientow (auto-lookup)
Podajesz imie klienta — system szuka w bazie. Nie ma? Tworzy nowy rekord. Nastepnym razem juz go zna.
5
Przypomnienia WhatsApp
15 min przed (online), 30 min przed wyjazdem (stacjonarne), wieczor przed (jesli wyjazd przed 7 rano). Z informacja o godzinie wyjazdu.
✍️ Voice-to-Blog Pipeline
1
Zbieraj notatki na dany temat
Nagrywaj przemyslenia, screenshoty, notatki tekstowe. Przypisz do projektu dla porzadku.
2
#blog 1,2,3 — wygeneruj szkic
Podaj numery notatek. Claude Sonnet wygeneruje szkic: tytul, lead, 3-5 sekcji, podsumowanie. Status: Draft.
3
Rozwin artykul (panel webowy)
Kliknij «Rozwin artykul» w panelu. Sonnet rozwinie szkic do 1500-2500 slow z przykladami i wnioskami. Status: Rozwiniety.
4
Kopiuj i publikuj
Skopiuj tresc jednym kliknieciem. Oznacz jako «Opublikowany». Status: Opublikowany.
🖥️ Asystent serwera
1
Wyslij wiadomosc bez prefiksu #
«Pokaz logi whatsapp-agent», «Ile RAM zuzywa serwer?», «Sprawdz co jest w bazie okna-ai».
2
Claude Sonnet z tool_use (bash)
Agent wykonuje komendy: docker ps, docker logs, docker exec psql (SELECT only), df, free, top. Whitelista komend + sandbox.
3
Pamiec konwersacji (30 min)
Mozesz dopytywac o szczegoly. Agent pamie kontekst przez 30 minut (Redis). Napisz #reset aby zaczac nowy watek.

Pelna lista komend

Wszystkie prefiksy rozpoznawane przez system. Wysylasz wiadomosc na WhatsApp — system routuje ja do odpowiedniego handlera.

Komenda Alias Dzialanie Przyklad
Notatki i wiedza
#n #notatka Notatka tekstowa — AI analizuje, kategoryzuje, wyciaga tagi i action items #n Spotkanie z klientem, trzeba wyslac oferte do piatku
#mem Screenshot/zdjecie — Claude Vision (OCR) + analiza i zapis do bazy #mem + dolaczone zdjecie
#s #szukaj Wyszukiwanie semantyczne w bazie notatek (pgvector cosine similarity + ILIKE fallback) #s wycena klienta
#q Q&A — zadaj pytanie, AI odpowie na podstawie bazy wiedzy #q co wiem o projekcie MAKO?
#blog Generuj szkic artykulu blogowego z wybranych notatek (Sonnet) #blog 1,2,3
Zadania
#z #zadanie Utworz zadanie z NLP — AI rozumie polskie daty i priorytety #z zadzwonic do klienta w piatek o 10
#plan Plan dnia: spotkania + przeterminowane + zadania na dzis + podglad jutra #plan
Kalendarz
#sp #spotkanie Spotkanie MALINSKI.AI (online lub stacjonarne z dojazdem) #sp jutro o 14 w Warszawie z Janem Kowalskim, 90 min
#r #rejs Rejs RIBY.PL (Gdynia/Sopot/Gdansk z buforami dojazdu) #r rejs 5 osob w sobote o 11 z Sopotu
#g #gra Gra miejska GRY MIEJSKIE (5 miast, daleki dojazd = caly dzien) #g gra w Warszawie 20 marca, 15 osob
#kal #kalendarz Podglad tygodnia — lista nadchodzacych wydarzen #kal
Projekty
#p Nazwa Ustaw aktywny projekt (TTL 4h). Kolejne notatki trafia do niego. #p MAKO
#p Pokaz aktualny aktywny projekt #p
#p off Wylacz aktywny projekt — notatki wroca do auto-detekcji AI #p off
#pp #projekty Lista projektow z liczba notatek #pp
System
#help #? #h #pomoc Sciagawka wszystkich komend #help
#reset #clear #nowy Kasuj pamiec rozmowy (Server Agent) #reset
#export Linki do eksportu danych (Markdown ZIP, JSON, iCal) #export
audio Notatka glosowa z transkrypcja + analiza AI (lub Q&A jesli pytanie) Nagraj wiadomosc glosowa
tekst Bez prefiksu — trafia do Asystenta Serwera (monitoring Docker, SQL, system) Pokaz logi whatsapp-agent z ostatnich 5 min

Priorytet przypisania projektu: wzmianka w tresci > aktywny projekt (#p) > auto-detekcja AI > brak

Wszystkie mozliwosci

Kompletna lista funkcji dostepnych przez WhatsApp i panel webowy.

🎤

Notatki glosowe

Wyslij audio

Whisper transkrybuje, Haiku analizuje: podsumowanie, kategoria, tagi, insight, projekt. Auto-ekstrakcja action items — jezeli w notatce sa zadania, tworzy je automatycznie.

🔍

Semantic Search

#s zapytanie

Wyszukiwanie po znaczeniu (pgvector + OpenAI embeddings). «cennik» znajdzie «wycena», «oferta», «pricing». Fallback na ILIKE gdy brak wektora.

🧠

Voice Q&A

#q lub pytanie glosem

Zapytaj glosem lub napisz #q — AI odpowie na podstawie bazy wiedzy. Cytuje zrodla, uwzglednia kontekst uzytkownika z Memory Agent.

📅

Kalendarz 3 biznesow

#sp · #r · #g

MALINSKI.AI (spotkania), RIBY.PL (rejsy), GRY MIEJSKIE (rezerwacje). NLP po polsku, auto-bufory dojazdu, detekcja konfliktow, baza klientow.

🚗

Logistyka dojazdu

Automatyczne

Matryca 7 miast z Gdyni. Warszawa: +5h30. Torun: +4h. Gra w odleglym miescie: caly dzien zablokowany. Rejs z Sopotu: +30 min.

Przypomnienia WhatsApp

Automatyczne

Online: 15 min przed. Stacjonarne: 30 min przed wyjazdem. Wyjazd przed 7 rano: wieczor wczesniej. Z godzina wyjazdu i trasa.

📸

Screenshoty (OCR)

#mem + zdjecie

Claude Vision rozpoznaje tekst, linki, kontekst. Base64 zapisane w DB — dostepne z panelu nawet gdy wygasna linki Evolution API.

✍️

Blog Pipeline

#blog 1,2,3

Draft (szkic) → Rozwiniety (pelny artykul 1500-2500 slow) → Opublikowany. Sonnet generuje, panel pozwala rozwinac i skopiowac jednym kliknieciem.

📂

Projekty

#p NazwaProjektu

Aktywny projekt (Redis, TTL 4h) — notatki automatycznie trafiaja do niego. Wzmianka «Projekt MAKO, ...» nadpisuje aktywny. CRUD z panelu.

📊

Analytics

Tab w panelu

Heatmapa aktywnosci (7x24), trendy tygodniowe, rozklad kategorii, zdrowie projektow (trend, overdue), mapa wiedzy (d3.js graf), top tagi.

🖥️

Server Agent

Tekst bez prefiksu

Zdalna konsola: Docker, logi, procesy, SQL read-only na 13 bazach. Sonnet z tool_use, pamiec 30 min, sandbox z whitelista komend.

🔔

Proaktywne alerty

Automatyczne

5 regul: przeterminowane zadania (8:00), deadline jutro (20:00), martwy projekt (pon), kalendarz >4 (20:00), nieprzypisane notatki (sr). Follow-up 30 min po spotkaniu.

📊

Digest tygodniowy

Niedz. 19:00

Automatyczne podsumowanie: ile notatek, glowne tematy, zrealizowane zadania, terminy, insight tygodnia. Redis dedup zabezpiecza przed duplikatami.

📦

Eksport danych

#export

3 formaty: Markdown ZIP (YAML frontmatter, Obsidian-compatible), JSON dump, iCal (.ics). Dostepne z panelu (dropdown) i przez WhatsApp.

🔗

Webhook Out

API: /api/webhooks

Event emitter na 5 typow zdarzen: note/task/event/draft created, task completed. HMAC-SHA256 signing. Integracja z n8n, Slack, Zapier.

🛠️

Memory Agent

Automatyczne (6:00)

Codziennie o 6:00 AI buduje profil kontekstowy: aktywne projekty, tematy, wzorce aktywnosci. Wzbogaca prompty agentow o kontekst uzytkownika.

📋

Plan dnia

#plan

Spotkania na dzis z buforami, przeterminowane zadania, zadania na dzis, podglad jutrzejszych wydarzen. Sformatowany czytelnie na WhatsApp.

💡

Smart Connections

Automatyczne

Po kazdym zapisie AI szuka powiazanych notatek w bazie. Widzisz polaczenia, ktorych sam bys nie dostrzegl. Widoczne w panelu + graf w Analytics.

5 zakladek + eksport

Pelna kontrola nad baza wiedzy i kalendarzem z kazdego urzadzenia. Responsive — dziala na telefonie.

📑

Notatki

Master-detail layout. Filtruj po kategorii, sortuj, szukaj. Pelna transkrypcja, analiza AI, tagi, powiazane notatki, podglad obrazow. Multiselect do generowania draftow.

📜

Drafty

Lista szkicow z rendering Markdown. 3 statusy: Draft → Rozwiniety → Opublikowany. Przycisk «Rozwin artykul» (Sonnet, ~2000 slow). Kopiuj jednym kliknieciem.

📅

Kalendarz

Widok miesiaca z kolorowymi kropkami: niebieski (spotkania), bursztynowy (gry), zielony (rejsy), fioletowy (zadania). Formularz tworzenia/edycji wydarzen Google Calendar-style. Filtr po biznesie. Karty z buforami dojazdu.

📂

Projekty

Lista projektow z liczba notatek i opisem. Detail: notatki projektu z nawigacja do tabu Notatki. Tworzenie/edycja/usuwanie przez modal.

📊

Analytics

Heatmapa aktywnosci 7x24 (kiedy nagryjesz), trendy tygodniowe (bar chart), rozklad kategorii (doughnut), zdrowie projektow (trend ↑↓→, overdue badge), mapa wiedzy (d3.js force graph), top 10 tagow.

📦

Eksport

Dropdown w headerze: Markdown ZIP (Obsidian), JSON, iCal. Markdown z YAML frontmatter: data, kategoria, projekt, tagi, zrodlo.

Co dziala w tle

4 schedulery + 6 regul proaktywnych — system pracuje nawet gdy nie piszesz.

🔔
Przypomnienia o wydarzeniach
Sprawdza co 60s czy sa przypomnienia do wyslania. Dostosowane do typu: online/stacjonarne/wyjazd.
Co 60 sekund
📊
Digest tygodniowy
Podsumowanie: notatki, zadania, tematy, insight. Dedup po ISO week (Redis).
Niedziela 19:00
🧠
Memory Agent — kontekst
AI buduje profil: aktywne projekty, tematy, wzorce. Wzbogaca prompty agentow.
Codziennie 6:00
⚠️
Przeterminowane zadania
Alert o zadaniach po terminie (top 3). Redis dedup — max raz dziennie.
Codziennie 8:00
📅
Deadline jutro + kalendarz
Alert o jutrzejszych deadline'ach i >4 wydarzeniach (intensywny dzien).
Codziennie 20:00
💤
Martwy projekt
Projekt z >3 notatkami, ale cisza >7 dni — przypomnienie.
Poniedzialek 9:00
📂
Nieprzypisane notatki
Jesli >5 notatek z tygodnia nie ma projektu — przypomnienie o porzadku.
Sroda 10:00
📝
Follow-up po spotkaniu
30 min po zakonczeniu spotkania MALINSKI.AI — pytanie o notatki.
Co 5 minut (po spotkaniu)

Bezpieczenstwo

🔒
Whitelista numerow

Tylko autoryzowane numery telefonow. Nieznane — odrzucone bez odpowiedzi.

Rate limiting

5 wiadomosci/min, 30 wywolan agenta/h. Ochrona przed naduzyciem i kosztami API.

🛡️
Bash sandbox

Whitelista komend, blacklist regex, docker exec tylko SELECT. Read-only dostep do systemu.

🔒
HTTP Basic Auth

Panel webowy chroniony loginem i haslem. API endpointy wymagaja autoryzacji.

🔗
HMAC webhooks

Outgoing webhooks podpisywane HMAC-SHA256. Odbiorcy moga weryfikowac autentycznosc.

🛏️
Daily backup

Automatyczny pg_dump codziennie o 3:17. Retencja 7 dni. Cron na serwerze.

Stack technologiczny

Python 3.12 FastAPI Claude Haiku 4.5 Claude Sonnet 4.6 OpenAI Whisper OpenAI Embeddings pgvector PostgreSQL 16 Redis 7 Docker Evolution API v2.2.3 Chart.js 4 d3.js 7 asyncio schedulers