How abdelalikholty/terasprint works
TeraSprint is an AI-assisted agile planning and coding platform. Users submit an idea for project generation, manage the resulting backlog and sprints, then work with an AI coding agent in a live IDE workspace. The graph preserves the documented planning, Kanban, sandbox execution, provider resilience, persistence, and GitHub capabilities. Several backend and frontend modules were not sampled; their nodes reflect the tree and README, and links are limited to indexed references or documented relationships.
Main entry points: CodingWorkspacePage.tsx IDE Workspace · App.tsx Application Routes · orchestrator.py Coding Orchestrator · api.ts API Client
Components 24
Planning & Projects
- Project Generator
frontend/src/pages/ProjectGeneratorPage.tsx - Agile Backlog
frontend/src/pages/dashboard/BacklogPage.tsx - Sprint Planning
frontend/src/pages/dashboard/SprintsPage.tsx
Coding Workspace
- IDE Workspace
frontend/src/pages/workspace/CodingWorkspacePage.tsx - Agent Chat
frontend/src/pages/workspace/components/TeraSprintChatWindow.tsx - IDE File Tools
frontend/src/pages/workspace/components/IDEFileExplorer.tsx
Backend Services
- Project API
backend/api/routes/projects.py - Coding API
backend/api/routes/coding.py - Live Events
backend/api/routes/websockets.py - Coding Orchestrator
backend/services/agents/coding/orchestrator.py - Execution Sandbox
backend/services/agents/coding/sandbox.py - LLM Routing
backend/services/llm_factory.py - Authentication API
backend/api/routes/auth.py - Project Files API
backend/api/routes/files.py
Persistence
- Project Domain
backend/models/project_db.py - PostgreSQL
backend/db/postgres.py - Workspace Records
backend/models/workspace_session.py - File Storage
backend/services/storage_service.py
Frontend
- Application Routes
frontend/src/App.tsx - Authentication State
frontend/src/context/AuthContext.tsx - API Client
frontend/src/services/api.ts
Other components
- Developer
- Arize Phoenix
- GitHub
Connections 30
- Developer → Application Routes: uses
README.md - Application Routes → Project Generator: routes to
frontend/src/App.tsx - Project Generator → API Client: requests
frontend/src/pages/ProjectGeneratorPage.tsx - API Client → Project API: calls API
- Project API → Project Domain: reads/writes
backend/api/routes/projects.py - Application Routes → Agile Backlog: routes to
frontend/src/App.tsx - Application Routes → Sprint Planning: routes to
frontend/src/App.tsx - Agile Backlog → API Client: requests
- Sprint Planning → API Client: requests
- Application Routes → IDE Workspace: routes to
frontend/src/App.tsx - IDE Workspace → Agent Chat: renders
frontend/src/pages/workspace/CodingWorkspacePage.tsx - IDE Workspace → IDE File Tools: renders
frontend/src/pages/workspace/CodingWorkspacePage.tsx - IDE Workspace → API Client: requests
frontend/src/pages/workspace/CodingWorkspacePage.tsx - IDE Workspace → Live Events: streams events
README.md - Coding API → Coding Orchestrator: invokes
backend/api/routes/coding.py - Live Events → Coding Orchestrator: streams agent events
backend/api/routes/websockets.py - Coding Orchestrator → Execution Sandbox: executes code
backend/services/agents/coding/orchestrator.py - Coding Orchestrator → LLM Routing: selects model
backend/services/agents/coding/orchestrator.py - Coding Orchestrator → Arize Phoenix: traces calls
README.md - Coding Orchestrator → GitHub: publishes code
README.md - Authentication State → Authentication API: logs in
frontend/src/context/AuthContext.tsx - Application Routes → Authentication State: provides state
frontend/src/App.tsx - Authentication API → PostgreSQL: queries
backend/api/routes/auth.py - Project API → PostgreSQL: uses sessions
backend/api/routes/projects.py - Live Events → Workspace Records: persists workspace
backend/api/routes/websockets.py - IDE Workspace → Workspace Records: loads workspace
- Project Files API → File Storage: uploads files
backend/api/routes/files.py - Authentication API → File Storage: uploads avatars
backend/api/routes/auth.py - File Storage → Developer: stores assets
- Project Files API → Project Domain: records attachments
backend/api/routes/files.py