organization

type AddTenantMemberCommand struct {
	TenantID  string
	Email     string
	FullName  string
	Role      entity.TenantRole
	GrantedBy string
}

type CreateTenantCommand struct {
	Code        string
	Name        string
	Description string
}

type CreateWorkspaceCommand struct {
	TenantID  *string
	Code      string
	Name      string
	Type      entity.WorkspaceType
	CreatedBy string
}

type InviteMemberCommand struct {
	WorkspaceID string
	Email       string
	FullName    string
	Role        entity.WorkspaceRole
	InvitedBy   string
}

type RemoveMemberCommand struct {
	MemberID    string
	WorkspaceID string
	RemovedBy   string // The user performing the removal
}

type RemoveTenantMemberCommand struct {
	MemberID  string
	TenantID  string
	RemovedBy string // The user performing the removal
}

type TenantMemberUseCase interface {
	// ListMembers lists all members of a tenant.
	ListMembers(ctx context.Context, tenantID string) ([]*entity.TenantMemberWithUser, error)

	// GetMember retrieves a specific tenant member by ID.
	GetMember(ctx context.Context, memberID string) (*entity.TenantMemberWithUser, error)

	// AddMember adds a user to a tenant.
	// Creates a shadow user if the email doesn't exist.
	AddMember(ctx context.Context, cmd AddTenantMemberCommand) (*entity.TenantMemberWithUser, error)

	// UpdateMemberRole updates a tenant member's role.
	UpdateMemberRole(ctx context.Context, cmd UpdateTenantMemberRoleCommand) (*entity.TenantMemberWithUser, error)

	// RemoveMember removes a member from the tenant.
	RemoveMember(ctx context.Context, cmd RemoveTenantMemberCommand) error

	// CountOwners counts the number of TENANT_OWNER members in a tenant.
	CountOwners(ctx context.Context, tenantID string) (int, error)
}

type TenantUseCase interface {
	// CreateTenant creates a new tenant with its system workspace.
	CreateTenant(ctx context.Context, cmd CreateTenantCommand) (*entity.Tenant, error)

	// GetTenant retrieves a tenant by ID.
	GetTenant(ctx context.Context, id string) (*entity.Tenant, error)

	// GetTenantByCode retrieves a tenant by its code.
	GetTenantByCode(ctx context.Context, code string) (*entity.Tenant, error)

	// SearchTenants searches tenants by name or code similarity.
	SearchTenants(ctx context.Context, query string) ([]*entity.Tenant, error)

	// ListTenantsPaginated lists tenants with pagination.
	ListTenantsPaginated(ctx context.Context, filters port.TenantFilters) ([]*entity.Tenant, int64, error)

	// ListTenantWorkspaces lists workspaces for a tenant with optional search (system admin use).
	ListTenantWorkspaces(ctx context.Context, tenantID string, filters port.WorkspaceFilters) ([]*entity.Workspace, int64, error)

	// ListUserTenants lists all tenants a user belongs to with their roles.
	ListUserTenants(ctx context.Context, userID string) ([]*entity.TenantWithRole, error)

	// ListUserTenantsPaginated lists tenants a user belongs to with pagination and optional search.
	// When filters.Query is provided, orders by similarity. Otherwise, orders by access history.
	ListUserTenantsPaginated(ctx context.Context, userID string, filters port.TenantMemberFilters) ([]*entity.TenantWithRole, int64, error)

	// UpdateTenant updates a tenant's details.
	UpdateTenant(ctx context.Context, cmd UpdateTenantCommand) (*entity.Tenant, error)

	// UpdateTenantStatus updates a tenant's status (ACTIVE, SUSPENDED, ARCHIVED).
	UpdateTenantStatus(ctx context.Context, cmd UpdateTenantStatusCommand) (*entity.Tenant, error)

	// DeleteTenant deletes a tenant and all its data.
	DeleteTenant(ctx context.Context, id string) error
}

type UpdateMemberRoleCommand struct {
	MemberID    string
	WorkspaceID string
	NewRole     entity.WorkspaceRole
	UpdatedBy   string // The user performing the update
}

type UpdateTenantCommand struct {
	ID          string
	Name        string
	Description string
	Settings    map[string]any
}

type UpdateTenantMemberRoleCommand struct {
	MemberID  string
	TenantID  string
	NewRole   entity.TenantRole
	UpdatedBy string // The user performing the update
}

type UpdateTenantStatusCommand struct {
	ID     string
	Status entity.TenantStatus
}

type UpdateWorkspaceCommand struct {
	ID   string
	Code string
	Name string
}

type UpdateWorkspaceStatusCommand struct {
	ID     string
	Status entity.WorkspaceStatus
}

type WorkspaceMemberUseCase interface {
	// ListMembers lists all members of a workspace.
	ListMembers(ctx context.Context, workspaceID string) ([]*entity.MemberWithUser, error)

	// GetMember retrieves a specific member by ID.
	GetMember(ctx context.Context, memberID string) (*entity.MemberWithUser, error)

	// InviteMember invites a user to join a workspace.
	// Creates a shadow user if the email doesn't exist.
	InviteMember(ctx context.Context, cmd InviteMemberCommand) (*entity.MemberWithUser, error)

	// UpdateMemberRole updates a member's role within the workspace.
	UpdateMemberRole(ctx context.Context, cmd UpdateMemberRoleCommand) (*entity.MemberWithUser, error)

	// RemoveMember removes a member from the workspace.
	RemoveMember(ctx context.Context, cmd RemoveMemberCommand) error
}

type WorkspaceUseCase interface {
	// CreateWorkspace creates a new workspace.
	CreateWorkspace(ctx context.Context, cmd CreateWorkspaceCommand) (*entity.Workspace, error)

	// GetWorkspace retrieves a workspace by ID.
	GetWorkspace(ctx context.Context, id string) (*entity.Workspace, error)

	// ListUserWorkspaces lists all workspaces a user has access to.
	ListUserWorkspaces(ctx context.Context, userID string) ([]*entity.WorkspaceWithRole, error)

	// ListWorkspacesPaginated lists workspaces for a tenant with pagination and optional search.
	// When filters.Query is provided, orders by similarity. Otherwise, orders by access history.
	ListWorkspacesPaginated(ctx context.Context, tenantID, userID string, filters port.WorkspaceFilters) ([]*entity.Workspace, int64, error)

	// UpdateWorkspace updates a workspace's details.
	UpdateWorkspace(ctx context.Context, cmd UpdateWorkspaceCommand) (*entity.Workspace, error)

	// ArchiveWorkspace archives a workspace (soft delete).
	ArchiveWorkspace(ctx context.Context, id string) error

	// ActivateWorkspace activates a workspace.
	ActivateWorkspace(ctx context.Context, id string) error

	// UpdateWorkspaceStatus updates a workspace's status (ACTIVE, SUSPENDED, ARCHIVED).
	UpdateWorkspaceStatus(ctx context.Context, cmd UpdateWorkspaceStatusCommand) (*entity.Workspace, error)

	// GetSystemWorkspace retrieves the system workspace for a tenant.
	GetSystemWorkspace(ctx context.Context, tenantID *string) (*entity.Workspace, error)
}