@djangocfg/layouts 2.1.10 → 2.1.14

package/src/contexts/payments/README.md

@@ -1,201 +0,0 @@
-# Payments Contexts
-
-Декомпозированные контексты для модуля Payments.
-
-## Структура
-
-### PaymentsContext
-**Файл:** `PaymentsContext.tsx`  
-**Назначение:** Управление платежами
-
-**API:**
-- `payments: PaginatedPaymentListList` - список платежей (пагинированный)
-- `isLoadingPayments: boolean` - статус загрузки
-- `refreshPayments()` - обновить список
-- `getPayment(id)` - получить конкретный платеж
-- `createPayment(data)` - создать платеж
-- `cancelPayment(id, data)` - отменить платеж
-- `checkPaymentStatus(id, data)` - проверить статус платежа
-
-**Использование:**
-```tsx
-import { PaymentsProvider, usePaymentsContext } from '@djangocfg/layouts/contexts';
-
-function PaymentsList() {
-  const { payments, isLoadingPayments, refreshPayments } = usePaymentsContext();
-  // ...
-}
-```
-
----
-
-### BalancesContext
-**Файл:** `BalancesContext.tsx`  
-**Назначение:** Управление балансами пользователей (read-only)
-
-**API:**
-- `balances: PaginatedUserBalanceList` - список балансов
-- `isLoadingBalances: boolean` - статус загрузки
-- `refreshBalances()` - обновить список
-- `getBalance(id)` - получить конкретный баланс
-- `getBalanceSummary()` - получить сводку по балансу
-
-**Использование:**
-```tsx
-import { BalancesProvider, useBalancesContext } from '@djangocfg/layouts/contexts';
-
-function Balance() {
-  const { balances, getBalanceSummary } = useBalancesContext();
-  // ...
-}
-```
-
----
-
-### CurrenciesContext
-**Файл:** `CurrenciesContext.tsx`  
-**Назначение:** Управление валютами и курсами обмена (read-only)
-
-**API:**
-- `currencies: PaginatedCurrencyListList` - список валют
-- `isLoadingCurrencies: boolean` - статус загрузки
-- `refreshCurrencies()` - обновить список
-- `getCurrency(id)` - получить конкретную валюту
-- `getCurrencyRates(baseCurrency, currencies)` - получить курсы обмена
-
-**Использование:**
-```tsx
-import { CurrenciesProvider, useCurrenciesContext } from '@djangocfg/layouts/contexts';
-
-function CurrencySelector() {
-  const { currencies, getCurrencyRates } = useCurrenciesContext();
-  // ...
-}
-```
-
----
-
-### ApiKeysContext
-**Файл:** `ApiKeysContext.tsx`  
-**Назначение:** Управление API ключами
-
-**API:**
-- `apiKeys: PaginatedAPIKeyListList` - список API ключей
-- `isLoadingApiKeys: boolean` - статус загрузки
-- `refreshApiKeys()` - обновить список
-- `getApiKey(id)` - получить конкретный ключ
-- `createApiKey(data)` - создать ключ
-- `deleteApiKey(id)` - удалить ключ
-
-**Использование:**
-```tsx
-import { ApiKeysProvider, useApiKeysContext } from '@djangocfg/layouts/contexts';
-
-function ApiKeysList() {
-  const { apiKeys, createApiKey, deleteApiKey } = useApiKeysContext();
-  // ...
-}
-```
-
----
-
-### OverviewContext
-**Файл:** `OverviewContext.tsx`  
-**Назначение:** Дашборд и метрики платежной системы (read-only)
-
-**API:**
-- `overview: PaymentsDashboardOverview` - общий обзор
-- `metrics: PaymentsMetrics` - метрики
-- `balanceOverview: BalanceOverview` - обзор баланса
-- `apiKeysOverview: APIKeysOverview` - обзор API ключей
-- `subscriptionOverview: SubscriptionOverview` - обзор подписок
-- `chartData: PaymentsChartResponse` - данные для графиков
-- `recentPayments: PaginatedRecentPaymentList` - последние платежи
-- `recentTransactions: PaginatedRecentTransactionList` - последние транзакции
-- `isLoadingOverview: boolean` - статус загрузки
-- `refreshOverview()` - обновить все данные
-
-**Использование:**
-```tsx
-import { OverviewProvider, useOverviewContext } from '@djangocfg/layouts/contexts';
-
-function Dashboard() {
-  const { overview, metrics, chartData } = useOverviewContext();
-  // ...
-}
-```
-
----
-
-## Композиция провайдеров
-
-Если нужно использовать несколько контекстов:
-
-```tsx
-import { 
-  PaymentsProvider, 
-  BalancesProvider, 
-  OverviewProvider 
-} from '@djangocfg/layouts/contexts';
-
-function PaymentsDashboard() {
-  return (
-    <OverviewProvider>
-      <PaymentsProvider>
-        <BalancesProvider>
-          <YourComponent />
-        </BalancesProvider>
-      </PaymentsProvider>
-    </OverviewProvider>
-  );
-}
-```
-
----
-
-## Миграция со старого PaymentsContext
-
-**Было:**
-```tsx
-import { PaymentsProvider, usePaymentsContext } from '@djangocfg/layouts/contexts';
-
-const { payments, balances, apiKeys } = usePaymentsContext();
-```
-
-**Стало:**
-```tsx
-import { 
-  PaymentsProvider, usePaymentsContext,
-  BalancesProvider, useBalancesContext,
-  ApiKeysProvider, useApiKeysContext
-} from '@djangocfg/layouts/contexts';
-
-// В разных компонентах или комбинируя:
-const { payments } = usePaymentsContext();
-const { balances } = useBalancesContext();
-const { apiKeys } = useApiKeysContext();
-```
-
----
-
-## Преимущества декомпозиции
-
-1. **Модульность** - каждый контекст отвечает за свою область
-2. **Производительность** - меньше ненужных ре-рендеров
-3. **Гибкость** - можно использовать только нужные контексты
-4. **Читаемость** - явное разделение зон ответственности
-5. **Масштабируемость** - проще добавлять новую функциональность
-
----
-
-## Не включенные сущности
-
-В текущей декомпозиции **не включены** (могут быть добавлены позже):
-- `SubscriptionsContext` - управление подписками (CRUD)
-- `TransactionsContext` - история транзакций (read-only)
-- `TariffsContext` - тарифные планы (read-only)
-- `NetworksContext` - блокчейн сети (read-only)
-- `AdminContext` - админ-функции (для админки)
-
-Эти сущности можно добавить по мере необходимости, следуя той же структуре.
-

