Public Workspaces Feature

Public Workspaces Feature

Version Implemented: 0.229.001

Overview

Public Workspaces represents a revolutionary enhancement to SimpleChat's document sharing and collaboration capabilities. This feature introduces organization-wide document repositories that are accessible to all users, dramatically expanding knowledge sharing and collaboration across teams.

Purpose

Public Workspaces enable organizations to:

• Create shared knowledge repositories accessible to all users
• Reduce document duplication across groups and personal workspaces
• Improve organization-wide knowledge discovery and access
• Establish centralized document management for company-wide resources
• Enable seamless collaboration without explicit group memberships

Technical Specifications

Architecture Overview

• Storage Layer: New public_documents_container in Cosmos DB
• Search Integration: Dedicated public documents index in Azure AI Search
• Access Control: Organization-wide read access with admin-controlled write permissions
• UI Integration: Seamless workspace scope switching in chat interface

Database Schema

{
  "id": "document-uuid",
  "user_id": "uploader-id",
  "filename": "document.pdf",
  "content": "extracted-text-content",
  "metadata": {
    "upload_date": "2025-09-12T10:30:00Z",
    "file_size": 1024000,
    "content_type": "application/pdf",
    "author": "John Doe",
    "keywords": ["policy", "procedures"],
    "classification": "company-wide"
  },
  "chunk_id": "chunk-1",
  "chunk_text": "Document content chunk",
  "is_public": true,
  "organization_id": "tenant-id"
}

API Endpoints

• GET /api/public/documents - List public documents
• POST /api/public/documents/upload - Upload to public workspace (admin only)
• DELETE /api/public/documents/{id} - Remove public document (admin only)
• GET /api/public/documents/search - Search public documents

Configuration Options

Admin Settings

• Enable Public Workspaces: Toggle public workspace functionality
• Public Upload Permissions: Control who can upload to public workspaces
• Public Document Classification: Configure classification schemes for public documents
• Search Integration: Enable/disable public document search in AI Search

Workspace Scope Selection

// New workspace scope options
const workspaceScopes = [
    { value: 'personal', label: 'Personal Workspace' },
    { value: 'group', label: 'Group: [Group Name]' },
    { value: 'public', label: 'Public Workspace' }
];

Usage Instructions

For End Users

Accessing Public Workspaces

1. Navigate to the chat interface
2. Use the workspace scope selector (top of chat)
3. Select "Public Workspace" from the dropdown
4. Chat responses will now include public documents in search results

Viewing Public Documents

1. Navigate to "Workspaces" → "Public Workspace"
2. Browse all organization-wide documents
3. Use search and filter functionality to find specific documents
4. View document metadata and classifications

For Administrators

Enabling Public Workspaces

1. Access Admin Settings
2. Navigate to "Workspaces" tab
3. Enable "Public Workspaces" feature
4. Configure upload permissions and classification schemes

Managing Public Documents

1. Access "Public Workspace" management interface
2. Upload documents using enhanced upload interface
3. Set appropriate classifications and metadata
4. Monitor document usage and access patterns

Integration Points

Chat Interface Integration

• Workspace scope selector includes public workspace option
• Search results clearly indicate public document sources
• Citations reference public workspace documents appropriately

Document Management Integration

• Public workspace documents appear in unified document listings
• Enhanced metadata extraction applies to public documents
• Classification and tagging systems work across all workspace types

Group Workspace Integration

• Public documents complement group-specific documents
• No duplication between public and group workspaces
• Seamless switching between workspace scopes during conversations

Testing and Validation

Functional Testing

• Verify public workspace creation and management
• Test document upload and retrieval across different user roles
• Validate search functionality across workspace scopes
• Confirm proper access controls and permissions

Performance Considerations

• Public workspace searches are optimized for large document volumes
• Caching mechanisms reduce load times for frequently accessed documents
• Indexing strategies ensure fast search across all workspace types

Security Testing

• Validate organization-wide access controls
• Test document isolation between different tenants
• Verify admin-only upload restrictions work correctly

Known Limitations

• Public workspace documents are read-only for non-admin users
• Large organizations may experience slower search performance with extensive public document collections
• Document versioning is not currently supported in public workspaces

Migration Notes

• Existing group documents can be promoted to public workspace status
• No breaking changes to existing personal or group workspace functionality
• Public workspace feature is backward compatible with existing installations

Future Enhancements

• Document versioning and approval workflows
• Advanced analytics and usage tracking for public documents
• Integration with external document management systems
• Automated content curation and recommendation systems

Support and Troubleshooting

• Ensure adequate Azure AI Search capacity for organization-wide document indexing
• Monitor Cosmos DB throughput for public document operations
• Review access logs for public workspace usage patterns
• Configure appropriate backup and retention policies for public documents