How vedevpatel/logicortex works
Logicortex is an application-security platform with a Next.js user interface and a FastAPI backend. The visible account workflow supports email registration/login and GitHub/Google OAuth, with users and organizations persisted in the database; GitHub App integration lets an organization connect and list repositories. The dashboard and scan-detail pages represent the product’s scan workflow, while remediation and symbolic analysis are separate backend capabilities. The README describes AI-assisted finding, fixing, and prediction, but the available files do not show a scan orchestration pipeline. The graph therefore avoids asserting unshown frontend API calls or scan-processing links.
Main entry points: oauth.py OAuth routes · main.py API application · auth.py Account routes · github.py GitHub integration
Components 24
Web application
- Login and signup
frontend/app/login/page.tsx - OAuth callback
frontend/app/auth/callback/page.tsx - Auth context
frontend/context/AuthContext.tsx - Scan dashboard
frontend/app/dashboard/page.tsx - Scan detail
frontend/app/dashboard/scans/[scanId]/page.tsx - Team page
frontend/app/dashboard/team/page.tsx
Backend API
- API application
backend/app/main.py - Organization routes
backend/app/api/endpoints/organizations.py - User routes
backend/app/api/endpoints/users.py - Application settings
backend/app/core/config.py
Identity and access
- Account routes
backend/app/api/endpoints/auth.py - OAuth routes
backend/app/api/endpoints/oauth.py - Access dependencies
backend/app/api/deps.py - Token security
backend/app/core/security.py
Security capabilities
- GitHub integration
backend/app/api/endpoints/github.py - Remediation
backend/app/api/endpoints/remediation.py - Symbolic engine
backend/app/symbolic_engine.py
Persistence
- Database sessions
backend/app/db/session.py - User records
backend/app/db/models/user.py - Organization records
backend/app/db/models/organization.py
Other components
- User
- GitHub
- PostgreSQL
Connections 28
- User → Login and signup: uses
frontend/app/login/page.tsx - User → Scan dashboard: views
frontend/app/dashboard/page.tsx - API application → Account routes: registers
backend/app/main.py - API application → OAuth routes: registers
backend/app/main.py - API application → Organization routes: registers
backend/app/main.py - API application → GitHub integration: registers
backend/app/main.py - API application → User routes: registers
backend/app/main.py - Account routes → Token security: hashes and signs
backend/app/api/endpoints/auth.py - OAuth routes → Token security: signs token
backend/app/api/endpoints/oauth.py - OAuth routes → OAuth callback: redirects token
backend/app/api/endpoints/oauth.py - OAuth routes → GitHub: exchanges credentials
backend/app/api/endpoints/oauth.py - OAuth routes → Google: exchanges credentials
backend/app/api/endpoints/oauth.py - GitHub integration → GitHub: fetches repositories
backend/app/api/endpoints/github.py - GitHub integration → Access dependencies: requires user
backend/app/api/endpoints/github.py - Account routes → Access dependencies: uses database dependency
backend/app/api/endpoints/auth.py - Access dependencies → Database sessions: opens session
backend/app/api/deps.py - Access dependencies → Token security: decodes token
backend/app/api/deps.py - Database sessions → Application settings: reads database URL
backend/app/db/session.py - Account routes → User records: creates and queries
backend/app/api/endpoints/auth.py - Account routes → Organization records: creates organization
backend/app/api/endpoints/auth.py - OAuth routes → User records: queries or creates
backend/app/api/endpoints/oauth.py - OAuth routes → Organization records: creates organization
backend/app/api/endpoints/oauth.py - GitHub integration → Organization records: updates installation
backend/app/api/endpoints/github.py - Organization routes → User records: uses member records
backend/app/api/endpoints/organizations.py - Organization routes → Organization records: manages organizations
backend/app/api/endpoints/organizations.py - User routes → User records: reads user
backend/app/api/endpoints/users.py - Database sessions → PostgreSQL: connects
- Scan dashboard → Scan detail: opens scan