How majenayu/cyber-sentinel works
CyberSentinel is a cybersecurity operations dashboard offered as web and mobile apps, backed by an Express API. Operators use the dashboard and specialist pages for AI chat, security lookups, reconnaissance, and intrusion monitoring; the API also supports a knowledge vault, saved references, and research automation. The excerpts verify app-to-router setup, push subscription calls, and the research pipeline; most feature-route internals and mobile API wiring were not sampled, so those connections are left out.
Main entry points: researcher.ts Research pipeline · index.ts API router · research.ts Research controls · App.tsx Web dashboard
Components 27
Operator clients
- Web dashboard
artifacts/cyber-sentinel/src/App.tsx - Mobile app
artifacts/cyber-sentinel-mobile/app/(tabs)/_layout.tsx - Security tools
artifacts/cyber-sentinel/src/pages - Intrusion map
artifacts/cyber-sentinel/src/pages/Intrusions.tsx - Push notifications
artifacts/cyber-sentinel/src/hooks/usePushNotifications.ts
API services
- API application
artifacts/api-server/src/app.ts - API router
artifacts/api-server/src/routes/index.ts - AI chat
artifacts/api-server/src/routes/chat.ts - Intrusion logging
artifacts/api-server/src/routes/intrusion.ts - Security lookups
artifacts/api-server/src/routes - Push API
artifacts/api-server/src/routes/push.ts - AI providers
artifacts/api-server/src/lib/multi-ai.ts - Web push service
artifacts/api-server/src/lib/push.ts
Research and knowledge
- Research controls
artifacts/api-server/src/routes/research.ts - Research pipeline
artifacts/api-server/src/lib/researcher.ts
Persistent state
- Database connection
artifacts/api-server/src/lib/mongodb.ts - Domain models
artifacts/api-server/src/lib/models - Research logs
artifacts/api-server/src/lib/models/ResearchLog.ts - Knowledge entries
artifacts/api-server/src/lib/models/Knowledge.ts - Tool catalog
artifacts/api-server/src/lib/models/Tool.ts - Saved commands
artifacts/api-server/src/lib/models/Command.ts - Push subscriptions
artifacts/api-server/src/lib/models/PushSubscription.ts
Other components
- Operator
- Groq
- Mistral
- Security sources
- MongoDB
Connections 31
- Operator → Web dashboard: uses
- Operator → Mobile app: uses
- Web dashboard → Security tools: navigates
- Web dashboard → Intrusion map: navigates
- Web dashboard → API application: API requests
- API application → API router: dispatches
- API router → AI chat
- API router → Intrusion logging
- API router → Security lookups
- API router → Push API
- AI chat → AI providers: requests answers
- AI providers → Groq: queries
- AI providers → Mistral: optionally queries
- Push notifications → Push API: fetches key, saves subscription
- Push notifications → Push API: requests test
- Push API → Web push service
- Web push service → Push subscriptions: reads subscriptions
- Research controls → Research pipeline: runs research
- Research controls → Research logs: records run
- Research controls → Knowledge entries: counts entries
- Research pipeline → Security sources: scrapes
- Research pipeline → AI providers: requests analysis
- Research pipeline → Database connection: connects
- Research pipeline → Knowledge entries: creates entries
- Research pipeline → Tool catalog: creates references
- Research pipeline → Saved commands: creates commands
- Research pipeline → Research logs: notifies progress to caller
- Database connection → MongoDB: connects
- Research controls → Database connection: connects
- Intrusion logging → Database connection: uses storage
- Domain models → MongoDB: persisted in