package/src/contexts/payments/RootPaymentsContext.tsx

@@ -1,68 +0,0 @@
-'use client';
-
-import React, { createContext, useContext, type ReactNode } from 'react';
-import { api } from '@djangocfg/api';
-import {
-  usePaymentsCurrenciesList,
-} from '@djangocfg/api';
-import type { API } from '@djangocfg/api';
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context Type
-// ─────────────────────────────────────────────────────────────────────────
-
-export interface RootPaymentsContextValue {
-  // Currencies - simplified to single endpoint
-  currencies: any | undefined;
-  isLoadingCurrencies: boolean;
-  currenciesError: Error | undefined;
-  refreshCurrencies: () => Promise<void>;
-}
-
-// ─────────────────────────────────────────────────────────────────────────
-// Context
-// ─────────────────────────────────────────────────────────────────────────
-
-const RootPaymentsContext = createContext<RootPaymentsContextValue | undefined>(undefined);
-
-// ─────────────────────────────────────────────────────────────────────────
-// Provider
-// ─────────────────────────────────────────────────────────────────────────
-
-export function RootPaymentsProvider({ children }: { children: ReactNode }) {
-  // Get currencies list from /cfg/payments/currencies/
-  // In v2.0, this returns all currencies with network info embedded
-  const {
-    data: currencies,
-    error: currenciesError,
-    isLoading: isLoadingCurrencies,
-    mutate: mutateCurrencies,
-  } = usePaymentsCurrenciesList(api as unknown as API);
-
-  const refreshCurrencies = async () => {
-    await mutateCurrencies();
-  };
-
-  const value: RootPaymentsContextValue = {
-    currencies,
-    isLoadingCurrencies,
-    currenciesError,
-    refreshCurrencies,
-  };
-
-  return (
-    <RootPaymentsContext.Provider value={value}>{children}</RootPaymentsContext.Provider>
-  );
-}
-
-// ─────────────────────────────────────────────────────────────────────────
-// Hook
-// ─────────────────────────────────────────────────────────────────────────
-
-export function useRootPaymentsContext(): RootPaymentsContextValue {
-  const context = useContext(RootPaymentsContext);
-  if (!context) {
-    throw new Error('useRootPaymentsContext must be used within RootPaymentsProvider');
-  }
-  return context;
-}

package/src/contexts/payments/index.ts

