Chris Coutinho
4cce4f6392
Add comprehensive admin controls for the unified search provider and enhance the frontend UI with filtering and visualization improvements. **Admin Settings:** - Configure default search algorithm (hybrid, semantic, bm25) - Set fusion method for hybrid search (rrf, dbsf) - Adjust minimum score threshold (0-100%) - Set result limit (1-100 results) **Frontend Enhancements:** - Add score-based result filtering with slider control - Add expandable excerpts for search results - Improve result visualization and formatting - Add algorithm badge to show search method used **API Changes:** - Add `/api/admin/search-settings` POST endpoint - Add `searchForUnifiedSearch()` method to McpServerClient - Load and apply admin settings in SemanticSearchProvider **Technical Details:** - Settings stored in app config table - Defaults: hybrid algorithm, rrf fusion, 0% threshold, 20 results - SemanticSearchProvider respects admin-configured limits 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
308 lines
11 KiB
PHP
308 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Admin settings template for Astroglobe.
|
|
*
|
|
* Displays semantic search service status, indexing metrics, configuration,
|
|
* and provides administrative controls.
|
|
*
|
|
* @var array $_ Template parameters
|
|
* @var array $_['serverStatus'] Server status from API
|
|
* @var array $_['vectorSyncStatus'] Vector sync metrics from API
|
|
* @var string $_['serverUrl'] Configured Astroglobe service URL
|
|
* @var bool $_['apiKeyConfigured'] Whether API key is set in config.php
|
|
* @var bool $_['vectorSyncEnabled'] Whether vector sync is enabled
|
|
*/
|
|
|
|
script('astroglobe', 'astroglobe-adminSettings');
|
|
style('astroglobe', 'astroglobe-settings');
|
|
?>
|
|
|
|
<div id="mcp-admin-settings" class="section">
|
|
<h2><?php p($l->t('Astroglobe Administration')); ?></h2>
|
|
|
|
<div class="mcp-settings-info">
|
|
<p><?php p($l->t('Monitor and configure the semantic search service for your Nextcloud instance.')); ?></p>
|
|
</div>
|
|
|
|
<!-- Configuration Status -->
|
|
<div class="mcp-status-card">
|
|
<h3><?php p($l->t('Configuration')); ?></h3>
|
|
<table class="mcp-info-table">
|
|
<tr>
|
|
<td><strong><?php p($l->t('Service URL')); ?></strong></td>
|
|
<td>
|
|
<?php if (!empty($_['serverUrl'])): ?>
|
|
<code><?php p($_['serverUrl']); ?></code>
|
|
<?php else: ?>
|
|
<span class="error"><?php p($l->t('Not configured')); ?></span>
|
|
<?php endif; ?>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('API Key')); ?></strong></td>
|
|
<td>
|
|
<?php if ($_['apiKeyConfigured']): ?>
|
|
<span class="badge badge-success">
|
|
<span class="icon icon-checkmark-white"></span>
|
|
<?php p($l->t('Configured')); ?>
|
|
</span>
|
|
<?php else: ?>
|
|
<span class="badge badge-warning">
|
|
<span class="icon icon-alert"></span>
|
|
<?php p($l->t('Not configured')); ?>
|
|
</span>
|
|
<?php endif; ?>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<?php if (empty($_['serverUrl']) || !$_['apiKeyConfigured']): ?>
|
|
<div class="notecard notecard-warning">
|
|
<p><strong><?php p($l->t('Configuration Required')); ?></strong></p>
|
|
<p><?php p($l->t('Add the following to your config.php:')); ?></p>
|
|
<pre><code>'mcp_server_url' => 'http://localhost:8000',
|
|
'mcp_server_api_key' => 'your-secret-api-key',</code></pre>
|
|
<p class="mcp-help-text">
|
|
<a href="https://github.com/cbcoutinho/nextcloud-mcp-server" target="_blank">
|
|
<?php p($l->t('See documentation for details')); ?>
|
|
</a>
|
|
</p>
|
|
</div>
|
|
<?php endif; ?>
|
|
</div>
|
|
|
|
<!-- Service Status -->
|
|
<div class="mcp-status-card">
|
|
<h3><?php p($l->t('Service Status')); ?></h3>
|
|
<table class="mcp-info-table">
|
|
<tr>
|
|
<td><strong><?php p($l->t('Version')); ?></strong></td>
|
|
<td><?php p($_['serverStatus']['version'] ?? 'Unknown'); ?></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Uptime')); ?></strong></td>
|
|
<td>
|
|
<?php if (isset($_['serverStatus']['uptime_seconds'])): ?>
|
|
<?php
|
|
$uptime = $_['serverStatus']['uptime_seconds'];
|
|
$hours = floor($uptime / 3600);
|
|
$minutes = floor(($uptime % 3600) / 60);
|
|
p(sprintf('%d hours, %d minutes', $hours, $minutes));
|
|
?>
|
|
<?php else: ?>
|
|
<?php p($l->t('Unknown')); ?>
|
|
<?php endif; ?>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Semantic Search')); ?></strong></td>
|
|
<td>
|
|
<?php if ($_['vectorSyncEnabled']): ?>
|
|
<span class="badge badge-success">
|
|
<span class="icon icon-checkmark-white"></span>
|
|
<?php p($l->t('Enabled')); ?>
|
|
</span>
|
|
<?php else: ?>
|
|
<span class="badge badge-neutral">
|
|
<?php p($l->t('Disabled')); ?>
|
|
</span>
|
|
<?php endif; ?>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
<!-- Indexing Metrics -->
|
|
<?php if ($_['vectorSyncEnabled'] && !isset($_['vectorSyncStatus']['error'])): ?>
|
|
<div class="mcp-status-card" id="vector-sync-metrics">
|
|
<h3><?php p($l->t('Indexing Metrics')); ?></h3>
|
|
<table class="mcp-info-table">
|
|
<tr>
|
|
<td><strong><?php p($l->t('Status')); ?></strong></td>
|
|
<td>
|
|
<?php
|
|
$status = $_['vectorSyncStatus']['status'] ?? 'unknown';
|
|
$statusClass = $status === 'idle' ? 'success' : ($status === 'syncing' ? 'info' : 'neutral');
|
|
?>
|
|
<span class="badge badge-<?php p($statusClass); ?>">
|
|
<?php p(ucfirst($status)); ?>
|
|
</span>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Indexed Documents')); ?></strong></td>
|
|
<td><?php p(number_format($_['vectorSyncStatus']['indexed_documents'] ?? 0)); ?></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Pending Documents')); ?></strong></td>
|
|
<td><?php p(number_format($_['vectorSyncStatus']['pending_documents'] ?? 0)); ?></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Last Sync')); ?></strong></td>
|
|
<td><?php p($_['vectorSyncStatus']['last_sync_time'] ?? 'Never'); ?></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Processing Rate')); ?></strong></td>
|
|
<td><?php p(sprintf('%.1f docs/sec', $_['vectorSyncStatus']['documents_per_second'] ?? 0)); ?></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong><?php p($l->t('Errors (24h)')); ?></strong></td>
|
|
<td>
|
|
<?php
|
|
$errors = $_['vectorSyncStatus']['errors_24h'] ?? 0;
|
|
if ($errors > 0): ?>
|
|
<span class="error"><?php p($errors); ?></span>
|
|
<?php else: ?>
|
|
<?php p('0'); ?>
|
|
<?php endif; ?>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p class="mcp-help-text">
|
|
<?php p($l->t('Metrics are updated in real-time. Refresh the page to see latest values.')); ?>
|
|
</p>
|
|
</div>
|
|
<?php elseif ($_['vectorSyncEnabled']): ?>
|
|
<div class="mcp-status-card mcp-error">
|
|
<h3><?php p($l->t('Indexing Metrics')); ?></h3>
|
|
<div class="notecard notecard-error">
|
|
<p><?php p($l->t('Failed to retrieve indexing status:')); ?></p>
|
|
<p><code><?php p($_['vectorSyncStatus']['error'] ?? 'Unknown error'); ?></code></p>
|
|
</div>
|
|
</div>
|
|
<?php endif; ?>
|
|
|
|
<!-- Search Settings -->
|
|
<?php if ($_['vectorSyncEnabled']): ?>
|
|
<div class="mcp-status-card" id="search-settings">
|
|
<h3><?php p($l->t('AI Search Provider Settings')); ?></h3>
|
|
<p class="mcp-settings-description">
|
|
<?php p($l->t('Configure the default search parameters for the AI Search provider in Nextcloud unified search.')); ?>
|
|
</p>
|
|
|
|
<form id="astroglobe-search-settings-form" class="mcp-settings-form">
|
|
<div class="mcp-form-group">
|
|
<label for="search-algorithm"><?php p($l->t('Search Algorithm')); ?></label>
|
|
<select id="search-algorithm" name="algorithm" class="mcp-select">
|
|
<option value="hybrid" <?php if ($_['searchSettings']['algorithm'] === 'hybrid') echo 'selected'; ?>>
|
|
<?php p($l->t('Hybrid (Recommended)')); ?>
|
|
</option>
|
|
<option value="semantic" <?php if ($_['searchSettings']['algorithm'] === 'semantic') echo 'selected'; ?>>
|
|
<?php p($l->t('Semantic Only')); ?>
|
|
</option>
|
|
<option value="bm25" <?php if ($_['searchSettings']['algorithm'] === 'bm25') echo 'selected'; ?>>
|
|
<?php p($l->t('Keyword (BM25) Only')); ?>
|
|
</option>
|
|
</select>
|
|
<p class="mcp-help-text">
|
|
<?php p($l->t('Hybrid combines semantic understanding with keyword matching. Semantic finds conceptually similar content. BM25 matches exact keywords.')); ?>
|
|
</p>
|
|
</div>
|
|
|
|
<div class="mcp-form-group">
|
|
<label for="search-fusion"><?php p($l->t('Fusion Method')); ?></label>
|
|
<select id="search-fusion" name="fusion" class="mcp-select">
|
|
<option value="rrf" <?php if ($_['searchSettings']['fusion'] === 'rrf') echo 'selected'; ?>>
|
|
<?php p($l->t('RRF - Reciprocal Rank Fusion (Recommended)')); ?>
|
|
</option>
|
|
<option value="dbsf" <?php if ($_['searchSettings']['fusion'] === 'dbsf') echo 'selected'; ?>>
|
|
<?php p($l->t('DBSF - Distribution-Based Score Fusion')); ?>
|
|
</option>
|
|
</select>
|
|
<p class="mcp-help-text">
|
|
<?php p($l->t('Only applies to hybrid search. RRF balances results well for most queries. DBSF may work better when keyword matches are over/under-weighted.')); ?>
|
|
</p>
|
|
</div>
|
|
|
|
<div class="mcp-form-group">
|
|
<label for="search-score-threshold">
|
|
<?php p($l->t('Minimum Score Threshold')); ?>:
|
|
<span id="score-threshold-value"><?php p($_['searchSettings']['scoreThreshold']); ?>%</span>
|
|
</label>
|
|
<input type="range"
|
|
id="search-score-threshold"
|
|
name="scoreThreshold"
|
|
min="0"
|
|
max="100"
|
|
step="5"
|
|
value="<?php p($_['searchSettings']['scoreThreshold']); ?>"
|
|
class="mcp-range" />
|
|
<p class="mcp-help-text">
|
|
<?php p($l->t('Filter out results below this relevance score. Set to 0 to show all results.')); ?>
|
|
</p>
|
|
</div>
|
|
|
|
<div class="mcp-form-group">
|
|
<label for="search-limit"><?php p($l->t('Maximum Results')); ?></label>
|
|
<input type="number"
|
|
id="search-limit"
|
|
name="limit"
|
|
min="5"
|
|
max="100"
|
|
step="5"
|
|
value="<?php p($_['searchSettings']['limit']); ?>"
|
|
class="mcp-input" />
|
|
<p class="mcp-help-text">
|
|
<?php p($l->t('Maximum number of results to return per search query (5-100).')); ?>
|
|
</p>
|
|
</div>
|
|
|
|
<div class="mcp-form-actions">
|
|
<button type="submit" class="primary">
|
|
<?php p($l->t('Save Settings')); ?>
|
|
</button>
|
|
<span id="search-settings-status" class="mcp-status-message"></span>
|
|
</div>
|
|
</form>
|
|
</div>
|
|
|
|
<?php endif; ?>
|
|
|
|
<!-- Capabilities -->
|
|
<div class="mcp-status-card">
|
|
<h3><?php p($l->t('Capabilities')); ?></h3>
|
|
<ul class="mcp-feature-list">
|
|
<li>
|
|
<span class="icon icon-search"></span>
|
|
<strong><?php p($l->t('Semantic Search')); ?></strong>
|
|
<p><?php p($l->t('Search by meaning across Notes, Files, Calendar, and Deck using natural language queries.')); ?></p>
|
|
</li>
|
|
<?php if ($_['vectorSyncEnabled']): ?>
|
|
<li>
|
|
<span class="icon icon-category-monitoring"></span>
|
|
<strong><?php p($l->t('Vector Visualization')); ?></strong>
|
|
<p><?php p($l->t('Explore content relationships in an interactive 2D visualization.')); ?></p>
|
|
</li>
|
|
<?php endif; ?>
|
|
<li>
|
|
<span class="icon icon-user"></span>
|
|
<strong><?php p($l->t('Per-User Indexing')); ?></strong>
|
|
<p><?php p($l->t('Users control their own content indexing via Personal Settings.')); ?></p>
|
|
</li>
|
|
<li>
|
|
<span class="icon icon-toggle"></span>
|
|
<strong><?php p($l->t('Hybrid Search')); ?></strong>
|
|
<p><?php p($l->t('Combines semantic understanding with keyword matching for optimal results.')); ?></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- Documentation -->
|
|
<div class="mcp-status-card">
|
|
<h3><?php p($l->t('Documentation')); ?></h3>
|
|
<ul class="mcp-links">
|
|
<li>
|
|
<a href="https://github.com/cbcoutinho/nextcloud-mcp-server/blob/master/docs/configuration.md" target="_blank">
|
|
<?php p($l->t('Configuration Guide')); ?>
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="https://github.com/cbcoutinho/nextcloud-mcp-server" target="_blank">
|
|
<?php p($l->t('GitHub Repository')); ?>
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|