* feat: Implement multi-tenant architecture with tenant and knowledge base models - Added data models for tenants, knowledge bases, and related configurations. - Introduced role and permission management for users in the multi-tenant system. - Created a service layer for managing tenants and knowledge bases, including CRUD operations. - Developed a tenant-aware instance manager for LightRAG with caching and isolation features. - Added a migration script to transition existing workspace-based deployments to the new multi-tenant architecture. * chore: ignore lightrag/api/webui/assets/ directory * chore: stop tracking lightrag/api/webui/assets (ignore in .gitignore) * feat: Initialize LightRAG Multi-Tenant Stack with PostgreSQL - Added README.md for project overview, setup instructions, and architecture details. - Created docker-compose.yml to define services: PostgreSQL, Redis, LightRAG API, and Web UI. - Introduced env.example for environment variable configuration. - Implemented init-postgres.sql for PostgreSQL schema initialization with multi-tenant support. - Added reproduce_issue.py for testing default tenant access via API. * feat: Enhance TenantSelector and update related components for improved multi-tenant support * feat: Enhance testing capabilities and update documentation - Updated Makefile to include new test commands for various modes (compatibility, isolation, multi-tenant, security, coverage, and dry-run). - Modified API health check endpoint in Makefile to reflect new port configuration. - Updated QUICK_START.md and README.md to reflect changes in service URLs and ports. - Added environment variables for testing modes in env.example. - Introduced run_all_tests.sh script to automate testing across different modes. - Created conftest.py for pytest configuration, including database fixtures and mock services. - Implemented database helper functions for streamlined database operations in tests. - Added test collection hooks to skip tests based on the current MULTITENANT_MODE. * feat: Implement multi-tenant support with demo mode enabled by default - Added multi-tenant configuration to the environment and Docker setup. - Created pre-configured demo tenants (acme-corp and techstart) for testing. - Updated API endpoints to support tenant-specific data access. - Enhanced Makefile commands for better service management and database operations. - Introduced user-tenant membership system with role-based access control. - Added comprehensive documentation for multi-tenant setup and usage. - Fixed issues with document visibility in multi-tenant environments. - Implemented necessary database migrations for user memberships and legacy support. * feat(audit): Add final audit report for multi-tenant implementation - Documented overall assessment, architecture overview, test results, security findings, and recommendations. - Included detailed findings on critical security issues and architectural concerns. fix(security): Implement security fixes based on audit findings - Removed global RAG fallback and enforced strict tenant context. - Configured super-admin access and required user authentication for tenant access. - Cleared localStorage on logout and improved error handling in WebUI. chore(logs): Create task logs for audit and security fixes implementation - Documented actions, decisions, and next steps for both audit and security fixes. - Summarized test results and remaining recommendations. chore(scripts): Enhance development stack management scripts - Added scripts for cleaning, starting, and stopping the development stack. - Improved output messages and ensured graceful shutdown of services. feat(starter): Initialize PostgreSQL with AGE extension support - Created initialization scripts for PostgreSQL extensions including uuid-ossp, vector, and AGE. - Ensured successful installation and verification of extensions. * feat: Implement auto-select for first tenant and KB on initial load in WebUI - Removed WEBUI_INITIAL_STATE_FIX.md as the issue is resolved. - Added useTenantInitialization hook to automatically select the first available tenant and KB on app load. - Integrated the new hook into the Root component of the WebUI. - Updated RetrievalTesting component to ensure a KB is selected before allowing user interaction. - Created end-to-end tests for multi-tenant isolation and real service interactions. - Added scripts for starting, stopping, and cleaning the development stack. - Enhanced API and tenant routes to support tenant-specific pipeline status initialization. - Updated constants for backend URL to reflect the correct port. - Improved error handling and logging in various components. * feat: Add multi-tenant support with enhanced E2E testing scripts and client functionality * update client * Add integration and unit tests for multi-tenant API, models, security, and storage - Implement integration tests for tenant and knowledge base management endpoints in `test_tenant_api_routes.py`. - Create unit tests for tenant isolation, model validation, and role permissions in `test_tenant_models.py`. - Add security tests to enforce role-based permissions and context validation in `test_tenant_security.py`. - Develop tests for tenant-aware storage operations and context isolation in `test_tenant_storage_phase3.py`. * feat(e2e): Implement OpenAI model support and database reset functionality * Add comprehensive test suite for gpt-5-nano compatibility - Introduced tests for parameter normalization, embeddings, and entity extraction. - Implemented direct API testing for gpt-5-nano. - Validated .env configuration loading and OpenAI API connectivity. - Analyzed reasoning token overhead with various token limits. - Documented test procedures and expected outcomes in README files. - Ensured all tests pass for production readiness. * kg(postgres_impl): ensure AGE extension is loaded in session and configure graph initialization * dev: add hybrid dev helper scripts, Makefile, docker-compose.dev-db and local development docs * feat(dev): add dev helper scripts and local development documentation for hybrid setup * feat(multi-tenant): add detailed specifications and logs for multi-tenant improvements, including UX, backend handling, and ingestion pipeline * feat(migration): add generated tenant/kb columns, indexes, triggers; drop unused tables; update schema and docs * test(backward-compat): adapt tests to new StorageNameSpace/TenantService APIs (use concrete dummy storages) * chore: multi-tenant and UX updates — docs, webui, storage, tenant service adjustments * tests: stabilize integration tests + skip external services; fix multi-tenant API behavior and idempotency - gpt5_nano_compatibility: add pytest-asyncio markers, skip when OPENAI key missing, prevent module-level asyncio.run collection, add conftest - Ollama tests: add server availability check and skip markers; avoid pytest collection warnings by renaming helper classes - Graph storage tests: rename interactive test functions to avoid pytest collection - Document & Tenant routes: support external_ids for idempotency; ensure HTTPExceptions are re-raised - LightRAG core: support external_ids in apipeline_enqueue_documents and idempotent logic - Tests updated to match API changes (tenant routes & document routes) - Add logs and scripts for inspection and audit
219 lines
5.7 KiB
TypeScript
219 lines
5.7 KiB
TypeScript
import { axiosInstance as apiClient } from './client'
|
|
import { Tenant, KnowledgeBase } from '@/stores/tenant'
|
|
|
|
// Pagination response type
|
|
export interface PaginatedResponse<T> {
|
|
items: T[]
|
|
total: number
|
|
page: number
|
|
page_size: number
|
|
total_pages: number
|
|
has_next: boolean
|
|
has_prev: boolean
|
|
}
|
|
|
|
// Tenants API
|
|
|
|
/**
|
|
* Fetch paginated list of tenants
|
|
* @param page - Page number (1-indexed)
|
|
* @param pageSize - Items per page (max 100)
|
|
* @param search - Optional search string
|
|
*/
|
|
export async function fetchTenantsPaginated(
|
|
page: number = 1,
|
|
pageSize: number = 10,
|
|
search?: string
|
|
): Promise<PaginatedResponse<Tenant>> {
|
|
try {
|
|
const params: Record<string, any> = { page, page_size: pageSize }
|
|
if (search) params.search = search
|
|
|
|
const response = await apiClient.get('/api/v1/tenants', { params })
|
|
return response.data
|
|
} catch (error) {
|
|
console.error('Failed to fetch tenants paginated:', error)
|
|
// WUI-002 FIX: Throw error instead of returning fake data
|
|
// This allows the UI to show proper error state
|
|
throw error
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Fetch all tenants (deprecated - use fetchTenantsPaginated instead)
|
|
* @deprecated Use fetchTenantsPaginated for better performance
|
|
*/
|
|
export async function fetchTenants(): Promise<Tenant[]> {
|
|
try {
|
|
const response = await apiClient.get('/api/v1/tenants')
|
|
// Handle both paginated response format and legacy array format
|
|
const data = response.data
|
|
if (Array.isArray(data)) {
|
|
return data
|
|
}
|
|
// New paginated format returns { items: [...], total: N, ... }
|
|
return data?.items || []
|
|
} catch (error) {
|
|
console.error('Failed to fetch tenants:', error)
|
|
// WUI-002 FIX: Throw error instead of returning fake data
|
|
// This allows the UI to show proper error state
|
|
throw error
|
|
}
|
|
}
|
|
|
|
export async function fetchCurrentTenant(tenantId: string): Promise<Tenant | null> {
|
|
try {
|
|
const response = await apiClient.get('/api/v1/tenants/me', {
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
})
|
|
return response.data
|
|
} catch (error) {
|
|
console.error(`Failed to fetch current tenant ${tenantId}:`, error)
|
|
return null
|
|
}
|
|
}
|
|
|
|
export async function createTenant(
|
|
name: string,
|
|
description?: string,
|
|
metadata?: Record<string, any>
|
|
): Promise<Tenant> {
|
|
const response = await apiClient.post('/api/v1/tenants', {
|
|
name,
|
|
description,
|
|
metadata,
|
|
})
|
|
return response.data
|
|
}
|
|
|
|
// Knowledge Bases API
|
|
|
|
/**
|
|
* Fetch paginated list of knowledge bases for a tenant
|
|
* @param tenantId - The tenant ID
|
|
* @param page - Page number (1-indexed)
|
|
* @param pageSize - Items per page (max 100)
|
|
* @param search - Optional search string
|
|
*/
|
|
export async function fetchKnowledgeBasesPaginated(
|
|
tenantId: string,
|
|
page: number = 1,
|
|
pageSize: number = 10,
|
|
search?: string
|
|
): Promise<PaginatedResponse<KnowledgeBase>> {
|
|
try {
|
|
const params: Record<string, any> = { page, page_size: pageSize }
|
|
if (search) params.search = search
|
|
|
|
const response = await apiClient.get('/api/v1/knowledge-bases', {
|
|
params,
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
})
|
|
return response.data
|
|
} catch (error) {
|
|
console.error(`Failed to fetch knowledge bases paginated for tenant ${tenantId}:`, error)
|
|
// Return default paginated response if API not available
|
|
return {
|
|
items: [
|
|
{
|
|
kb_id: 'default',
|
|
tenant_id: tenantId,
|
|
kb_name: 'Default KB',
|
|
description: 'Default knowledge base',
|
|
num_documents: 0,
|
|
num_entities: 0,
|
|
num_relations: 0,
|
|
}
|
|
],
|
|
total: 1,
|
|
page: 1,
|
|
page_size: pageSize,
|
|
total_pages: 1,
|
|
has_next: false,
|
|
has_prev: false
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Fetch all knowledge bases for a tenant (deprecated - use fetchKnowledgeBasesPaginated instead)
|
|
* @deprecated Use fetchKnowledgeBasesPaginated for better performance
|
|
*/
|
|
export async function fetchKnowledgeBases(tenantId: string): Promise<KnowledgeBase[]> {
|
|
try {
|
|
const response = await apiClient.get('/api/v1/knowledge-bases', {
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
})
|
|
return response.data?.items || []
|
|
} catch (error) {
|
|
console.error(`Failed to fetch knowledge bases for tenant ${tenantId}:`, error)
|
|
// Return default KB if API is not multi-tenant enabled
|
|
return [
|
|
{
|
|
kb_id: 'default',
|
|
tenant_id: tenantId,
|
|
kb_name: 'Default KB',
|
|
description: 'Default knowledge base',
|
|
num_documents: 0,
|
|
num_entities: 0,
|
|
num_relations: 0,
|
|
}
|
|
]
|
|
}
|
|
}
|
|
|
|
export async function fetchKnowledgeBase(
|
|
tenantId: string,
|
|
kbId: string
|
|
): Promise<KnowledgeBase | null> {
|
|
try {
|
|
const response = await apiClient.get(`/api/v1/knowledge-bases/${kbId}`, {
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
})
|
|
return response.data
|
|
} catch (error) {
|
|
console.error(`Failed to fetch KB ${kbId}:`, error)
|
|
return null
|
|
}
|
|
}
|
|
|
|
export async function createKnowledgeBase(
|
|
tenantId: string,
|
|
name: string,
|
|
description?: string,
|
|
metadata?: Record<string, any>
|
|
): Promise<KnowledgeBase> {
|
|
const response = await apiClient.post(
|
|
'/api/v1/knowledge-bases',
|
|
{
|
|
name,
|
|
description,
|
|
metadata,
|
|
},
|
|
{
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
}
|
|
)
|
|
return response.data
|
|
}
|
|
|
|
export async function updateKnowledgeBase(
|
|
tenantId: string,
|
|
kbId: string,
|
|
updates: Partial<KnowledgeBase>
|
|
): Promise<KnowledgeBase> {
|
|
const response = await apiClient.put(
|
|
`/api/v1/knowledge-bases/${kbId}`,
|
|
updates,
|
|
{
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
}
|
|
)
|
|
return response.data
|
|
}
|
|
|
|
export async function deleteKnowledgeBase(tenantId: string, kbId: string): Promise<void> {
|
|
await apiClient.delete(`/api/v1/knowledge-bases/${kbId}`, {
|
|
headers: { 'X-Tenant-ID': tenantId }
|
|
})
|
|
}
|