Lexery - Frontend Refactor Context
Source
- Linear document:
Main Refactor -> Feature Integration Context Packet - Date:
2026-03-15
Technology Stack
Портал побудований на сучасному React-стеку, що забезпечує server-side rendering та type-safe UI:
- Next.js 14 — App Router з server components, API routes для OpenRouter proxy, middleware для auth
- React 19 — concurrent features, server actions, streaming SSR
- shadcn/ui — component library на базі Radix UI primitives; забезпечує консистентний design system без vendor lock-in
- TypeScript — strict mode у всіх frontend packages
- Tailwind CSS — utility-first стилі, інтегровані із shadcn/ui tokens
Ця комбінація дозволяє Portal функціонувати як повноцінний workspace shell, а не простий лендінг.
Portal Feature Surface
Поточний Portal охоплює кілька ключових продуктових зон:
- Chat interface — основний user flow: введення юридичного запиту, отримання відповіді з Brain pipeline, real-time streaming через SSE
- Attachments — завантаження документів, file preview, зв’язок з R2 object storage для збереження
- Sidebar / history — навігація між чатами, workspace switching, session history
- Settings — user preferences, API key management, provider configuration
- Workspace layout — multi-workspace підтримка з окремим контекстом для кожного workspace
- System prompt editor — PR #4 від Sasha: кастомізація system prompt для юридичного агента, template management
- Subscription plans — PR #10 від Sasha: UI для вибору тарифного плану, billing integration
Central Situation
Frontend рухався двома паралельними треками:
The Core Problem
Якщо feature branch Олександра злити безпосередньо в рефакторений main, команда ризикувала:
- повернути старі патерни (direct Supabase calls замість repository layer)
- зламати візуальну/системну консистентність shadcn/ui design system
- дублювати state/data-access логіку між server і client components
- спровокувати ще один цикл cleanup одразу після merge
Recent Pull Requests
Sasha (Олександр)
- PR #4 — System Prompt Redesign: повна переробка system prompt editor з template picker, markdown preview, validation rules для юридичного контексту
- PR #7 — Auth Pages: нові login/register/forgot-password сторінки на shadcn/ui, server-side validation, redirect flow після авторизації
- PR #10 — Subscription Plans: UI для тарифних планів, pricing table component, integration з billing через API
Yehor (Єгор)
- PR #1 — Monorepo Migration: перенесення Portal у monorepo структуру
apps/portal, shared packages для types і utilities, turborepo configuration - PR #8 — Auth Refactor: заміна client-side auth на server-side sessions, middleware-based route protection, cookie management
- PR #9 — Auth Infrastructure: Supabase auth provider setup, role-based access control foundation, session refresh logic
The Intended Solution
- завершити refactor baseline в main
- заморозити нову feature роботу під час integration window
- портувати feature work на рефакторовану структуру
- злити тільки коли integrated branch технічно зелений і структурно консистентний
- задокументувати patterns і anti-patterns для подальшої AI-assisted роботи
Why This Matters To The Wiki
Observed: frontend architecture трактувалася як стратегічна операційна задача, а не просто coding style preference.Observed: repo docs мали слугувати guardrails для майбутнього AI-generated code — PR descriptions і Linear documents розглядалися як частина architectural memory.Inferred: це один із найсильніших прикладів того, як Lexery ставиться до архітектури як до team memory, а не лише code style.