How mohimabanerjee43-byte/vulnerasense-ai works
VulneraSense AI is a prototype vulnerability-screening product: users provide voice or text, the system analyzes input and classifies vulnerability, then presents assessment results and support recommendations. The repository has two backend paths: a Node assessment API with optional Python trust verification, and a separate FastAPI input/translation pipeline for transcription and acoustic features. The frontend also provides assessment, results, dashboard, voice, and resource experiences. Some frontend wiring and recommendation implementation details are not shown, so those connections are omitted unless documented.
Main entry points: main.py Input processing API · server.js Node API · routes/assessment.js Assessment endpoint · js/assessment.js Assessment UI
Components 24
User experience
- Web experience
index.html - Assessment UI
js/assessment.js - Voice input
js/voice.js - Audio tracking
js/audio_Tracker.js - Results and charts
js/charts.js - Recommendations UI
js/recommendation.js - Support resources
pages/resources.html
Screening and support
- Node API
backend/server.js - Assessment endpoint
backend/routes/assessment.js - Signal analysis
backend/services/nlp.js - Risk classification
backend/services/riskEngine.js - Analysis coordinator
backend/services/aiModel.js - Recommendation endpoint
backend/routes/recommendations.js
Voice and language input
- Input processing API
app/main.py - Pipeline data models
app/schemas/input_schema.py - Acoustic analysis
app/services/audio_service.py - Speech transcription
app/services/stt_service.py - Text translation
app/main.py
Trust verification
- Security service
backend/security_service/app.py - Trust evaluation
backend/security_service/trust_engine.py - Audio verification
backend/security_service/audio_analyzer.py
Other components
- User
- Translator services
- Web Speech API
Connections 24
- User → Web experience: uses
README.md - Web experience → Assessment UI: offers screening
- Assessment UI → Node API: submits text
- Voice input → Web Speech API: uses speech
README.md - Voice input → Assessment UI: provides input
- Assessment UI → Results and charts: shows results
- Results and charts → Recommendations UI: presents pathway
README.md - Recommendations UI → Support resources: offers support
- Node API → Assessment endpoint: mounts route
backend/server.js - Node API → Recommendation endpoint: mounts route
backend/server.js - Assessment endpoint → Analysis coordinator: analyzes text
backend/routes/assessment.js - Analysis coordinator → Signal analysis: extracts signals
backend/services/aiModel.js - Analysis coordinator → Risk classification: classifies risk
backend/services/aiModel.js - Assessment endpoint → Security service: requests trust check
backend/routes/assessment.js - Assessment endpoint → User: returns assessment
backend/routes/assessment.js - Recommendation endpoint → User: returns recommendations
- Input processing API → Acoustic analysis: extracts features
app/main.py - Input processing API → Speech transcription: transcribes audio
app/main.py - Input processing API → Pipeline data models: returns validated output
app/main.py - Input processing API → Translator services: translates text
app/main.py - Input processing API → User: returns processed input
- Node API → Security service: proxies audio update
backend/server.js - Security service → Trust evaluation: evaluates reports
backend/security_service/app.py - Security service → Audio verification: analyzes audio
backend/security_service/app.py