How tktarun03/beyond-obvious-ai-student-lab works
This is a learning lab with a working catalogue portal and shared production-minded AI engineering packages; the five project workspaces are documented product concepts but are still scaffolded. The visible user workflow is choosing a project from the portal, which links to its workspace; the documented project goals describe the intended domain stages. Shared packages provide validation, authentication, AI, persistence, observability, and evaluation. Project internals and several package wiring details were not sampled, so those connections are omitted or identified as documented rather than inferred.
Main entry points: gemini.ts Gemini provider · route.ts Authenticated routes · ServerStatusPanel.tsx Server status · 01-knowledge-copilot Knowledge copilot
Components 26
Catalogue portal
- Catalogue page
apps/portal/src/app/page.tsx - Project catalogue
apps/portal/src/lib/catalogue.ts - Project cards
apps/portal/src/components/ProjectCard.tsx - Server status
apps/portal/src/components/ServerStatusPanel.tsx
Learning projects
- Knowledge copilot
projects/01-knowledge-copilot - Document intelligence
projects/02-document-intelligence - Voice assistant
projects/03-india-voice-assistant - Engineering agent
projects/04-engineering-agent - Decision assistant
projects/05-data-decision-assistant
Application boundaries
- Input validation
packages/validation/src/upload.ts - Authenticated routes
packages/auth/src/route.ts - Auth selection
packages/auth/src/factory.ts - Development auth
packages/auth/src/dev-provider.ts - Firebase auth
packages/auth/src/firebase-provider.ts - Rate limiting
packages/auth/src/rate-limit.ts - Database adapters
packages/database/src
AI and evaluation
- Gemini provider
packages/ai/src/providers/gemini.ts - Mock embeddings
packages/ai/src/embedding.ts - Retry policy
packages/ai/src/retry.ts - Tool selection
packages/ai/src/tool-selection.ts - Evaluation framework
packages/ai/src/eval - Evaluation scorers
packages/ai/src/eval/scorers.ts
Shared foundation
- Observability
packages/observability/src - Shared UI primitives
packages/ui/src/components - Shared utilities
packages/shared/src
Other components
- Learner
Connections 46
- Learner → Catalogue page: opens
README.md - Catalogue page → Project catalogue: reads
apps/portal/src/app/page.tsx - Catalogue page → Project cards: renders
apps/portal/src/app/page.tsx - Catalogue page → Server status: renders
apps/portal/src/app/page.tsx - Project cards → Project catalogue: uses data
apps/portal/src/components/ProjectCard.tsx - Server status → Knowledge copilot: checks status
apps/portal/src/components/ServerStatusPanel.tsx - Server status → Document intelligence: checks status
apps/portal/src/components/ServerStatusPanel.tsx - Server status → Voice assistant: checks status
apps/portal/src/components/ServerStatusPanel.tsx - Server status → Engineering agent: checks status
apps/portal/src/components/ServerStatusPanel.tsx - Server status → Decision assistant: checks status
apps/portal/src/components/ServerStatusPanel.tsx - Catalogue page → Shared UI primitives: uses components
apps/portal/src/app/page.tsx - Project cards → Shared UI primitives: uses components
apps/portal/src/components/ProjectCard.tsx - Knowledge copilot → Input validation: validates input
README.md - Knowledge copilot → Authenticated routes: authenticates
README.md - Knowledge copilot → Gemini provider: requests AI
README.md - Knowledge copilot → Database adapters: persists data
README.md - Document intelligence → Input validation: validates input
README.md - Document intelligence → Authenticated routes: authenticates
README.md - Document intelligence → Gemini provider: requests AI
README.md - Document intelligence → Database adapters: persists data
README.md - Voice assistant → Input validation: validates input
README.md - Voice assistant → Authenticated routes: authenticates
README.md - Voice assistant → Gemini provider: requests AI
README.md - Voice assistant → Database adapters: persists data
README.md - Engineering agent → Input validation: validates input
README.md - Engineering agent → Authenticated routes: authenticates
README.md - Engineering agent → Gemini provider: requests AI
README.md - Engineering agent → Database adapters: persists data
README.md - Decision assistant → Input validation: validates input
README.md - Decision assistant → Authenticated routes: authenticates
README.md - Decision assistant → Gemini provider: requests AI
README.md - Decision assistant → Database adapters: persists data
README.md - Authenticated routes → Auth selection: gets provider
packages/auth/src/route.ts - Authenticated routes → Rate limiting: enforces limit
packages/auth/src/route.ts - Auth selection → Development auth: selects provider
packages/auth/src/factory.ts - Auth selection → Firebase auth: selects provider
packages/auth/src/factory.ts - Gemini provider → Retry policy: retries calls
packages/ai/src/providers/gemini.ts - Gemini provider → Tool selection: validates tools
packages/ai/src/providers/gemini.ts - Evaluation framework → Evaluation scorers: scores runs
packages/ai/src/eval/scorers.ts - Evaluation scorers → Mock embeddings: uses similarity
packages/ai/src/eval/scorers.ts - Gemini provider → Observability: logs calls
packages/ai/src/providers/gemini.ts - Knowledge copilot → Evaluation framework: evaluated by
projects/01-knowledge-copilot/evals/run.ts - Document intelligence → Evaluation framework: evaluated by
projects/02-document-intelligence/evals/run.ts - Voice assistant → Evaluation framework: evaluated by
projects/03-india-voice-assistant/evals/run.ts - Engineering agent → Evaluation framework: evaluated by
projects/04-engineering-agent/evals/run.ts - Decision assistant → Evaluation framework: evaluated by
projects/05-data-decision-assistant/evals/run.ts