MyOwn Portal

MyOwn Portal is a compact, English-language administration interface for InterSystems IRIS and IRIS for Health. It was created for the InterSystems Programming Contest: Build Your Own Management Portal.

The browser application uses React and TypeScript. The REST backend, authorization, auditing, and access to IRIS administration data are implemented in ObjectScript. Administrative inventories require the official SysAdmin API v2. Vite and Node.js are development and build tools only; the production React bundle is served by the private IRIS web server.

Official API compliance. Processes, users, roles, resources, tasks, web applications, X.509 credentials, OAuth configuration, and Secure Wallet metadata are all read and written through the official /api/admin/v2/... endpoints — not through direct calls to native classes. Two areas intentionally stay outside the SysAdmin API because it has no equivalent endpoint for them: host-level CPU/memory/disk metrics (Overview) and general system logging (messages.log, the Logs page). This isn’t an oversight — other teams who built against the same specification for this same contest independently hit and documented the same two gaps. See SysAdmin API integration and the Design note in the reference doc for the full detail, including which native %Admin_* privileges each area requires.

Automated tests. scripts/Test-MyOwn.ps1 runs a full smoke-test suite against a running instance, and scripts/Test-SysAdminMutations.ps1 exercises real SysAdmin API v2 mutations (create/assign/remove/delete) end to end, cleaning up after itself. See Tests in the reference doc.

Read the write-up on the InterSystems Developer Community: English · Português

Online demo (temporary, for contest evaluation): https://163-176-71-47.sslip.io/myown/index.html — sign in with _SYSTEM / ChangeMe2026!. Hosted on a free Oracle Cloud Always Free instance with a free Let’s Encrypt HTTPS certificate; every page is pre-populated with sample data to review. This instance is shared and temporary, kept online only for the duration of the contest.

Quick Start

MyOwn Portal has no login of its own — it authenticates directly against the IRIS instance it is installed on. See docs/REFERENCE.md for the full explanation.

The easy way: one double-click

Double-click Instalar.bat at the project root. It figures out the rest on its own:

• Docker path: if Docker Desktop is installed, it builds and starts the demo container and opens http://localhost:52774/myown/index.html for you. Docker Desktop needs to already be open before you run the installer — if it isn’t running yet, start it first, wait for it to finish starting up, then run Instalar.bat.
• Local IRIS path: if you already have IRIS installed locally instead, it asks which namespace to install into (press Enter for the default, MYOWN, or type the name of a namespace you already use), builds the frontend (downloading a local copy of Node.js first if needed, no admin rights required for that part), deploys the files, restarts the private web server, and installs the backend — fully automatically, over IRIS’s own Atelier REST API, no terminal to paste into. It asks once for your IRIS username and password for that last step; they are used only in memory and never written to disk. It then opens http://localhost:52773/myown/index.html.
• If both Docker and a local IRIS are found, it asks once which one you want.

It will ask Windows for administrator permission once (needed only to restart the IRIS private web server on the local-install path) — approve that, and everything else runs by itself. The one thing it cannot do for you is the one-time creation of the namespace if it does not already exist on your IRIS instance; if that is the case, it stops and tells you exactly where to click (Management Portal → System Administration → Configuration → System Configuration → Namespaces → New Namespace) — then just run Instalar.bat again.

docker compose up --build -d

Everything else — architecture, every install detail, the API reference, and troubleshooting — is in docs/REFERENCE.md in this repository.

Features

• System overview, operating-system metrics, and active IRIS processes.
• Embedded Python health scoring with a concise instance-health summary.
• AI-Powered Instance Monitor: flags any CPU, memory, disk, lock, or process metric that is statistically unusual compared to its own recent history.
• Native IRIS Vector Search against stored health patterns and recommendations.
• Users, roles, resources, effective permissions, and controlled role assignment.
• Web application and REST API inventory with protected enable/disable actions.
• A bounded local REST API Explorer with an OpenAPI view.
• Sanitized certificate, OAuth, Secure Wallet, and credential-reference metadata.
• IRIS Task Manager inventory with protected Run, Suspend, and Resume actions.
• Sanitized messages.log browsing with search, filters, pagination, and details.
• Native IRIS role-based access control and audit events for state changes.
• Official SysAdmin API v2 integration for processes, permissions, tasks, web applications, X.509, OAuth, and Secure Wallet metadata, with automatic capability detection. Host metrics and system logs stay native, since the API has no endpoint for either.
• A demonstration Task Manager task (MyOwn Portal health snapshot) so that Run, Suspend, and Resume can be tried on a fresh instance.
• Responsive English user interface.

Contest technology bonuses

• Embedded Python: the instance health score and the host memory and disk metrics are computed in Language = python methods.
• Vector Search: health patterns are stored in a %Vector property and matched with VECTOR_COSINE.
• Docker: Dockerfile and compose.yaml build and run the portal on IRIS Community Edition.
• IPM package: module.xml defines the myown-portal module.
• Implement Community Opportunity idea: implemented DPI-I-512, “add AI to Instance Monitor to prevent major incident” as the AI Instance Monitor on the Overview page. MyOwn.Task.HealthSnapshot now records CPU, memory, disk, lock, and process metrics on every run; MyOwn.Service.HealthAnalysis.DetectAnomalies (Embedded Python) flags a metric once it sits more than two standard deviations from its own recent average, and needs at least 5 recorded snapshots before it evaluates anything. On a fresh instance, open the Tasks page and click Run on the demonstration task (MyOwn Portal health snapshot) a handful of times to build that history. With no anomaly, the Overview page shows “✓ AI Instance Monitor: no unusual patterns in recent history” — that quiet state is the expected, correct result on a healthy instance, not a missing feature.
• Online demo (temporary, for contest evaluation): https://163-176-71-47.sslip.io/myown/index.html — sign in with _SYSTEM / ChangeMe2026!.
• Embedded Python bug report: found and reported an upstream Embedded Python bug — a [Language = python] ClassMethod declared to return %BigInt silently returns -1 for any Python int of 2**63 or greater (the same value returned as %String round-trips correctly), instead of the correct value or an error. See python-bugreports issue #19 for the full report and a minimal reproduction.

License

MIT

Team

• Murilo Przybyloviecz — Developer Community profile
• Andre Larsen Barbosa — Developer Community profile