How derek-05/alento works
Alento is an academic work-planning application: users manage classes and assignments, attach course materials, and turn those sources into grounded plans and actionable steps. The graph shows the frontend-to-API entry point, source ingestion and retrieval, planning, and related class, integration, focus, and PDF capabilities. Source excerpts confirm several internal behaviors, but route-to-service wiring and some unsampled subsystem details are not shown, so those links are intentionally omitted.
Main entry points: pipeline.py Source processing · main.py FastAPI app · retrieval_service.py Evidence retrieval · planner_pipeline.py Plan generation
Components 23
Web application
- Next.js app
frontend/src/app/layout.tsx - Workspaces
frontend/src/features/work-items/work-items-workspace.tsx - PDF suite
frontend/src/features/pdf-suite/pdf-suite-workspace.tsx - API proxy
frontend/src/app/api/proxy/[...path]/route.ts
API and access
- FastAPI app
backend/app/main.py - API router
backend/app/routes/router.py - Authentication
backend/app/core/security/auth.py
Work and planning
- Work management
backend/app/features/work/service.py - Work persistence
backend/app/features/work/persistence/sql_store.py - Plan generation
backend/app/features/cyber/planner/planner_pipeline.py - AI chat
backend/app/features/cyber/chat/chat_service.py - Focus tools
backend/app/features/focus/service.py
Sources and evidence
- Source processing
backend/app/features/sources/pipeline.py - Source review
backend/app/features/cyber/source_review/source_review_service.py - Evidence retrieval
backend/app/features/sources/retrieval_service.py - Object storage
backend/app/connections/storage/object_storage.py - PostgreSQL
backend/app/core/db.py - PDF editing
frontend/src/features/pdf-suite/pdf-engine.ts
Academic integrations
- Class materials
backend/app/features/classes/service.py - Moodle integration
backend/app/features/moodle/service.py - OneDrive integration
backend/app/features/onedrive/service.py
Other components
- Student
- AI provider
Connections 21
- Student → Next.js app: uses
- Next.js app → Workspaces: presents
- Workspaces → API proxy: requests
- PDF suite → PDF editing: creates splits
- API proxy → FastAPI app: forwards requests
- FastAPI app → API router: mounts
- FastAPI app → Authentication: enforces access
- Source processing → Object storage: stores files
- Source processing → PostgreSQL: records jobs
- Source processing → AI provider: analyzes sources
- Plan generation → Evidence retrieval: gets evidence
- Plan generation → AI provider: generates plans
- Source review → AI provider: reviews sources
- Evidence retrieval → PostgreSQL: searches indexes
- Evidence retrieval → Object storage: signs evidence links
- Work management → Work persistence: persists work
- Student → Class materials: manages classes
- Student → Moodle integration: imports materials
- Student → OneDrive integration: syncs files
- Student → Focus tools: uses focus tools
- Student → AI chat: asks questions