How alberthamoui/candidate_allocation works
Candidate Allocation is a web application for turning a three-sheet Excel workbook into interview-table assignments. Users upload and map candidate, evaluator, and restriction data, review candidates, set capacity and optional course/semester criteria, then run allocation and inspect or export the result. The documented optimizer combines simulated annealing with exact evaluator assignment and an optimality bound. Backend request wiring and several frontend API calls were not excerpted, so those relationships are shown only where README or excerpts support them.
Main entry points: Parametros.tsx Allocation parameters · handlers.go API handlers · alocate.go Assignment search · Resultado.tsx Result screen
Components 26
Workbook intake
- HTTP server
main.go - API handlers
handlers.go - Workbook processing
processa.go - Column mapping
mapping.go - Mapping suggestions
sugestao_mapping.go
Allocation setup
- Capacity preview
capacidade.go - Session data
db/auxfunctions.go
Allocation engine
- Additional criteria
criterios.go - Assignment search
alocate.go - Allocation data model
models.go
Results and export
- Search and quality view
frontend/src/components/PainelResultado.tsx - Result and quality
resultado.go - Excel export
export.go
Web interface
- Upload settings
frontend/src/pages/Home.tsx - Upload API
frontend/src/api.ts - Candidate review
frontend/src/pages/VerifyUsers.tsx - Editable user cards
frontend/src/components/UserCard.tsx - Editable fields
frontend/src/components/EditableCell.tsx - Evaluator mapping
frontend/src/pages/UploadAvaliador.tsx - Restriction mapping
frontend/src/pages/UploadRestricao.tsx - Allocation parameters
frontend/src/pages/Parametros.tsx - Criteria editor
frontend/src/components/EditorCriterios.tsx - Result screen
frontend/src/pages/Resultado.tsx - Result API client
frontend/src/api.ts
Other components
- Operator
- Workbook
Connections 25
- Operator → Upload settings: uploads workbook
README.md - Upload settings → Upload API: submits file
frontend/src/pages/Home.tsx - Upload API → API handlers: requests upload
- API handlers → Workbook processing: processes workbook
- Workbook processing → Column mapping: builds mappings
- Column mapping → Mapping suggestions: suggests columns
- Operator → Candidate review: reviews candidates
README.md - Candidate review → Editable user cards: renders cards
frontend/src/pages/VerifyUsers.tsx - Editable user cards → Editable fields: renders fields
frontend/src/components/UserCard.tsx - Operator → Evaluator mapping: maps evaluators
README.md - Operator → Restriction mapping: maps restrictions
README.md - Operator → Allocation parameters: sets parameters
README.md - Allocation parameters → Criteria editor: edits criteria
frontend/src/pages/Parametros.tsx - Allocation parameters → Capacity preview: requests preview
- Allocation parameters → Assignment search: starts allocation
README.md - Assignment search → Additional criteria: scores criteria
README.md - Assignment search → Allocation data model: uses allocation data
- API handlers → Session data: persists session data
- Operator → Result screen: views assignments
README.md - Result screen → Result API client: loads result
frontend/src/pages/Resultado.tsx - Result screen → Search and quality view: renders results
frontend/src/pages/Resultado.tsx - Result and quality → Excel export: provides export data
- Operator → Excel export: exports workbook
README.md - Excel export → Workbook: writes workbook
README.md - Operator → Search and quality view: searches and filters
README.md