Narzędzie wewnętrzne · Next.js

hq.profitway.pl

Wewnętrzny system agencji, dla ludzi i dla narzędzi AI

Panel dla całego zespołu Profitway: materiały marki, codzienne narzędzia i dwa serwery MCP, które dają asystentom AI, takim jak Claude i Cursor, bezpośredni dostęp do brandbooka i dokumentacji technicznej firmy. Logowanie przez Google, tylko dla kont firmowych.

Rola: Główny programista: 213 z 244 commitów
Okres: luty - październik 2026
Technologie: Next.js 16
React 19
TypeScript
Tailwind CSS 4
Auth.js
next-intl
MCP
Vitest
Docker

Co obsługuje panel

Logowanie
1. Konto Google
2. Tylko domena firmowa
Dla ludzi
1. Brandland
2. Devland
3. Baza pracowników
4. Stopki mailowe
5. Oferty pracy
6. Sejf
Dla narzędzi AI
1. MCP brandbooka · 19 narzędzi
2. MCP dokumentacji IT · 10 narzędzi

Jedna aplikacja Next.js, wdrożona w Dockerze.

modułów: 6
narzędzi w 2 serwerach MCP: 29
testów automatycznych w CI: 167
interfejs, instalowany jak aplikacja: PL / EN

Kontekst

Agencja potrzebowała jednego miejsca na materiały marki i codzienne narzędzia, dostępnego dla pracowników i dla asystentów AI, z którymi zespół pracuje na co dzień.

We wrześniu 2026 panel przeniósł się z office.profitway.pl na hq.profitway.pl. Stare adresy przekierowują na nową domenę z zachowaniem ścieżki, więc zapisane linki nadal działają.

Co zrobiłem

Brandland: brandbook w PDF, konfigurator logo i sygnetu z eksportem do SVG, PNG i JPG, kolory, typografia z paczką fontów, ikony i animacje Lottie eksportowane do GIF i MP4
Devland: pliki design systemu przygotowane dla narzędzi AI i instrukcje konfiguracji MCP krok po kroku
Baza pracowników pobierana z Google Workspace, z rolami w konfiguracji
Generator stopek mailowych, który tworzy gotowe stopki HTML
Oferty pracy z edytorem WYSIWYG dla administratorów i publicznym feedem JSON
Sejf: hasła szyfrowane w przeglądarce przed zapisem, do udostępniania klientom bez konta
Cały panel po polsku i angielsku, do zainstalowania na telefonie jako PWA
Publiczny serwer MCP brandbooka: każdy może podłączyć Claude'a albo Cursora do kolorów, typografii, logotypów, komponentów i szablonów maili Profitway

MCP brandbooka · 19 narzędzi

Publiczny serwer MCP udostępnia brandbook jako narzędzia. Asystent AI pyta o dokładne kolory, tokeny albo logo, zamiast je zgadywać.

get_brand_colors
get_typography
get_logo
get_logo_guidelines
get_icons
get_icon_guidelines
get_animation_guidelines
get_keyframes
get_tailwind_tokens
get_token
get_shadcn_setup
get_full_design_system
get_design_doc
get_component
list_components
list_assets
get_email_template
list_email_templates
get_llms

Trudne momenty i jak je rozwiązałem

Problem
Asystenci AI nie widzieli zasad marki ani dokumentacji IT, więc zespół wklejał je do promptów ręcznie.
Rozwiązanie
Dwa serwery MCP jako bezstanowe route handlery Streamable HTTP w tej samej aplikacji Next.js: brandbook z 19 narzędziami z firmowej biblioteki design systemu i dokumentacja IT z 10 narzędziami, które czytają prywatne repozytorium na żywo.
Problem
Kod szybko rósł i we wrześniu nie miał CI, testów, a lint nie działał.
Rozwiązanie
Zaplanowany refaktor: wspólne komponenty UI, jeden kanał MCP na serwer i pipeline CI, który przy każdym pull requeście uruchamia lint, sprawdzanie typów, 167 testów i build.
Problem
Przeniesienie panelu na nową domenę bez psucia zakładek i integracji.
Rozwiązanie
Stałe przekierowania ze starej domeny z zachowaniem ścieżki, wdrożone i zamknięte w cztery dni.