HaUI-ImplSolution/DX-OS has 30 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:59 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Lõi dynamic nguồn mở cho các hệ thống hồ sơ có quy trình: khai báo nghiệp vụ trong một tệp mô hình, DX-OS dựng cơ sở dữ liệu, vai trò, API có phân quyền, quy trình duyệt và giao diện.
ProductivityREADME_EN.md
OriginalDX-OS
Tiếng Việt · English
An open-source dynamic core for record-and-workflow systems. Declare a business in one model file; DX-OS builds the database, the accounts and roles, a permissioned API, the approval workflow and the screens. Changing the business means changing the file, not the code.
Entry of the OLP Open Source Software 2026 contest, DX-OS track (VFOSSA), by team HaUI-ImplSolution, School of Information and Communication Technology, Hanoi University of Industry.
Quick links: Overview · Features · How it works · Against the brief · Try it · Documentation · Structure · Contributing · License
Overview
Every school, department and small business has the same kind of process: one person sends a request, another reviews it, approves or returns it, and every step must leave a trace. Each new business need usually means building login, permissions, file storage and the approval flow from scratch.
DX-OS builds that shared part once, as a headless core that is not tied to any business. The person deploying it describes their business in a model file: what a record holds, who may see and edit it, who approves it, and how long handling may take. The core reads the file and builds a working system.
The whole system is assembled from open-source software under OSI-approved licenses, installs on your own machine, and the data stays there.
The current version is 2.0.0, and the changes of each version are in CHANGELOG.md.
Features
- From one file to a running system. Records, tables, accounts, roles, list screens and forms are all built from the model file. A file written in an older style still runs, and a command moves it to the new style after you preview what will change.
- Permissions down to the row. Each role sees and edits only its own work, the work of its unit, or the work assigned to it.
- Data rules in the file. True or false, dates, several values at once, limits on values, text patterns and conditional requirements are all declared in the file, and the database refuses a wrong value as well.
- Customizable workflows. Start from one of three ready made shapes (approval, work items, time-slot reservations with a capacity check) and add or remove steps, give each step to its own role, or declare a workflow from scratch; a step can open only when the record meets a condition, for example an amount above a limit goes to a higher approval level; rejecting and returning need a reason, and nobody approves their own record.
- Changing the business once data exists. The system previews the impact, warns about risk, keeps the values when something is renamed, and can return to the previous version.
- A trace that cannot be edited. The history of records is one chain with checks; if anyone edits, deletes or inserts a line, one command names that line.
- Connections to the outside. Every change to a record is reported to a web address or a chat channel (Mattermost, Slack), signed so the receiver can check it and sent again when the receiver fails.
- Open to outside applications. Each model has its own API document that follows the model; an outside service gets one model role and its own secret, while a browser interface on another domain signs users in with OIDC Authorization Code and PKCE.
- A control panel for the person deploying. Template library, model editor (write the file or fill a form, with guidance on what can be written and extended) with a process diagram drawn from the file being written, plan preview, apply, history, user management and record statistics.
- An interface set by declaration. The model file can choose icons, menu groups, the default columns and sort, how forms are grouped and the hints; an officer selects several records and handles them at once, each still going through every rule.
- Board by state and list export. The list of records with a process can be seen as a board with one column per state, and exported to a CSV file a spreadsheet can read, with exactly the rows the viewer may see.
- A data catalog. One page shows where the data of each model lives, who may see it, how the kinds of records relate, where the data comes in from and where it goes out, and how complete and recent the data is.
- Archive of old records. Records closed long ago are written to an archive store on a daily schedule, the data in use stays as it is, and the copy can be checked and queried directly with DuckDB.
- An inbox that updates itself. When a record changes, the inbox, the lists and the detail page that are open refresh without reloading the page.
- Try it at once. One command creates a trial account for each role and sample records in several states, so a visitor who signs in finds a system with work in it.
- Simple to install and run. One command installs and one starts; backups can be checked, services restart on their own, and attachments are virus-scanned when enabled.
- Single sign-on. Through Keycloak, and administrators can be required to enter a one-time code as well.
Each feature and the test that proves it are matched in the evidence matrix (Vietnamese).
How it works
- Declare. Write or pick a model file: the entities, fields, roles, permissions and workflows of the business.
- Apply. Preview the plan, then apply it; the core builds the database, the roles in Keycloak, the API and the workflows, and records each step.
- Use. People sign in and work in a web interface built from the same file; every change leaves history and is reported outside.
The system has three tiers:
| Tier | Role |
|---|---|
| Core | A headless service: reads models, applies them, the common API, workflows, history, events |
| Apps | A web interface and a control panel built from the data of the core, plus a links page (portal) and a monitoring screen |
| Models | The files that describe a business; adding a business is adding a file |
The diagrams and the path of one request through the system are in ARCHITECTURE.md (Vietnamese); how to write a model file is in docs/MODEL.md (Vietnamese).
Ten templates are ready to pick in the control panel: student one-stop service, technical support, equipment incident, room booking, IT service access, equipment loan, notes, an asset register, clinic appointments and retail returns.
Against the brief
The OLP 2026 brief splits a system into tiers and names four spaces to reach: H (a shared digital environment), P (guard rails and automatic flows), D (one source of truth) and I (artificial intelligence). DX-OS is, in Tier 1, a headless core, in Tier 2 a web interface and a control panel built on the core, and the student one-stop service and the other businesses are model files, which are the applications of Tier 3.
| Space | What DX-OS does | State |
|---|---|---|
| H, shared digital environment | One sign-in; roles and units declared in the model; each person sees only their own work in the inbox, the board by state and the calendar | Done |
| P, guard rails and automatic flows | A state changes only through the workflow; rejecting and returning need a reason; the creator cannot approve their own record; due and overdue dates and escalation to other roles; work after an approval runs through a queue and is retried | Done |
| D, one source of truth | Data, history and queue live in one database; the history is chained so tampering shows; every change is reported outside by a signed webhook; statistics and a data catalog | Done |
| I, artificial intelligence | None yet; only fully open models by the OSI definition will be used, and none that qualifies has been chosen | Not done |
The interfaces that come with the system are counted as follows. The interfaces of DX-OS are the web interface, the control panel, the links page (portal) and the monitoring screen, all in Tier 2; the core run alone has no interface. The Keycloak Admin Console is the interface of an open source service that ships with it, not of DX-OS, and it is not opened to the gateway by default. This is the reading of the team and has not been confirmed by the organizers.
The detailed check of each point of the brief is in DANH_GIA.md and the remaining work in BACKLOG.md, both in Vietnamese.
Supabase, Strapi and Directus are foundations that build a backend from tables or content. DX-OS focuses on records with a workflow: one model file declares the roles, the row-level permissions, the approval workflow, the due dates and the tamper-evident history together. Why each one was read for ideas or not used as a base is on the components page (Vietnamese).
Try it
Try it online
Version 2.0.0 runs publicly at https://khuongdev.io.vn/ with the One-stop student model and 40 sample requests.
Sign in with one of the four trial accounts below, all with the password 15c9777835f0dfcf4e8d.
| Account | Role |
|---|---|
judge_student |
Student, files requests |
judge_officer |
Officer of the unit DAO_TAO |
judge_officer2 |
Officer of the unit CTSV |
judge_supervisor |
Supervisor, reads every request |
The control panel /console and the monitoring page are for administrators, so these accounts cannot open them.
Send feedback or report a problem by opening an issue.
Install
You need a Linux machine with Docker and Compose v2; no source code.
curl -fsSL https://github.com/HaUI-ImplSolution/DX-OS/releases/latest/download/dxos-install.sh | bash
dxos start
The installer downloads the latest release, checks its SHA-256 and installs it into ~/.dxos; the dxos command goes to ~/.local/bin.
dxos start downloads the images the first time, waits until every service is ready, creates the account admin with a temporary password printed on screen, and prints the addresses.
Sign in at http://localhost:9080/console as admin, change the password, pick a template on the Template library tab, preview the plan and apply it.
If you already have a model file, dxos start <file> takes it in at once; list every file after dxos start when there are several.
If you only need the API platform for outside applications, run dxos start --core: no web application, portal or monitoring, see Core-only mode (Vietnamese).
The other commands and the operation guide are in deploy/OPERATIONS.md (Vietnamese).
From source
You also need JDK 21 and Node 22 to build and test outside Docker.
deploy/make_env.sh # writes deploy/.env with random passwords
cd deploy && docker compose up -d --build
./dxos admin # creates the admin account with a temporary password
Users come in through the gateway at http://localhost:9080:
| Address | Content |
|---|---|
/ |
Web interface |
/console |
Control panel for the person deploying |
/portal/ |
A page listing the addresses and the state of the services |
/monitor/ |
Monitoring and tracing (ADMIN) |
/v3/api-docs |
OpenAPI specification of the backend |
The Keycloak administration console (/admin) is not exposed by default; set KEYCLOAK_ADMIN_CONSOLE=true in deploy/.env and recreate the gateway to open it (account in deploy/.env).
The full testing guide is in docs/TESTING.md (Vietnamese).
Documentation
Docs site: https://haui-implsolution.github.io/DX-OS/. The documents are written in Vietnamese; the API reference is the OpenAPI specification of the running backend.
| You need | See |
|---|---|
| Using the system by role | submitters, handlers, deployers (Vietnamese) |
| Writing a model file | docs/MODEL.md |
| Calling the API | docs/API.md and the OpenAPI specification (/v3/api-docs) of the running backend |
| Building extension services, webhooks, and custom UIs | docs/EXTENSIONS.md (Vietnamese) |
| Architecture | ARCHITECTURE.md |
Install, the dxos commands, backup |
deploy/OPERATIONS.md |
| Monitoring, logs, access audit | deploy/MONITORING.md |
| Webhooks, tamper-evident history, long-term archive | deploy/INTEGRATIONS.md |
| Connecting a reporting tool | deploy/REPORTING.md (Vietnamese) |
| Testing | docs/TESTING.md, e2e/README.md |
| Verified targets and self-hosting cost | docs/TARGETS.md |
| The 15-minute demonstration script | docs/DEMO.md |
| Design and remaining work | docs/dynamic-core/README.md, BACKLOG.md |
| Changes by version | CHANGELOG.md |
| Compatibility between versions | docs/COMPATIBILITY.md (Vietnamese) |
| Where the project is going | ROADMAP.md (Vietnamese) |
| Third-party components and licenses | DEPENDENCIES.txt, NOTICE, sbom/ |
Repository structure
| Folder | Tier | Content |
|---|---|---|
backend/dx-model |
Core | The model file format: reading and checking |
backend/dx-core |
Core | Shared library: security, audit, storage, state, Keycloak client |
backend/dx-engine |
Core | The core service: applying models, the common API, Flowable |
backend/dx-monitor |
Apps | The monitoring and tracing screen |
frontend |
Apps | A react-admin interface built from metadata, in Vietnamese and English |
deploy |
Shared | Compose, the APISIX gateway, the installer and the dxos command, operation scripts, check scripts in deploy/dev |
sso, seaweedfs |
Core | The Keycloak realm, file storage |
portal |
Apps | The page that links the addresses and the state of the services |
models |
Models | Invalid model files for automatic checks; usable sample models are in backend/dx-engine/src/main/resources/templates/ |
examples |
Outside the core | Sample programs: a receiver that keeps history hashes (history-witness), an IT/OT system simulator (itot-simulator) |
e2e |
Testing | Browser tests of the web interface (Playwright) |
website |
Documentation | The docs site (Docusaurus), published on GitHub Pages |
docs |
Documentation | The testing guide, the model file and the API; the design is in dynamic-core/ |
sbom |
Licenses | CycloneDX component lists of the backend, the web interface and the docs site |
LICENSES |
Licenses | The full text of the licenses of the repository, as the REUSE specification asks |
.github |
Shared | CI workflows, issue and pull request templates, branch rules, check scripts |
Contributing
- Report a bug: open a bug report.
- Suggest a feature: open a feature request.
- Send code: read
CONTRIBUTING.mdand followCODE_OF_CONDUCT.md. - Security vulnerability: do not post it in public, follow
SECURITY.md.
Team
| Name | Contact |
|---|---|
| Phạm Minh Khương | [email protected] |
| Nguyễn Đình Duy Khánh | [email protected] |
| Trần Quang Tùng | [email protected] |
License
Apache License 2.0, see LICENSE.
The license of each third-party component is in DEPENDENCIES.txt.
References: contest topic · DX-OS textbook