Node-py-backend

This project is a simple example of having a nodejs typescript backend service which uses a python worker service for any number crunching using numpy and pandas.
The project structure and intent will be described in project_notes.md, and most of the project will be generated by Github Copilot.

What was tried

Generating the project with the following prompt

@workspace based on project_notes.md create project as described. install node and python dependencies. add requirements.txt for python

• model GPT-5.1-Codex-mini, did not work
• model GPT-5.1-codex works.
  • projected created from project_notes
  • interactive process to get it to a state / format i want
  • project_notes updated by copilot after each step

Project Summary

• Backend: TypeScript/Express service in backend/src, exposes /health plus /numbers/* routes and supervises the Python helper.
• Helper: FastAPI worker in numberhelper/src/number_helper_service.py handling /health + /aggregate with NumPy/pandas aggregations.
• Process Lifecycle: Backend boots the helper, waits for readiness via NumberHelperClient, and forwards SIGINT/SIGTERM for graceful shutdown.
• Tooling: Repo-level Makefile (see make help) streamlines install/run/clean, requiring an existing .venv for Python deps while ensuring PYTHON_CMD points to it.