Repository navigation
Development plan: client–server system, integrations, test benches - #3
Merged
Merged
Conversation
Утилита переходит от одного рабочего места к системе учёта: вход по ролям, зашифрованный журнал выработки, сессии, режим мастера, выгрузка в CSV, хранилище на сетевом диске. docs/ARCHITECTURE.md фиксирует решения и их причины: - журнал неизменяемых файлов вместо SQLite на сетевом диске; - AES-GCM средствами Windows (CNG) — без зависимостей, работает на Win7; - ключ данных и слоты пользователей: вход = расшифровка своего слота; - PIN оператора плюс секрет рабочего места против перебора; - сессия как именованная закладка, журнал — единственный источник правды; - весь ввод-вывод в фоновом потоке, автоподгрузка опросом. docs/ROADMAP.md: этапы 0–5 системы учёта перед прежними A–F. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CW3WfPRekjK4x6M8VNRckz
The planned tracking system moves from a shared network folder to a server with a database, with the utility as the operator's client and a web page for the supervisor. Nothing is implemented yet: this commit only records the plan. - docs/ARCHITECTURE.md: client-server design and the reasons for it (why not a shared folder, FastAPI + SQLite, SSE for live updates, TLS with a pinned self-signed certificate, PIN sign-in only from registered workstations, offline outbox, versioned API). - docs/ROADMAP.md: stages 0-6 of the tracking system, then machine-data stages A-F. - docs/TASKS.md: task breakdown with scope, acceptance criteria, dependencies and size; maintenance tasks from the audit; open questions. - docs/FINDINGS.md: audit results (fixed and open) and planning findings. - README: short roadmap in English and Russian. The repository is English-first from now on: English documents are the primary ones, Russian versions move to *.ru.md as translations. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CW3WfPRekjK4x6M8VNRckz
malinkin-s
changed the title
- docs/INTEGRATIONS.md: where the system sits in ISA-95, the mapping problem, integration patterns, and the integration hub: connector plugins configured in the admin panel, encrypted secrets, routing, mapping tables, an integration outbox with retries and a delivery log, and an Integration API for ERPs that read from us. Research notes on Infor SyteLine (IDO REST, ION), 1C (OData, or 1C reading our event feed) and Active Directory (LDAPS, group-to-role mapping), with sources. - docs/TEST_BENCH.md: bench nodes and what runs on each, topology, bench configurations and test scenarios. - docs/ARCHITECTURE.md: target-system diagram and an end-to-end sequence diagram (Mermaid); integrations section; settings and hub tables. - docs/TASKS.md: administrator settings (shifts, time format, retention, visibility), stage 7 (directory), stage 8 (integration hub), research and test-bench tasks; open questions resolved from the owner's answers. - docs/ROADMAP.md, FINDINGS.md, READMEs: stages 7-8, open-source scope, new planning findings. Russian versions updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CW3WfPRekjK4x6M8VNRckz
malinkin-s
changed the title
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
2 participants
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.
Documentation only — no code changes. Records the plan for turning the utility into an open-source production tracking system; nothing in it is implemented yet.
Direction
A server with a database, the utility as the operator's client, a web page for the shift supervisor, Active Directory sign-in, and an integration hub for ERPs. The earlier draft in this PR (encrypted log on a shared network folder) is replaced: nearly all of its complexity came from having no central node. It stays documented as a fallback.
The project is open source and not tied to a particular shop: shifts, time format, operators, retention, visibility, directory and ERP connections are configured by the administrator. Standalone mode stays — without a server the utility works as it does today, and program files remain read-only.
Documents
docs/ARCHITECTURE.mddocs/INTEGRATIONS.mddocs/TEST_BENCH.mddocs/ROADMAP.mddocs/TASKS.mddocs/FINDINGS.mdREADME.md,README.ru.mdAll Mermaid diagrams were rendered with mermaid-cli to check the syntax.
Stages
Gate
Task S0-01: a probe on a real Windows 7 32-bit PC (TLS with certificate pinning, SSE, DPAPI in a PyInstaller build). If it fails, the client architecture is revisited before the server work starts.
Language
The repository is English-first from now on. English documents are primary; Russian versions of the README, roadmap and architecture are in
*.ru.mdas translations that may lag behind.🤖 Generated with Claude Code
https://claude.ai/code/session_01CW3WfPRekjK4x6M8VNRckz