How vishalmalik-code/major_project works
This is a local model-extraction detection firewall: users and attack simulators submit queries through the same chat path, which analyzes query history and structure, updates client risk, then allows, monitors, throttles, or blocks before any permitted query reaches Ollama. Separate branches provide admin visibility, authenticated conversation features, and repeatable fast/slow evaluations. The README and sampled source establish the main flow; some route and UI details are represented at subsystem level because their implementations were not sampled.
Main entry points: chat_service.py Chat orchestration · client.js API client · engine.py Decision engine · admin.py Admin API
Components 24
Clients and UI
- React app
frontend/src/App.jsx - User chat
frontend/src/pages/UserChat.jsx - API client
frontend/src/api/client.js - Attacker CLI
backend/attacker.py - Attack strategies
backend/app/attacker/registry.py - HTTP client
backend/attacker_cli/http_client.py - User personas
backend/normal_user_cli/base.py - Session auth
frontend/src/AuthContext.jsx
Firewall analysis
- Query window
backend/app/firewall/window.py - Query embeddings
backend/app/embeddings/encoder.py - Decision engine
backend/app/firewall/engine.py - Detection signals
backend/app/firewall/signals
Backend services
- Chat endpoint
backend/app/api/routes/chat.py - Chat orchestration
backend/app/services/chat_service.py - Data repository
backend/app/db/repository.py - PostgreSQL
- LLM adapter
backend/app/services/llm.py - Live event buses
backend/app/services/conversation_events.py
Admin and evaluation
- Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Admin API
backend/app/api/routes/admin.py - Evaluation sessions
backend/evaluation/sessions.py - Evaluation runner
backend/evaluation/runner.py
Other components
- Normal user
- Ollama model
Connections 26
- Normal user → User chat: submits query
README.md - React app → User chat: routes to
frontend/src/App.jsx - User chat → API client: sends chat
frontend/src/api/client.js - API client → Chat endpoint: POST chat
README.md - Attacker CLI → Attack strategies: selects patterns
backend/attacker.py - Attacker CLI → HTTP client: runs via
- HTTP client → Chat endpoint: POST chat
backend/attacker_cli/http_client.py - Chat endpoint → Chat orchestration: handles request
backend/app/main.py - Chat orchestration → Data repository: loads and saves
backend/app/services/chat_service.py - Chat orchestration → Query window: warms and commits
- Chat orchestration → Query embeddings: embeds query
backend/app/services/chat_service.py - Chat orchestration → Decision engine: requests decision
backend/app/services/chat_service.py - Decision engine → Query window: reads history
backend/app/firewall/engine.py - Decision engine → Detection signals: evaluates
backend/app/firewall/engine.py - Data repository → PostgreSQL: reads and writes
backend/app/db/repository.py - Chat orchestration → LLM adapter: generates if allowed
README.md - LLM adapter → Ollama model: generates response
README.md - Chat orchestration → Live event buses: publishes updates
backend/app/services/chat_service.py - Admin dashboard → API client: requests admin data
frontend/src/pages/AdminDashboard.jsx - API client → Admin API: calls admin API
frontend/src/api/client.js - Admin API → Data repository: reads records
backend/app/api/routes/admin.py - Admin API → Live event buses: streams updates
backend/app/api/routes/admin.py - Session auth → API client: authenticates
frontend/src/AuthContext.jsx - Evaluation sessions → Attack strategies: generates attack cases
backend/evaluation/sessions.py - Evaluation sessions → User personas: generates user cases
backend/evaluation/sessions.py - Evaluation runner → HTTP client: sends test queries
backend/evaluation/runner.py