How nikhil-4404/trustshare works
TrustShare is a secure file-sharing platform with a React client and FastAPI server. Users authenticate, organize and upload files, share them directly or through public links, and access shared files; the server also provides search, summaries, assistant chat, analytics, audit activity, and administration. The graph shows documented product capabilities and sampled controller responsibilities. Some backend service-to-storage wiring and several feature implementations were not included in the excerpts, so those relationships are left unspecified.
Main entry points: App.js React app · controller.py Analytics endpoints · api.py FastAPI application · SharingHub.js Sharing hub
Components 25
Web client
- React app
project-root/client/src/App.js - File workspace
project-root/client/src/features/myFiles/MyFiles.js - Sharing hub
project-root/client/src/features/sharing/SharingHub.js - Analytics UI
project-root/client/src/features/analytics/Analytics.js - Assistant UI
project-root/client/src/features/assistant/AssistantPage.js
Identity and access
- Auth endpoints
project-root/server/src/auth/controller.py - Auth service
project-root/server/src/auth/service.py
Files and sharing
- File endpoints
project-root/server/src/files/controller.py - File service
project-root/server/src/files/service.py - Shared files
project-root/server/src/shared_with_me/controller.py - Share links
project-root/server/src/shares/controller.py - Folders
project-root/server/src/folders/controller.py - Content search
project-root/server/src/search/controller.py
Insights and assistant
- File summaries
project-root/server/src/file_summaries/controller.py - Analytics endpoints
project-root/server/src/analytics/controller.py - Analytics service
project-root/server/src/analytics/service.py - Activity stream
project-root/server/src/activity/controller.py - Assistant chat
project-root/server/src/assistant/controller.py - Chat service
project-root/server/src/assistant/chat_service.py
API and persistence
- Admin controls
project-root/server/src/admin/controller.py - PostgreSQL
project-root/server/src/database/core.py - Encrypted storage
project-root/server/src/security/secure_storage.py - FastAPI application
project-root/server/src/api.py
Other components
- User
- LLM provider
Connections 22
- User → React app: uses
- React app → File workspace: opens
- React app → Sharing hub: opens
- React app → Analytics UI: opens
- React app → Assistant UI: opens
- File workspace → File endpoints: file requests
- Sharing hub → Share links: share requests
- Sharing hub → Shared files: shared-file requests
- Analytics UI → Analytics endpoints: analytics requests
- Assistant UI → Assistant chat: chat requests
- Auth endpoints → Auth service: calls
- File endpoints → File service: calls
- Shared files → File service: retrieves file
- Assistant chat → Chat service: calls
- Chat service → LLM provider: sends prompts
- Analytics endpoints → Analytics service: requests metrics
- Analytics endpoints → PostgreSQL: queries
- Auth endpoints → PostgreSQL: reads and writes
- Admin controls → PostgreSQL: queries and updates
- FastAPI application → Auth endpoints: serves routes
- FastAPI application → File endpoints: serves routes
- FastAPI application → Analytics endpoints: serves routes