Decision Layer

English

한국어

English

한국어

Appearance

Development and tests ​

To add your team's calculation, start with Register in a project. This guide covers changes to Decision Layer itself. Use Python 3.11+ and Node.js 22.

Install and run ​

bash
git clone https://github.com/haechangcho/decision-layer.git
cd decision-layer
make setup
make setup-web

Run the API and Web in separate terminals:

bash
make api
bash
make web

Open Web at http://localhost:5210 and API docs at http://localhost:8000/docs. Live queries require Cube. To try the installed sample, use decision-layer demo from Install and start.

Find the code to change ​

See Code structure for execution flow and module ownership. Change execution rules in shared Python code rather than adding separate calculations to Web, REST or MCP.

Read AGENTS.md, docs/PRODUCT_CONTEXT.md, docs/ARCHITECTURE.md and docs/DECISIONS.md before changing product behavior. Record architecture changes in the decisions log.

Tests ​

Run focused tests, then the full checks:

bash
.venv/bin/python -m pytest -q tests/unit/test_method_project.py
make test
npm --prefix web run typecheck
npm --prefix web run build:console
npm ci
npm run docs:test
npm run docs:build

tests/examples/ checks the retained notebook and complete project. tests/support/ owns shared inputs and known-answer cases. Optional statistical tests skip when their dependencies are missing; statistical CI installs the stack in tests/requirements-statistics.txt.

For screen changes, start the development server, then:

bash
cd web
npx playwright install chromium
PLAYWRIGHT_BASE_URL=http://127.0.0.1:5210 npm run test:e2e

Default browser checks mock API responses. Follow the Complete Journey example for live Cube integration. scripts/smoke_distribution.py checks an installed package, and scripts/smoke_demo.py checks the installed Docker sample. CI runs both.

Submit your change ​

Run make format-methods and include relevant test results in your PR. Include screenshots for screen changes and inputs with expected results for analysis changes. See CONTRIBUTING.md for issue reports and review expectations.