Islands de Administración

Descripción General

El módulo de Administración en Sevastopol contiene islands SolidJS para la gestión central del sistema: empresa, capital, plan contable, representantes legales y monitoreo.

Catálogo de Islands

CapitalViewIsland Gestión de movimientos de capital social

ChartOfAccountsViewIsland Plan de cuentas contable jerárquico

CompanyViewIsland Datos corporativos de la empresa

LegalRepresentativesViewIsland Representantes legales y apoderados

MonitoringViewIsland Dashboard de salud del sistema

SystemConfigViewIsland Configuraciones dinámicas

TenantsViewIsland Gestión de tenants (multi-empresa)

SessionsViewIsland Sesiones activas de usuarios

CommonDataExplorerIsland Parámetros globales y catálogos comunes

ConfigContableViewIsland Configuración contable del tenant

BootstrapCierreIsland Apertura y cierre inicial del ejercicio

EtlViewIsland Administración de procesos ETL

Flujos Relacionados

Depreciación de activo fijo en Sevastopol Pestaña de depreciación de ActivosFijosIsland dentro del módulo de Activo Fijo.

Estructura de Archivos

• Directorysevastopol/src/components/islands/admin/

  • BootstrapCierreIsland.tsx
  • CapitalViewIsland.tsx
  • ChartOfAccountsViewIsland.tsx
  • CommonDataExplorerIsland.tsx
  • CompanyViewIsland.tsx
  • ConfigContableViewIsland.tsx
  • EtlViewIsland.tsx
  • LegalRepresentativesViewIsland.tsx
  • MonitoringViewIsland.tsx
  • SessionsViewIsland.tsx
  • SystemConfigViewIsland.tsx
  • TenantsViewIsland.tsx

CapitalViewIsland

Gestiona los movimientos del capital social de la empresa.

Características

• CRUD completo de movimientos de capital
• Filtros por estado y tipo de capital
• Stats con totales y gráficos
• Modal para crear/editar movimientos

Tipos de Capital Soportados

Tipo	Descripción
APORTE_INICIAL	Capital fundacional
AUMENTO_CAPITAL	Incrementos
REDUCCION_CAPITAL	Disminuciones
CAPITALIZACION_UTILIDADES	Utilidades reinvertidas
REVALORIZACION	Ajustes monetarios

Código de Ejemplo

import CapitalViewIsland from "@/components/islands/admin/CapitalViewIsland";

// En página Astro
<CapitalViewIsland client:visible />

ChartOfAccountsViewIsland

Administra el plan de cuentas contable con vista jerárquica.

Características

• Vista en árbol del plan de cuentas
• Filtros por código, nombre, tipo y nivel
• Badges para tipo (ACTIVO/PASIVO/etc.) e imputabilidad
• Validación de códigos numéricos
• Soporte IFRS con código alternativo

Stats Mostrados

const stats = createMemo(() => ({
    total: accounts().length,
    activos: accounts().filter(a => a.tipo === "ACTIVO").length,
    pasivos: accounts().filter(a => a.tipo === "PASIVO").length,
    imputables: accounts().filter(a => a.imputable).length
}));

CompanyViewIsland

Administra la información corporativa del tenant activo.

Características

• Identidad legal de la empresa
• Giro, contacto y domicilio
• Parámetros tributarios usados por módulos dependientes
• Edición controlada dentro del contexto activo

LegalRepresentativesViewIsland

Administra representantes legales, apoderados y vigencias asociadas.

Características

• Listado de representantes legales
• Gestión de vigencia
• Datos de representación para documentos tributarios y administrativos
• Acciones protegidas por permisos de administración

MonitoringViewIsland

Dashboard de métricas de salud del sistema.

Métricas Disponibles

Métrica	Descripción
disk_usage_pct	Uso de disco (%)
cpu_load_pct	Carga de CPU (%)
memory_usage_pct	Uso de memoria (%)
active_connections	Conexiones activas
failed_jobs_last_24h	Trabajos fallidos (24h)
api_errors_last_24h	Errores API (24h)

Colores de Estado

const healthColor = (pct: number) => {
    if (pct < 50) return "text-emerald-500";  // OK
    if (pct < 80) return "text-amber-500";    // Warning
    return "text-rose-500";                    // Critical
}

