open-enterprise-solutions · YuriiTetra · Apr 13, 2026 · Apr 13, 2026 · Apr 13, 2026 · Apr 14, 2026
diff --git a/.gitignore b/.gitignore
@@ -261,4 +261,12 @@ build/
 
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
-*.pyc
+*.pyc
+
+# Web client
+web/node_modules/
+web/dist/
+web/.env.local
+
+# Research docs (internal only)
+docs/RESEARCH-*
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -8,7 +8,7 @@ This file gives an AI assistant (Claude Code or similar) the context needed to w
 
 **Open Enterprise Solutions (OES)** is a C++17 cross-platform low-code enterprise application platform, conceptually similar to 1C:Enterprise. It lets developers define business applications through metadata (object types, forms, modules) and a built-in scripting language, without writing low-level code.
 
-The runtime executes compiled bytecode, renders forms through wxWidgets, and stores all application data in a relational database (Firebird by default).
+The runtime executes compiled bytecode, renders forms through wxWidgets (desktop) or a browser-based React SPA (web client), and stores all application data in a relational database (Firebird by default).
 
 ---
 
@@ -17,9 +17,12 @@ The runtime executes compiled bytecode, renders forms through wxWidgets, and sto
 | Area | Technology |
 |---|---|
 | Language | C++17 |
-| GUI | wxWidgets 3.3.2 (git submodule at `src/3rdparty/wxWidgets`) |
+| Desktop GUI | wxWidgets 3.3.2 (git submodule at `src/3rdparty/wxWidgets`) |
+| Web client | React SPA — Refine v5, shadcn/ui, Formily (in `web/`) |
+| HTTP server | cpp-httplib (header-only, `src/3rdparty/cpp-httplib/httplib.h`) |
+| JSON | nlohmann/json (`src/3rdparty/nlohmann/json.hpp`) |
 | Build (Windows) | MSBuild — `enterprise.sln` (Visual Studio 2019/2022) |
-| Build (cross-platform) | CMake — planned, `CMakeLists.txt` does not exist yet |
+| Build (cross-platform) | CMake — `CMakeLists.txt` |
 | Primary database | Firebird (embedded) |
 | Optional databases | PostgreSQL, SQLite, MySQL, ODBC |
 | License | LGPL 2.1 |
@@ -33,19 +36,28 @@ enterprise/
 ├── enterprise.sln           # 9-project MSBuild solution
 ├── Common.props             # Shared output paths and macros
 ├── ConfigurationDefs.props  # Per-configuration preprocessor defines
+├── CMakeLists.txt           # Cross-platform CMake build
 ├── CLAUDE.md                # This file
 ├── docs/
 │   ├── ARCHITECTURE.md
 │   └── BUILD.md
+├── web/                     # Web client (React SPA)
+│   ├── src/                 # TypeScript/React source
+│   ├── dist/                # Built static files (served by daemon)
+│   └── package.json
 └── src/
-    ├── 3rdparty/wxWidgets/  # Submodule
+    ├── 3rdparty/
+    │   ├── wxWidgets/       # Submodule
+    │   ├── cpp-httplib/     # HTTP server (header-only)
+    │   └── nlohmann/        # JSON library (header-only)
     └── engine/
         ├── backend/         # backend.dll  — engine, compiler, DB, metadata, debugger
+        │   └── webServer/   # ibWebServer — HTTP server (cpp-httplib wrapper)
         ├── frontend/        # frontend.dll — wxWidgets UI, form renderer
         ├── enterprise/      # enterprise.exe
         ├── designer/        # designer.exe  (IDE)
         ├── launcher/        # launcher.exe  (connection chooser)
-        ├── daemon/          # daemon.exe    (background service)
+        ├── daemon/          # daemon.exe    (background service + HTTP server)
         ├── codeRunner/      # codeRunner.exe
         ├── classChecker/    # classChecker.exe
         └── simplePlugin/    # simplePlugin.dll (example)
@@ -169,6 +181,70 @@ These are located primarily in the compiler and metadata loading paths. They mas
 
 ---
 
