How alok-codes21/mini-project works
This is a stateless mathematical-learning backend with an additional terminal interface. The main workflow is a client POSTing a matrix or number-conversion question; the API dispatches it to handwritten algorithms that produce a result and instructional trace, then returns JSON. Practice checking reuses those algorithms to locate likely mistakes. Shared trace utilities shape the learning steps, while styling adds optional presentation metadata. The README documents these capabilities; some API wiring is visible only through the source index, so the graph omits unverified internal details.
Main entry points: app.js Express API · matrix.js Matrix operations · number-system.js Base conversion · cli.js CLI runner
Components 11
API runtime
- HTTP server
src/server.js - Express API
src/app.js - Runtime config
src/config.js - API description
docs/openapi.json
Learning algorithms
- Matrix operations
src/algorithms/matrix.js - Base conversion
src/algorithms/number-system.js - Practice checking
src/algorithms/practice.js - Trace utilities
src/common.js
Presentation interfaces
- CLI runner
src/cli.js - Response styling
src/style.js
Other components
- API client
Connections 17
- API client → HTTP server: sends requests
README.md - HTTP server → Runtime config: loads settings
src/server.js - HTTP server → Express API: starts
src/server.js - Express API → Runtime config: loads settings
src/app.js - Express API → Matrix operations: dispatches matrix
src/app.js - Express API → Base conversion: dispatches conversion
src/app.js - Express API → Practice checking: dispatches practice
src/app.js - Express API → Trace utilities: parses detail
src/app.js - Matrix operations → Trace utilities: builds steps
src/algorithms/matrix.js - Base conversion → Trace utilities: builds steps
src/algorithms/number-system.js - Practice checking → Matrix operations: checks matrix work
src/algorithms/practice.js - Practice checking → Base conversion: checks conversions
src/algorithms/practice.js - Express API → Response styling: adds style hints
src/app.js - Express API → API description: serves description
src/app.js - CLI runner → Matrix operations: runs operations
src/cli.js - CLI runner → Base conversion: runs conversion
src/cli.js - CLI runner → Response styling: renders output
src/cli.js