TenantsViewIsland

Gestión de tenants para arquitectura multi-empresa.

Características

• Lista de tenants con estados
• Creación de nuevos tenants
• Bases de datos asociadas por tenant
• Activación/Desactivación de tenants

Solo SUPER_ADMIN

Esta island solo es accesible para usuarios con rol SUPER_ADMIN.

SessionsViewIsland

Muestra sesiones activas y permite revisar actividad de usuarios autenticados.

Características

• Listado de sesiones activas
• Datos de usuario y expiración
• Uso operativo para soporte y auditoría de acceso

SystemConfigViewIsland

Administra configuraciones dinámicas del sistema.

Características

• Listado de claves de configuración
• Edición de valores por contexto permitido
• Uso transversal por módulos que consultan parámetros de comportamiento

CommonDataExplorerIsland

Explora parámetros comunes y catálogos globales usados por distintas vistas.

Catálogos Relevantes

Catálogo	Uso
vida_util_activos	Referencial SII de vida útil normal y acelerada para activos depreciables.
correccion_monetaria	Factores usados por cálculos contables con actualización monetaria.
indicadores	Valores mensuales para procesos tributarios y remuneraciones.

ConfigContableViewIsland

Administra configuración contable del tenant activo.

Características

• Parámetros contables del tenant
• Cuentas asociadas a procesos de cierre y operación
• Persistencia mediante APIs protegidas del módulo de administración

BootstrapCierreIsland

Ejecuta acciones críticas de apertura del ejercicio para el tenant activo.

Características

• Preparación de saldos iniciales
• Acceso restringido a usuarios administrativos
• Operación crítica con confirmación explícita

EtlViewIsland

Administra procesos ETL visibles desde el módulo de administración.

Características

• Seguimiento de procesos activos
• Estados de ejecución
• Acciones operativas sobre cargas o sincronizaciones permitidas

Patrón Común

Todas las islands de Admin siguen el patrón estándar:

export default function XxxViewIsland() {
    return (
        <ToastProvider>
            <XxxView />
        </ToastProvider>
    );
}

function XxxView() {
    const toast = useToast();
    const [isLoading, setLoading] = createSignal(true);
    const [data, setData] = createSignal([]);

    // Tenants para multi-empresa
    const [tenants, setTenants] = createSignal<Tenant[]>([]);
    const [selectedTenantId, setSelectedTenantId] = createSignal("");

    async function fetchData() {
        const url = selectedTenantId()
            ? `${API_BASE}?tenant_id=${selectedTenantId()}`
            : API_BASE;
        const r = await authenticatedFetch(url);
        // ...
    }

    onMount(() => {
        fetchTenants();
        fetchData();
    });

    return (
        <IslandBase
            module="ADMIN"
            title="Título"
            tenants={tenants()}
            selectedTenantId={selectedTenantId()}
            onTenantChange={setSelectedTenantId}
            stats={<StatCard ... />}
            filters={<Select ... />}
        >
            <DataTable items={data()} headers={HEADERS} />
        </IslandBase>
    );
}

APIs Consumidas

Island	Endpoint	Servicio
CapitalViewIsland	/api/admin/capital	CapitalService
ChartOfAccountsViewIsland	/api/admin/chart-of-accounts	ChartOfAccountsService
CompanyViewIsland	/api/admin/company	CompanyService
LegalRepresentativesViewIsland	/api/admin/representatives	LegalRepService
MonitoringViewIsland	/api/monitoring	MonitoringService
SystemConfigViewIsland	/api/admin/system-config	SystemConfigService
TenantsViewIsland	/api/tenant	TenantService
SessionsViewIsland	/api/sessions	SessionService
CommonDataExplorerIsland	/api/parameters	ParametersService
ConfigContableViewIsland	/api/admin/config-contable	ConfigContableService
BootstrapCierreIsland	/api/reportes/bootstrap-cierre	Servicio de reportes
EtlViewIsland	/api/etl/trigger, /api/etl/status/:pid	ETL Controller

Ver También

• Servicios Orchestrator - APIs backend
• Componentes UI - Atoms y Molecules
• Middleware - Autenticación
• Depreciación de activo fijo en Sevastopol - Pestaña de depreciación de ActivosFijosIsland.