+## Web Server
+
+### Architecture
+
+The web server uses **server-side form rendering** — forms live in memory on the server, browser receives JSON layouts and sends events back. daemon.exe links both backend.dll and frontend.dll.
+
+```
+Browser (React SPA)
+    │ HTTP (JSON layouts + events)
+    ▼
+daemon.exe (backend.dll + frontend.dll)
+    ├─ ibWebServer (cpp-httplib) ──► /api/* endpoints
+    ├─ ibWebSessionManager ──► per-user sessions with forms in memory
+    ├─ ibWebMainFrame ──► enables CreateNewForm() in service mode
+    └─ ibWebVisualHost ──► builds JSON proxy tree from ibValueForm
+         │
+         ▼
+    backend.dll ──► Database
+```
+
+### Key Files
+
+| File | Purpose |
+|---|---|
+| `src/engine/backend/webServer/ibWebServer.h` | HTTP server (cpp-httplib wrapper) |
+| `src/engine/frontend/visualView/webHost/ibWebVisualHost.h` | Server-side form rendering → JSON |
+| `src/engine/frontend/visualView/webHost/ibWebControlProxy.h` | wxObject replacement for web |
+| `src/engine/daemon/ibWebMainFrame.h` | CreateNewForm() in service mode |
+| `src/engine/daemon/ibWebSessionManager.h` | Per-user sessions with forms |
+| `src/engine/daemon/ibWebSessionRoutes.cpp` | Session API endpoints |
+| `web/` | React SPA frontend (Vite + TypeScript) |
+
+### Running the Web Server
+
+```bash
+# Start daemon with web server
+./daemon --srv localhost --db mydb --ib_usr admin --ib_pwd "" --web-port 8765
+
+# Test health endpoint
+curl http://localhost:8765/api/health
+```
+
+### Web Client Stack
+
+| Technology | Purpose |
+|---|---|
+| Refine v5 | CRUD framework, routing, auth |
+| shadcn/ui | UI components (@oes/theme preset) |
+| Formily v2 | JSON Schema → rendered forms |
+| Phosphor Icons | 9000+ professional icons |
+| AG Grid | Heavy data tables |
+| Monaco Editor | Code editor (web designer/debugger) |
+
+### Building the Web Client
+
+```bash
+cd web
+npm install
+npm run build    # → web/dist/ (served by daemon)
+npm run dev      # → http://localhost:5173 (dev mode with API proxy)
+```
+
+---
+
 ## Build Commands
 
 ### Windows — MSBuild (preferred)
@@ -212,7 +288,7 @@ All feature work happens on branches cut from `develop`. Pull requests target `d
 | Member variables | `m_` prefix | `m_pByteCode`, `m_strName` |
 | Static members | `s_` prefix | `s_instance`, `s_listKeyWord` |
 | Compile-time constants | `g_` prefix | `g_metaCatalogCLSID` |
-| Macros (singletons) | lower camelCase | `appData`, `db_query`, `activeMetaData`, `debugServer` |
+| Macros (singletons) | lower camelCase | `appData`, `db_query`, `activeMetaData`, `debugServer`, `webServer` |
 | File names | camelCase or lowerCamelCase | `compileCode.cpp`, `databaseLayer.h` |
 | CLSID strings | `XX_YYY` pattern | `"MD_CAT"`, `"VL_NUMB"` |
 
@@ -323,3 +399,20 @@ CI/CD, cross-platform builds (MSBuild + CMake), release management. PRs → deve
 
 ### Code Refactorer (`oes-code-refactorer`)
 Fixes MSVC-specific code for Clang/GCC, breaks circular includes, modernizes to C++17 where appropriate. One refactoring per PR.
+
+### Web Client Agents
+
+| Agent | Purpose |
+|---|---|
+| `oes-frontend-engineer` | React, Refine, shadcn, Formily, API integration |
+| `oes-api-builder` | REST API design, cpp-httplib handlers, JWT auth |
+| `oes-ux-optimizer` | UX flows, navigation, keyboard-first patterns |
+| `oes-ui-polisher` | Visual polish, animations, Enterprise Sharp design |
+| `oes-design-system` | @oes/ui registry, Tailwind preset, ERP components |
+| `oes-ai-integration` | AI config generation, MCP tools, vibe-coding pipeline |
+| `oes-content-writer` | UX copywriting, error messages, tooltips, i18n |
+| `oes-mobile-optimizer` | Responsive, PWA, touch, offline |
+| `oes-accessibility` | WCAG, keyboard nav, screen readers |
+| `oes-analytics-engineer` | Usage tracking, funnels, performance metrics |
+| `oes-load-tester` | Load testing API, concurrent users |
+| `oes-integration-master` | MCP servers, iframe embed, webhooks |
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -125,6 +125,9 @@ else()
     add_compile_options(-Wall -Wno-unused-parameter -Wno-sign-compare)
     if(CMAKE_CXX_COMPILER_ID MATCHES "Clang")
         add_compile_options(-Wno-deprecated-declarations)
+        # Allow MSVC extension: binding temporary to non-const lvalue reference
+        # Used extensively in OES codebase (e.g. SaveData(ibWriterMemory& = ibWriterMemory()))
+        add_compile_options(-fms-extensions)
     endif()
 endif()