System Requirements Document

1. Introduction

This document outlines the system requirements for the "Assistente de Termodinâmica," an interactive, mobile-first educational tool designed to guide students through thermodynamics problem-solving without providing direct answers. The system emphasizes a technical, organized, and didactic experience with a data-driven, analytical aesthetic.

2. System Overview

The "Assistente de Termodinâmica" is a mini interactive system aimed at enhancing students' learning by allowing them to engage in problem-solving activities. The system is designed to provide guidance and feedback, ensuring students understand the process and methodology behind thermodynamics problems. It includes features such as progressive problem-solving stages, data traceability, and visual clarity.

3. Functional Requirements

User Stories

• As a student, I want to fill in, choose, and justify my answers to learn by doing.
• As a student, I want the system to point out inconsistencies without solving the problem for me.
• As a student, I want each piece of data to have a clear origin for traceability.
• As a student, I want a guided progression through problem-solving stages: statement, data, hypotheses, formulas, calculation, and result.
• As a student, I want to differentiate between provided, found, and calculated data visually.
• As a student, I want to view exercises in a dashboard with status indicators and a "Continue Resolution" button.
• As a student, I want to follow a step-by-step flow in the exercise page, from reading the statement to final correction.
• As a student, I want to edit a progressive table with columns for magnitude, symbol, value, unit, origin, and observation.
• As a student, I want to use chips to indicate data status: provided, found in table, calculated, or hypothesis.
• As a student, I want to manually search and filter tables by substance, pressure, temperature, phase, and property.
• As a student, I want to record hypotheses with fields for adopted hypothesis, justification, impact, and confidence.
• As a student, I want to choose formulas from a library and explain their applicability.
• As a student, I want to develop calculations step-by-step with fields for substitution, units, and partial results.
• As a student, I want to receive feedback on missing data, incoherent hypotheses, formula adequacy, unit problems, and result plausibility.

• As a student, I want a mobile UX with bottom navigation for Exercises, Tables, Formulas, History, and Profile.
• As a student, I want high contrast for data and alerts, with tactile/visual feedback for important actions.
• As a student, I want icons for table, formula, hypothesis, alert, correction, and source, with a technical and clean style.
• As a student, I want smooth transitions between stages and chips that change color when data origin is altered.
• As a student, I want performance considerations like on-demand table loading, fast searches, and local auto-save.
• As a student, I want security features like confirmation before deletion, private history, PDF export, and data deletion options.

4. User Personas

• Student: A learner engaging with thermodynamics exercises, seeking to understand and solve problems independently.
• Instructor: A teacher or tutor who may use the system to assign exercises and review student progress.

5. Core User Flows

Student Flow

1. Access the dashboard to view available exercises.
2. Select an exercise to begin or continue resolution.
3. Follow the guided progression: read the statement, input data, make hypotheses, consult tables, choose formulas, and perform calculations.
4. Receive feedback and make corrections as needed.
5. Complete the exercise and review the final correction page.

Instructor Flow

1. Assign exercises to students.
2. Monitor student progress and provide additional guidance if necessary.

6. Visuals Colors and Theme

• Technical Blue (#2563EB): Main buttons, active stage.
• Graphite Gray (#1F2937): Texts, titles, formulas.
• Found Data Green (#16A34A): Values consulted in tables.
• Hypothesis Orange (#F97316): Hypotheses and pedagogical alerts.
• Correction Red (#DC2626): Inconsistencies and errors.
• Light Background (#F8FAFC): Main area.

7. Signature Design Concept

The system should resemble an intelligent thermodynamics notebook, organizing reasoning and reproducing the teacher's methodology to help students build autonomy.

8. Interaction Model & Motion Direction

• Smooth transitions between stages.
• Chips change color when data origin is altered.
• Alerts with subtle highlights, without blocking the student.
• Progress bar showing methodological advancement.
• Discreet checklist animation for corrections.

9. Non-Functional Requirements

• High performance with on-demand loading and fast searches.
• Lightweight interface using SVGs and reusable components.
• Secure and private data handling.

10. Tech Stack

• Frontend: React.js
• Backend: Python + FastAPI
• Database: MySQL with Alembic migrations

11. Assumptions and Constraints

• The system is designed for mobile-first interaction.
• Exercises are stored in a database for easy access and management.
• The system does not automatically solve problems but guides the student through the process.

12. Glossary

• COP: Coefficient of Performance
• TBS: Dry Bulb Temperature
• TBU: Wet Bulb Temperature
• SVG: Scalable Vector Graphics
• UX: User Experience

This document serves as a comprehensive guide for the development and implementation of the "Assistente de Termodinâmica" system, ensuring all requirements are met to provide an effective educational tool for students.