How techteam-zephvion/install-unotusk works
Unotusk is a project-intelligence product: users establish tenant-scoped organizations and projects, connect repositories, then the backend ingests code and supports discovery, reports, and grounded project investigation. The graph focuses on the implemented API and worker runtime. The README documents web workflows and Redis task plumbing, but the web source is absent from the supplied tree; related links are cited to the README. Some engine internals were only partially excerpted, so uncertain internal calls are omitted.
Main entry points: main.py FastAPI application · session.py PostgreSQL data · ingestion_service.py Repository ingestion · worker.py Background worker
Components 18
Identity and Projects
- Authentication
apps/api/src/services/auth_service.py - Organization workflows
apps/api/src/api/routes/organizations.py - Project workflows
apps/api/src/api/routes/projects.py
Repository Indexing
- Repository endpoints
apps/api/src/api/routes/repository.py - Repository management
apps/api/src/services/repository_service.py - Repository ingestion
apps/api/src/services/ingestion_service.py - Code parsers
apps/api/src/services/parser - GitHub integration
apps/api/src/services/github_client.py
Code Intelligence
- Discovery analysis
apps/api/src/services/discovery_engine/engine.py - Intelligence reports
apps/api/src/services/report_engine/engine.py - Project investigation
apps/api/src/services/context_engine/engine.py - Project knowledge
apps/api/src/services/knowledge_service.py - LLM providers
apps/api/src/services/llm/factory.py
API and Jobs
- FastAPI application
apps/api/src/main.py - PostgreSQL data
apps/api/src/db/session.py - Background worker
services/workers/worker.py - Redis task queue
Other components
- Project user
Connections 20
- Project user → FastAPI application: uses
README.md - FastAPI application → Authentication: routes auth
apps/api/src/main.py - FastAPI application → Organization workflows: routes requests
apps/api/src/main.py - FastAPI application → Project workflows: routes requests
apps/api/src/main.py - FastAPI application → Repository endpoints: routes requests
apps/api/src/main.py - Repository endpoints → Repository management: calls
apps/api/src/api/routes/repository.py - Repository management → PostgreSQL data: persists records
- FastAPI application → Redis task queue: dispatches jobs
README.md - Redis task queue → Background worker: delivers tasks
README.md - Background worker → Repository ingestion: runs ingestion
services/workers/worker.py - Background worker → Discovery analysis: runs analysis
services/workers/worker.py - Background worker → Intelligence reports: runs generation
services/workers/worker.py - Repository ingestion → GitHub integration: retrieves source
apps/api/src/services/ingestion_service.py - Repository ingestion → Code parsers: parses code
apps/api/src/services/ingestion_service.py - Repository ingestion → PostgreSQL data: stores index
apps/api/src/services/ingestion_service.py - Discovery analysis → PostgreSQL data: reads and writes
apps/api/src/services/discovery_engine/engine.py - Intelligence reports → PostgreSQL data: reads and writes
apps/api/src/services/report_engine/engine.py - Project investigation → LLM providers: requests synthesis
apps/api/src/services/context_engine/engine.py - Project investigation → PostgreSQL data: retrieves context
apps/api/src/services/context_engine/engine.py - Project investigation → Project knowledge: retrieves knowledge