How alicyribeiro/engcomp-ufc-planner works
Fluxo Engenharia UFC is a client-side academic planner for Computer Engineering students. Students record or import course progress, then use the curriculum workspace to inspect eligibility and metrics, explore prerequisite relationships in the interactive flowchart, and plan future semesters; they can also export a personalized academic report. The graph includes the documented import and planning capabilities, but excerpts do not show all of their implementation or App-level wiring, so uncertain connections are omitted. Academic progress is persisted in browser local storage.
Main entry points: Workspace.tsx Curriculum Workspace · curriculumService.ts Curriculum Service · App.tsx App Shell · AcademicReportModal.tsx Report Export
Components 19
Application
- App Shell
src/App.tsx
Academic Data
- Academic State Hook
src/hooks/useAcademicState.ts - Browser Storage
- Curriculum Service
src/services/curriculumService.ts - Curriculum Dataset
src/data/disciplinas.json - Academic Types
src/types/index.ts - Transcript Import
src/components/ImportTranscriptModal.tsx
Planning Views
- Curriculum Workspace
src/pages/Workspace.tsx - Prerequisite Flowchart
src/pages/Fluxograma.tsx - Subject Search
src/components/SubjectSearch.tsx - Subject Cards
src/components/SubjectCard.tsx - Available Subjects
src/components/AvailableSubjectCard.tsx - Subject Details
src/components/SidebarDetail.tsx - Metric Cards
src/components/StatCard.tsx
Reporting
- Report Export
src/components/AcademicReportModal.tsx - PDF or PNG
- Browser Printing
Other components
- Student
- SIGAA History
Connections 19
- Student → App Shell: uses
- App Shell → Curriculum Workspace: shows
- App Shell → Prerequisite Flowchart: shows
- Curriculum Workspace → Subject Search: renders
- Curriculum Workspace → Metric Cards: renders
- Curriculum Workspace → Subject Cards: renders
- Curriculum Workspace → Available Subjects: renders
- Curriculum Workspace → Subject Details: shows details
- Curriculum Workspace → Curriculum Service: uses eligibility
- Prerequisite Flowchart → Curriculum Service: gets status
- Subject Search → Curriculum Service: checks status
- Curriculum Service → Curriculum Dataset: reads
- Academic State Hook → Browser Storage: reads and writes
- Academic State Hook → Curriculum Service: calculates stats
- Student → Transcript Import: provides history
- SIGAA History → Transcript Import: supplies transcript
- Student → Report Export: requests report
- Report Export → PDF or PNG: exports
- Report Export → Browser Printing: prints