No description
Find a file
Ochenstarik efd5bd5c60
Some checks are pending
ci / verify (push) Waiting to run
feat: add SLK20R attendance terminal
2026-09-17 20:51:20 +07:00
.forgejo/workflows ci: add portable deployment and verification pipeline 2026-09-10 23:29:29 +07:00
api docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
apps/KronaStaffTerminal feat: add SLK20R attendance terminal 2026-09-17 20:51:20 +07:00
docs docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
migrations feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
schemas docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
scripts feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
src feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
tests feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
.dockerignore ci: add portable deployment and verification pipeline 2026-09-10 23:29:29 +07:00
.editorconfig feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
.env.example ci: add portable deployment and verification pipeline 2026-09-10 23:29:29 +07:00
.gitattributes feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
.gitignore feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
.prettierrc.json feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
AGENTS.md docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
compose.yaml ci: add portable deployment and verification pipeline 2026-09-10 23:29:29 +07:00
Dockerfile ci: add portable deployment and verification pipeline 2026-09-10 23:29:29 +07:00
eslint.config.js feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
LICENSE docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
module.json docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
package-lock.json feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
package.json feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
README.md feat: add SLK20R attendance terminal 2026-09-17 20:51:20 +07:00
SECURITY.md docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
settings.schema.json docs: define platform boundaries and contracts 2026-09-10 23:29:28 +07:00
tsconfig.build.json feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00
tsconfig.json feat: establish tenant-safe Staff service foundation 2026-09-10 23:29:26 +07:00

Krona Staff

Архитектурная основа блока сотрудников для Krona Business Platform. Это не готовая HRM: предметные правила табеля, графиков, отпусков, расчёта зарплаты, кадровых документов и отчётности намеренно не реализованы до требований владельца.

Сейчас репозиторий содержит совместимое техническое ядро: два runtime-режима, порты платформы, PostgreSQL/RLS, инфраструктуру outbox/inbox/idempotency/audit, проверяемые OpenAPI и module manifest, health endpoints, контейнеризацию и CI.

Быстрый старт

cp .env.example .env
docker compose --profile tools run --rm migrate
docker compose up --build app postgres redis

Открыть: shell http://localhost:8080/, OpenAPI JSON /openapi.json, проверки /live, /ready, /version.

Без Docker: Node.js 22+, PostgreSQL 17 и Redis 7; затем npm ci, npm run db:migrate, npm run dev.

Команды

  • npm run check — lint, typecheck, tests, миграции, контракты и build.
  • npm run db:migrate / npm run db:migrate:down — применить/откатить миграции.
  • npm run check:contracts — проверить manifest/settings/OpenAPI.

Архитектурные решения: docs/ARCHITECTURE.md, интеграция: docs/PLATFORM-INTEGRATION.md, будущий объём: docs/ROADMAP.md.

Биометрический терминал

Windows-приложение для SLK20R находится в apps/KronaStaffTerminal. Оно добавляет сотрудников, регистрирует отпечаток по трём сканам, отмечает первый приход за день и отправляет уведомление в Telegram и/или MAX. Инструкция по запуску и настройке находится в README терминала.