# ZGATRI Workspace

**English** | [简体中文](README.zh-CN.md)

A self-hosted personal workspace for memory, ideas, projects, tools, and infrastructure. Built with vanilla HTML, CSS, JavaScript, and a Node.js/SQLite API, with an optional Hindsight memory backend.

[Quick start](#quick-start) · [Screenshots](#screenshots) · [Workbench guide](workbench/README.md) · [Deployment](workbench/DEPLOY.md)

## Features

| Area | What the UI includes |
| --- | --- |
| Projects | Cards, list view, status filters, project details and editing |
| Memory | Categories, tags, timeline, related content and a detail panel |
| Ideas | Card/list/board layouts, search, tags and quick capture |
| Information collection | Sources, tasks, processing pipeline and logs |
| Infrastructure | Servers, containers, domains, monitoring and security panels |
| Tools | Shortcuts, categories, recent activity and script entries |
| Security and settings | Credential metadata, members, devices, preferences and notifications |
| Overview | A shared entry point for memory metrics and project cards |

Production defaults to **actual data**, refreshed every 30 seconds while visible. Projects, ideas, tools, memories, ingestion jobs, host resources, containers and the configured origin certificate use backend data. Local static preview explicitly uses synthetic demo content. External collection, member/device management and alerts remain marked as unconnected. See [live backend coverage](workbench/docs/live-backend-2026-10.md).

## Quick start

Requires Node.js 22.18 or later. From the repository root:

```sh
git clone https://github.com/Ti08X/zgatri-workspace.git
cd zgatri-workspace
npm run preview:workbench
```

Open [http://127.0.0.1:8898/#projects](http://127.0.0.1:8898/#projects). The preview serves static files only and does not connect to a production database. See the [workbench guide](workbench/README.md) for API setup, configuration and checks.

## Screenshots

All images below are regenerated from the public code with sanitized, synthetic data. Addresses, accounts, device details and memory entries are examples. Text-bearing private thumbnails are replaced with synthetic artwork. [Browse all 16 desktop/mobile images](workbench/docs/ui-redesign-2026-10.md).

### Projects

![Projects — sanitized demo](workbench/docs/screenshots/projects-desktop.png)

[Mobile preview](workbench/docs/screenshots/projects-mobile.png)

### Memory

![Memory — sanitized demo](workbench/docs/screenshots/memory-desktop.png)

[Mobile preview](workbench/docs/screenshots/memory-mobile.png)

### Ideas

![Ideas — sanitized demo](workbench/docs/screenshots/ideas-desktop.png)

[Mobile preview](workbench/docs/screenshots/ideas-mobile.png)

### Information collection

![Information collection — sanitized demo](workbench/docs/screenshots/intel-desktop.png)

[Mobile preview](workbench/docs/screenshots/intel-mobile.png)

### Infrastructure

![Infrastructure — sanitized demo](workbench/docs/screenshots/infra-desktop.png)

[Mobile preview](workbench/docs/screenshots/infra-mobile.png)

### Tools

![Tools — sanitized demo](workbench/docs/screenshots/tools-desktop.png)

[Mobile preview](workbench/docs/screenshots/tools-mobile.png)

### Security and settings

![Security and settings — sanitized demo](workbench/docs/screenshots/settings-desktop.png)

[Mobile preview](workbench/docs/screenshots/settings-mobile.png)

### Overview

![Overview — sanitized demo](workbench/docs/screenshots/overview-desktop.png)

[Mobile preview](workbench/docs/screenshots/overview-mobile.png)

## Project structure

```text
workbench/
  portal/       Current workspace UI and assets
  server.mjs    Node.js/SQLite workspace API
  scripts/      Static preview and isolated API/UI checks
  docs/         Redesign notes and sanitized screenshots
```

The other `src/`, `server/`, `public/` and integration directories retain the earlier Memory Hub implementation. Its [historical guide](docs/legacy-memory-hub-readme.md) documents that separate implementation; it is not the entry point for the redesigned workspace.

## Documentation

- [Workbench usage and configuration](workbench/README.md)
- [Deployment and operations](workbench/DEPLOY.md)
- [UI redesign and screenshot gallery](workbench/docs/ui-redesign-2026-10.md)
- [Public-release verification](workbench/docs/public-release-verification.json)
- [Historical Memory Hub documentation](docs/legacy-memory-hub-readme.md)

Keep authentication at the reverse proxy and the API on loopback. This source distribution contains no production database, private archive, credentials or backups.

## License

[ISC](LICENSE)