How cpk2006/specmind-ai works
SpecMind AI turns either an idea or an uploaded specification into a persistent requirements workspace with tests, quality findings, diagrams, and exportable SRS content. Users enter through the React workspace and FastAPI routes; project and requirement workflows invoke the relevant services, which coordinate AI generation, document handling, and persistence. The README documents provider failover and broader workspace features, but some implementation files and frontend API calls were not excerpted, so those relationships are shown only where documentation or the source index supports them.
Main entry points: requirement_service.py Requirement workflow · project.py Project routes · auth_dependencies.py JWT authorization · main.py FastAPI app
Components 24
Web workspace
- Workspace UI
frontend/src/main.jsx - Diagram preview
frontend/src/components/DiagramPreview.jsx - Diagram utilities
frontend/src/diagramUtils.js
API and identity
- FastAPI app
backend/app/main.py - Auth routes
backend/app/api/v1/routers/auth.py - Project routes
backend/app/api/v1/routers/project.py - Requirement routes
backend/app/api/v1/routers/requirement.py - JWT authorization
backend/app/core/auth_dependencies.py - Token security
backend/app/core/security.py
Requirements workflows
- Project workflow
backend/app/services/project_service.py - Requirement workflow
backend/app/services/requirement_service.py
AI and documents
- AI generation and review
backend/app/ai/gemini_service.py - Prompt resources
backend/app/ai/prompts.py - Document parsing
backend/app/utils/document_parser.py - Upload storage
backend/app/utils/file_storage.py
Persistence
- Project repository
backend/app/repositories/project_repository.py - Requirement repository
backend/app/repositories/requirement_repository.py - Domain records
backend/app/models/project.py - Requirement record
backend/app/models/requirement.py - User record
backend/app/models/user.py - Database sessions
backend/app/database/session.py
Other components
- Team member
- PostgreSQL
- AI providers
Connections 28
- Team member → Workspace UI: uses
- Workspace UI → Diagram preview: renders diagrams
frontend/src/main.jsx - Diagram preview → Diagram utilities: uses
frontend/src/components/DiagramPreview.jsx - Workspace UI → FastAPI app: calls API
- FastAPI app → Auth routes: registers
backend/app/main.py - FastAPI app → Project routes: registers
backend/app/main.py - FastAPI app → Requirement routes: registers
backend/app/main.py - Auth routes → Token security: uses
backend/app/api/v1/routers/auth.py - Project routes → JWT authorization: authorizes
backend/app/api/v1/routers/project.py - Requirement routes → JWT authorization: authorizes
backend/app/api/v1/routers/requirement.py - JWT authorization → Token security: decodes token
backend/app/core/auth_dependencies.py - JWT authorization → User record: loads user
backend/app/core/auth_dependencies.py - Project routes → Project workflow: delegates
backend/app/api/v1/routers/project.py - Project routes → Requirement workflow: requests report
backend/app/api/v1/routers/project.py - Requirement routes → Requirement workflow: delegates
backend/app/api/v1/routers/requirement.py - Project workflow → Project repository: delegates
backend/app/services/project_service.py - Requirement workflow → Requirement repository: reads and saves
backend/app/services/requirement_service.py - Requirement workflow → Project repository: loads project
backend/app/services/requirement_service.py - Requirement workflow → AI generation and review: generates and reviews
backend/app/services/requirement_service.py - Requirement workflow → Document parsing: extracts text
backend/app/services/requirement_service.py - Requirement workflow → Upload storage: saves uploads
backend/app/services/requirement_service.py - Project routes → AI generation and review: generates and repairs diagrams
backend/app/api/v1/routers/project.py - AI generation and review → Prompt resources: uses prompts
backend/app/ai/gemini_service.py - AI generation and review → AI providers: routes with failover
- Project repository → Domain records: persists projects
backend/app/repositories/project_repository.py - Requirement repository → Requirement record: persists requirements
backend/app/repositories/requirement_repository.py - JWT authorization → Database sessions: gets session
backend/app/core/auth_dependencies.py - Database sessions → PostgreSQL: connects