@@ -1,50 +0,0 @@
-// Payments
-export {
-  PaymentsProvider,
-  usePaymentsContext
-} from './PaymentsContext';
-export type {
-  PaymentsContextValue,
-  PaginatedPaymentListList,
-  PaymentDetail,
-  PaymentList,
-} from './PaymentsContext';
-
-// Balances
-export {
-  BalancesProvider,
-  useBalancesContext
-} from './BalancesContext';
-export type {
-  BalancesContextValue,
-} from './BalancesContext';
-
-// Currencies
-export {
-  CurrenciesProvider,
-  useCurrenciesContext
-} from './CurrenciesContext';
-export type {
-  CurrenciesContextValue,
-} from './CurrenciesContext';
-
-// Overview
-export {
-  OverviewProvider,
-  useOverviewContext
-} from './OverviewContext';
-export type {
-  OverviewContextValue,
-  PaginatedPaymentListList as OverviewPaginatedPaymentListList,
-  PaymentList as OverviewPaymentList,
-} from './OverviewContext';
-
-// Root Payments (Global)
-export {
-  RootPaymentsProvider,
-  useRootPaymentsContext
-} from './RootPaymentsContext';
-export type {
-  RootPaymentsContextValue,
-} from './RootPaymentsContext';
-

package/src/layouts/PaymentsLayout/PaymentsLayout.tsx

@@ -1,92 +0,0 @@
-// @ts-nocheck
-/**
- * Payments Layout (v2.0 - Simplified)
- *
- * Simplified layout with 3 tabs: Overview, Payments, Transactions
- * Removed: API Keys, Tariffs (deprecated in v2.0)
- */
-
-'use client';
-
-import React from 'react';
-import {
-  PaymentsProvider,
-  OverviewProvider,
-  RootPaymentsProvider,
-} from '@djangocfg/layouts/contexts';
-import { Tabs, TabsContent, TabsList, TabsTrigger } from '@djangocfg/ui-nextjs';
-import { Wallet, CreditCard, History } from 'lucide-react';
-import { OverviewView } from './views/overview';
-import { PaymentsView } from './views/payments';
-import { TransactionsView } from './views/transactions';
-import { CreatePaymentDialog, PaymentDetailsDialog } from './components';
-
-// ─────────────────────────────────────────────────────────────────────────
-// Payments Layout
-// ─────────────────────────────────────────────────────────────────────────
-
-export interface PaymentsLayoutProps {
-  children?: React.ReactNode;
-}
-
-export const PaymentsLayout: React.FC<PaymentsLayoutProps> = () => {
-  return (
-    <RootPaymentsProvider>
-      <div className="h-full p-6 space-y-6">
-        {/* Page Header */}
-        <div>
-          <h1 className="text-3xl font-bold tracking-tight">Payments</h1>
-          <p className="text-muted-foreground">
-            Manage your payments, balance, and transaction history
-          </p>
-        </div>
-
-        {/* Main Content with Tabs */}
-        <Tabs defaultValue="overview" className="space-y-6">
-          <TabsList className="inline-flex h-10 items-center justify-center rounded-md bg-muted p-1 text-muted-foreground">
-            <TabsTrigger value="overview" className="inline-flex items-center gap-2 px-3 py-1.5">
-              <Wallet className="h-4 w-4" />
-              <span className="hidden sm:inline">Overview</span>
-            </TabsTrigger>
-            <TabsTrigger value="payments" className="inline-flex items-center gap-2 px-3 py-1.5">
-              <CreditCard className="h-4 w-4" />
-              <span className="hidden sm:inline">Payments</span>
-            </TabsTrigger>
-            <TabsTrigger value="transactions" className="inline-flex items-center gap-2 px-3 py-1.5">
-              <History className="h-4 w-4" />
-              <span className="hidden sm:inline">Transactions</span>
-            </TabsTrigger>
-          </TabsList>
-
-          {/* Overview Tab - Balance + Recent Payments */}
-          <TabsContent value="overview" className="space-y-6">
-            <OverviewProvider>
-              <PaymentsProvider>
-                <OverviewView />
-                <CreatePaymentDialog />
-              </PaymentsProvider>
-            </OverviewProvider>
-          </TabsContent>
-
-          {/* Payments Tab - Full Payment List */}
-          <TabsContent value="payments" className="space-y-6">
-            <PaymentsProvider>
-              <PaymentsView />
-              <CreatePaymentDialog />
-            </PaymentsProvider>
-          </TabsContent>
-
-          {/* Transactions Tab - Transaction History */}
-          <TabsContent value="transactions" className="space-y-6">
-            <OverviewProvider>
-              <TransactionsView />
-            </OverviewProvider>
-          </TabsContent>
-        </Tabs>
-
-        {/* Global Payment Details Dialog */}
-        <PaymentDetailsDialog />
-      </div>
-    </RootPaymentsProvider>
-  );
-};