# Repo Map

This page is the quick map of repository areas and the most important code
anchors inside each one.

## Top-Level Areas

- `frontend/`: user-facing Next.js site
- `backend/`: Django API, Celery jobs, and admin UI
- `ssh-proxy/`: Go WebSocket-to-SSH bridge
- `deployment/`: Ansible playbooks and production runtime templates
- `misc/`: diagrams, templates, and supporting assets

## Frontend

- App Router and route handlers:
  `frontend/src/app/**`
- Reusable components:
  `frontend/src/components/**`
- Labs data layer:
  `frontend/src/components/labs/hook.ts`
- Web console controller:
  `frontend/src/components/web-console/controller.ts`
- API proxy route:
  `frontend/src/app/api/[[...fallback_placeholder]]/route.ts`

## Backend

- API endpoints:
  `backend/labs/api/endpoints/*`
- API routing:
  `backend/labs/api/urls.py`
- Lab v2 core:
  `backend/labs/lab_manager_v2/*`
- Task runner:
  `backend/labs/tasks/lab_v2.py`
- Models:
  `backend/labs/models/*`
- Admin frontend:
  `backend/labs/admin/frontend/**`

## SSH Proxy

- Entrypoint:
  `ssh-proxy/cmd/web-console-ssh/main.go`
- Control plane:
  `ssh-proxy/internal/controlplane/client.go`
- Subtree onboarding:
  `ssh-proxy/AGENTS.md`

## Deployment

- Main labs-service playbook:
  `deployment/playbooks/labs_service.yml`
- Labs-service role tasks:
  `deployment/roles/labs_service/tasks/**`
- Runtime templates:
  `deployment/roles/labs_service/files/docker-compose.yml`,
  `deployment/roles/labs_service/files/nginx-default.conf`

## Related Reading

- [`../../ARCHITECTURE.md`](../../ARCHITECTURE.md)
- [`../FRONTEND.md`](../FRONTEND.md)
- [`../RELIABILITY.md`](../RELIABILITY.md)
- [`../SECURITY.md`](../SECURITY.md)