Repository navigation
docs: publish architectural and mathematical audit on /docs - #62
Merged
Merged
Conversation
Document implemented modes, configuration, routing and timing equations, ITS lifecycles, signal schedules, and model limitations with source references. Remove the redundant Live demo link from the documentation header and update its assertions. Verify both quality suites and the production docs page.
Add the bilingual System logic tab at /docs#logic with mathematical notation, state diagrams, parameter references and implementation findings. Preserve the repository audit, correct overview claims and verify all frontend checks plus desktop and phone browser navigation.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The architectural and mathematical audit is now available directly on
/docs#logicas System logic / Logika systemu, in Polish and English. It includes readable mathematical notation, text state diagrams and the complete engine/ETL parameter reference, rather than requiring visitors to open a GitHub document.docs/architecture/system-logic.mdand remove the redundant Live demo header button.Verification
uv run ruff check . && uv run ruff format --check . && uv run mypy && uv run pytest— passed; 1,553 tests. Follow-up does not modify backend code.npm run lint && npm run typecheck && npm run format:check && npm test && npm run build— passed; 1,286 tests across 127 files. Existing Vite native-config compatibility warning remains./docs#logicselection, 16 formula blocks, substantive parameter content, no page overflow, keyboard navigation and browser back all passed. Live demo remains absent.Contract or safety impact
No backend runtime, schema, generated contract, dependency or signal-actuation changes. Reference parameter data is client-safe documentation, not runtime configuration. Findings describe the simulation and make no physical accuracy or operational safety claim.
Follow-ups
The in-app findings and source-linked audit identify future work on zero-speed TTI, hold bounds, rolling-floor assumptions, timing consistency and calibration. No such runtime behavior change is included.