How satvik219/reqsphere-ai works
ReqSphere AI turns business evidence into traceable requirements and BRDs. Users sign in, work in a project workspace, review evidence and extracted requirements, resolve conflicts and gaps, and generate a traceable BRD. The frontend data boundary supports mock data or the Express API; backend extraction can call Gemini. The README also documents risks, dependencies, and change views. Edges reflect the supplied excerpts and README; unsampled UI and route wiring is not inferred.
Main entry points: app.js Express API app · authRoutes.js Authentication routes · apiRoutes.js Workspace API routes · authService.js Session and auth
Components 21
Frontend experience
- Sign-in screens
frontend/src/components/auth/LoginPage.jsx - Registration screen
frontend/src/components/auth/SignupPage.jsx - Workspace views
frontend/src/main.jsx - Workspace data services
frontend/src/services/data.js - Mock domain data
frontend/src/mocks - Session and auth
frontend/src/auth/authService.js - HTTP client
frontend/src/api/client.js
API and identity
- Express API app
backend/src/app.js - Authentication routes
backend/src/routes/authRoutes.js - JWT middleware
backend/src/middleware/auth.js - User repository
backend/src/repositories/userRepository.js - Workspace API routes
backend/src/routes/apiRoutes.js - Runtime configuration
backend/src/config.js
Requirements intelligence
- Workspace repository
backend/src/repositories/localRepository.js - Workspace analysis and BRD
backend/src/services/workspaceService.js - Requirement extraction
backend/src/services/ai/requirementAgent.js - Requirement validation schema
backend/src/schemas/requirementSchema.js
External services
- Gemini client
backend/src/services/ai/geminiClient.js - Firebase authentication
- Vertex AI / Gemini
Other components
- Business analyst
Connections 26
- Business analyst → Sign-in screens: signs in
- Business analyst → Registration screen: registers
- Business analyst → Workspace views: uses workspace
frontend/src/main.jsx - Workspace views → Workspace data services: loads domain data
frontend/src/main.jsx - Workspace data services → Mock domain data: reads in mock mode
frontend/src/services/data.js - Workspace data services → HTTP client: requests in API mode
frontend/src/services/data.js - Sign-in screens → Session and auth: invokes auth
frontend/src/components/auth/LoginPage.jsx - Registration screen → Session and auth: invokes registration
frontend/src/components/auth/SignupPage.jsx - Session and auth → HTTP client: sends auth requests
frontend/src/auth/authService.js - Session and auth → Firebase authentication: obtains Google token
frontend/src/auth/authService.js - HTTP client → Express API app: calls API
- Express API app → Authentication routes: mounts auth routes
backend/src/app.js - Express API app → JWT middleware: protects API routes
backend/src/app.js - Express API app → Workspace API routes: mounts protected routes
backend/src/app.js - Authentication routes → User repository: authenticates and registers
backend/src/routes/authRoutes.js - Authentication routes → Runtime configuration: signs JWTs
backend/src/routes/authRoutes.js - JWT middleware → Runtime configuration: reads JWT settings
backend/src/middleware/auth.js - Workspace API routes → Workspace repository: reads and updates records
backend/src/routes/apiRoutes.js - Workspace API routes → Workspace analysis and BRD: requests summaries and BRD
backend/src/routes/apiRoutes.js - Workspace analysis and BRD → Workspace repository: aggregates and reads data
backend/src/services/workspaceService.js - Workspace API routes → Requirement extraction: extracts requirements
backend/src/routes/apiRoutes.js - Requirement extraction → Requirement validation schema: validates output
backend/src/services/ai/requirementAgent.js - Requirement extraction → Gemini client: requests generation
backend/src/services/ai/requirementAgent.js - Gemini client → Runtime configuration: loads model settings
backend/src/services/ai/geminiClient.js - Gemini client → Vertex AI / Gemini: generates text
backend/src/services/ai/geminiClient.js - Authentication routes → Firebase authentication: verifies ID token