How tganeshg/teamman works
PrimeDesk is a LAN-hosted team task and project-management application. Teammates authenticate in the web UI, then work with tasks and related team, checklist, discussion, attachment, and release features; dashboard and report views summarize that work. The frontend pages call a shared API client, which communicates with FastAPI routes backed by SQLAlchemy models and SQLite. The README documents the Mantis portal integration and exports; source-index references identify many route dependencies, but unsampled implementations are represented at their route level rather than inferred in detail.
Main entry points: main.py FastAPI application · models.py Domain models · App.tsx App shell · client.ts API client
Components 31
Web application
- App shell
frontend/src/App.tsx - Session context
frontend/src/AuthContext.tsx - API client
frontend/src/api/client.ts
Task workflow
- Task workspace
frontend/src/pages/Tasks.tsx - My task board
frontend/src/pages/MyTaskBoard.tsx - Dashboard view
frontend/src/pages/Dashboard.tsx - Reports view
frontend/src/pages/Reports.tsx - Todo threads
frontend/src/pages/Todo.tsx - Task routes
backend/routers/tasks.py - Dashboard routes
backend/routers/dashboard.py - Report routes
backend/routers/reports.py - Todo routes
backend/routers/todos.py - Release routes
backend/routers/releases.py - Task relations
backend/routers/relations.py - Comments
backend/routers/comments.py - Attachments
backend/routers/attachments.py
Team operations
- Team management
frontend/src/pages/Team.tsx - Settings view
frontend/src/pages/Settings.tsx - Member routes
backend/routers/members.py - Label routes
backend/routers/labels.py
API and services
- Authentication routes
backend/routers/auth.py - Auth utilities
backend/auth_utils.py - Portal integration
backend/routers/portal.py - Mantis fetcher
backend/services/portal_fetcher.py - Credential encryption
backend/services/crypto.py - FastAPI application
backend/main.py - API schemas
backend/schemas.py
Persistence
- Domain models
backend/models.py - SQLite database
backend/database.py
Other components
- Team member
- Mantis portal
Connections 48
- Team member → App shell: uses
README.md - App shell → Session context: checks session
frontend/src/App.tsx - App shell → Task workspace: routes to
frontend/src/App.tsx - App shell → My task board: routes to
frontend/src/App.tsx - App shell → Dashboard view: routes to
frontend/src/App.tsx - App shell → Reports view: routes to
frontend/src/App.tsx - App shell → Todo threads: routes to
frontend/src/App.tsx - App shell → Team management: routes to
frontend/src/App.tsx - App shell → Settings view: routes to
frontend/src/App.tsx - Session context → API client: validates session
frontend/src/AuthContext.tsx - Task workspace → API client: requests tasks
frontend/src/pages/Tasks.tsx - My task board → API client: requests tasks
frontend/src/pages/MyTaskBoard.tsx - Dashboard view → API client: loads summary
frontend/src/pages/Dashboard.tsx - Reports view → API client: loads reports
frontend/src/pages/Reports.tsx - Todo threads → API client: manages threads
frontend/src/pages/Todo.tsx - Team management → API client: manages members
frontend/src/pages/Team.tsx - Settings view → API client: updates settings
frontend/src/pages/Settings.tsx - API client → FastAPI application: HTTP requests
frontend/src/api/client.ts - FastAPI application → Authentication routes: registers routes
backend/main.py - FastAPI application → Task routes: registers routes
backend/main.py - FastAPI application → Dashboard routes: registers routes
backend/main.py - FastAPI application → Report routes: registers routes
backend/main.py - FastAPI application → Todo routes: registers routes
backend/main.py - FastAPI application → Member routes: registers routes
backend/main.py - FastAPI application → Label routes: registers routes
backend/main.py - FastAPI application → Release routes: registers routes
backend/main.py - FastAPI application → Task relations: registers routes
backend/main.py - FastAPI application → Comments: registers routes
backend/main.py - FastAPI application → Attachments: registers routes
backend/main.py - FastAPI application → Portal integration: registers routes
backend/main.py - FastAPI application → Auth utilities: decodes token
backend/main.py - Authentication routes → Auth utilities: hashes credentials
backend/routers/auth.py - Task routes → Domain models: queries tasks
backend/routers/tasks.py - Task routes → API schemas: validates payloads
backend/routers/tasks.py - Dashboard routes → Domain models: queries metrics
backend/routers/dashboard.py - Report routes → Domain models: builds reports
backend/routers/reports.py - Todo routes → Domain models: queries threads
backend/routers/todos.py - Member routes → Domain models: manages members
backend/routers/members.py - Label routes → Domain models: manages labels
backend/routers/labels.py - Release routes → Domain models: manages releases
backend/routers/releases.py - Task relations → Domain models: links tasks
backend/routers/relations.py - Comments → Domain models: stores comments
backend/routers/comments.py - Attachments → Domain models: stores metadata
backend/routers/attachments.py - Portal integration → Credential encryption: encrypts token
backend/routers/portal.py - Portal integration → Mantis fetcher: fetches issue
backend/routers/portal.py - Mantis fetcher → Mantis portal: requests issue data
README.md - Domain models → SQLite database: maps entities
backend/models.py - Task routes → SQLite database: opens session
backend/routers/tasks.py