How advaetuc/augmentr works
Augmentr is an educational linear-system solver. The user enters a matrix and solver options in the Next.js workspace, requests analysis or a solve, and inspects the returned classification, diagnostics, derivation or iteration history, visualization, and report. The backend validates API contracts and delegates numerical work to a transport-independent Python core. The README documents four methods and exact-rational direct solving; sampled service code confirms the dispatch and analysis flow. Some UI wiring and core internals were not sampled, so uncertain links are omitted.
Main entry points: services.py Analysis and solve service · workspace.tsx Solver workspace · client.ts API client · result-inspector.tsx Result inspection
Components 26
Web experience
- Solve page
app/solve/page.tsx - Solver workspace
components/solver/workspace.tsx - Method configuration
components/solver/configuration.tsx - Matrix editor
components/solver/matrix-grid.tsx - Session draft
lib/solver/storage.ts - API client
lib/api/client.ts - Method guide
app/learn/page.tsx
API boundary
- ASGI entrypoint
api/index.py - Application factory
api_app/__init__.py - Request contracts
api_models/requests.py - Analysis and solve service
api_app/services.py - Outcome contracts
api_models/responses.py
Numerical core
- System parsing
solver_core/parsing.py - Classification and rank
solver_core/classification.py - Condition diagnostics
solver_core/diagnostics.py - Gaussian elimination
solver_core/gaussian.py - Gauss-Jordan
solver_core/gauss_jordan.py - Jacobi iteration
solver_core/jacobi.py - Gauss-Seidel iteration
solver_core/gauss_seidel.py - Row operations and trace
solver_core/_elimination.py
Result views
- Result inspection
components/solver/result-inspector.tsx - Analysis panel
components/solver/analysis-panel.tsx - Geometry visualization
lib/geometry/derive.ts - Report generation
lib/reports/render.ts - Report preview
components/solver/report-preview.tsx
Other components
- Solver user
Connections 26
- Solver user → Solve page: opens solver
- Solve page → Solver workspace: renders workspace
- Solver workspace → Matrix editor: edits system
- Solver workspace → Method configuration: sets options
- Solver workspace → Session draft: restores and saves
- Solver workspace → API client: requests analysis or solve
- API client → ASGI entrypoint: POSTs API request
- ASGI entrypoint → Application factory: creates app
- Application factory → Analysis and solve service: dispatches requests
- Analysis and solve service → Request contracts: accepts validated payload
- Analysis and solve service → System parsing: parses system
- Analysis and solve service → Classification and rank: classifies system
- Analysis and solve service → Condition diagnostics: computes diagnostics
- Analysis and solve service → Gaussian elimination: dispatches Gaussian solve
- Analysis and solve service → Gauss-Jordan: dispatches Gauss-Jordan solve
- Analysis and solve service → Jacobi iteration: dispatches Jacobi solve
- Analysis and solve service → Gauss-Seidel iteration: dispatches Seidel solve
- Gaussian elimination → Row operations and trace: uses row reduction
- Gauss-Jordan → Row operations and trace: uses row reduction
- Analysis and solve service → Outcome contracts: returns typed outcomes
- API client → Analysis panel: supplies analysis outcome
- API client → Result inspection: supplies solve outcome
- Result inspection → Geometry visualization: derives plot data
- Result inspection → Report generation: provides report input
- Report generation → Report preview: renders report blocks
- Solver user → Method guide: opens method guide