184 lines
7.2 KiB
HTML
184 lines
7.2 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
|
|
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
|
|
<link rel="canonical" href="https://git.tylconsulting.it/thothii-docs/usage/memory/">
|
|
<link rel="shortcut icon" href="../../img/favicon.ico">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0" />
|
|
<title>Memory - ThothII Docs</title>
|
|
<link href="../../css/bootstrap-3.3.7.min.css" rel="stylesheet">
|
|
<link href="../../css/font-awesome-4.7.0.css" rel="stylesheet">
|
|
<link href="../../css/base.css" rel="stylesheet">
|
|
<link rel="stylesheet" href="../../css/highlight.css">
|
|
<link href="../../stylesheets/extra.css" rel="stylesheet">
|
|
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
|
|
<!--[if lt IE 9]>
|
|
<script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
|
|
<script src="https://oss.maxcdn.com/libs/respond.js/1.3.0/respond.min.js"></script>
|
|
<![endif]-->
|
|
|
|
<script src="../../js/jquery-3.2.1.min.js"></script>
|
|
<script src="../../js/bootstrap-3.3.7.min.js"></script>
|
|
<script src="../../js/highlight.pack.js"></script>
|
|
|
|
<base target="_top">
|
|
<script>
|
|
var base_url = '../..';
|
|
var is_top_frame = false;
|
|
|
|
var pageToc = [
|
|
{title: "Use and administer Memory", url: "#_top", children: [
|
|
{title: "Browse and edit", url: "#browse-and-edit" },
|
|
{title: "Saved content and search availability", url: "#saved-content-and-search-availability" },
|
|
{title: "Memory in a reviewed session", url: "#memory-in-a-reviewed-session" },
|
|
]},
|
|
];
|
|
|
|
</script>
|
|
<script src="../../js/base.js"></script>
|
|
<script src="../../javascripts/layout-init.js"></script>
|
|
</head>
|
|
|
|
<body>
|
|
<script>
|
|
if (is_top_frame) { $('body').addClass('wm-top-page'); }
|
|
</script>
|
|
|
|
|
|
|
|
<div class="container-fluid wm-page-content">
|
|
<a name="_top"></a>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="row wm-article-nav-buttons" role="navigation" aria-label="navigation">
|
|
|
|
<div class="wm-article-nav pull-right">
|
|
<a href="../../install/dwh-auth-server/" class="btn btn-xs btn-default pull-right">
|
|
Next
|
|
<i class="fa fa-chevron-right" aria-hidden="true"></i>
|
|
</a>
|
|
<a href="../../install/dwh-auth-server/" class="btn btn-xs btn-link">
|
|
Server
|
|
</a>
|
|
</div>
|
|
|
|
<div class="wm-article-nav">
|
|
<a href="../../evidence/" class="btn btn-xs btn-default pull-left">
|
|
<i class="fa fa-chevron-left" aria-hidden="true"></i>
|
|
Previous</a><a href="../../evidence/" class="btn btn-xs btn-link">
|
|
Evidence
|
|
</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h1 id="use-and-administer-memory">Use and administer Memory<a class="headerlink" href="#use-and-administer-memory" title="Permanent link">¶</a></h1>
|
|
<p>Memory stores reusable knowledge for a workspace. It is separate from Evidence sources
|
|
and from the saved documents of an individual session.</p>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Card family</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>Domain clarification</td>
|
|
<td>Define a term or interpretation, with its scope.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>SQL rule</td>
|
|
<td>Explain how to construct SQL and why.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Solved question</td>
|
|
<td>Retain an approved question and SQL as a consultative example.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Explained error</td>
|
|
<td>Record a correction and its rationale.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h2 id="browse-and-edit">Browse and edit<a class="headerlink" href="#browse-and-edit" title="Permanent link">¶</a></h2>
|
|
<p>Open <strong>Administration → Memory management</strong> and select the workspace. Administration
|
|
requires the appropriate permissions. You can search, filter, open a card's complete
|
|
content, edit it, manage its dependencies and links, or explicitly confirm deletion.</p>
|
|
<p>Browsing and editing require the PostgreSQL archive but do not require an active session
|
|
or a working DWH or search index. Cards retain their identity and origin when edited;
|
|
there is no editorial revision history. Deleting a card also removes its links and
|
|
dependencies, not the other cards or the workspace's Evidence.</p>
|
|
<p>Links connect cards in the same workspace. Record scope and physical dependencies
|
|
carefully so knowledge is not applied to unrelated databases, tables or columns.</p>
|
|
<h2 id="saved-content-and-search-availability">Saved content and search availability<a class="headerlink" href="#saved-content-and-search-availability" title="Permanent link">¶</a></h2>
|
|
<p>Saving a card and updating its search index are different outcomes. <strong>Saved, index update
|
|
incomplete</strong> means the content is already in the archive but is not ready for recall.
|
|
Use <strong>Pending index updates</strong> to retry. Do not create a duplicate card to work around an
|
|
indexing failure. A restart does not discard the pending operation.</p>
|
|
<p>Qdrant is a rebuildable search projection, not the authoritative archive. Rebuilding it
|
|
does not recover deleted cards from old sessions or vector payloads. Back up the
|
|
authoritative installation data before maintenance.</p>
|
|
<p>After a successful physical schema synchronization, cards dependent on removed database
|
|
objects can be deleted. Workspace-wide cards and unrelated dependencies remain. Review
|
|
the synchronization result and any pending cleanup before starting another synchronization.</p>
|
|
<h2 id="memory-in-a-reviewed-session">Memory in a reviewed session<a class="headerlink" href="#memory-in-a-reviewed-session" title="Permanent link">¶</a></h2>
|
|
<p>The workflow proposes relevant clarifications, rules and examples. A search result is
|
|
not approval: the reviewer decides whether it applies. At the final Memory review,
|
|
select the additions or updates worth retaining, edit their content and scope, or decline
|
|
them all. Finalizing a session does not silently approve every proposed card.</p>
|
|
<p>Approved SQL is read-only at that final review. To change the solution, return to SQL
|
|
review. See the <a href="../../skills/">workflow guide</a> and <a href="../../guida-utente/">user guide</a>.</p>
|
|
|
|
<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="row wm-article-nav-buttons" role="navigation" aria-label="navigation">
|
|
|
|
<div class="wm-article-nav pull-right">
|
|
<a href="../../install/dwh-auth-server/" class="btn btn-xs btn-default pull-right">
|
|
Next
|
|
<i class="fa fa-chevron-right" aria-hidden="true"></i>
|
|
</a>
|
|
<a href="../../install/dwh-auth-server/" class="btn btn-xs btn-link">
|
|
Server
|
|
</a>
|
|
</div>
|
|
|
|
<div class="wm-article-nav">
|
|
<a href="../../evidence/" class="btn btn-xs btn-default pull-left">
|
|
<i class="fa fa-chevron-left" aria-hidden="true"></i>
|
|
Previous</a><a href="../../evidence/" class="btn btn-xs btn-link">
|
|
Evidence
|
|
</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<br>
|
|
</div>
|
|
|
|
<footer class="container-fluid wm-page-content">
|
|
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a> using <a href="https://github.com/gristlabs/mkdocs-windmill">Windmill</a> theme by Grist Labs.</p>
|
|
</footer>
|
|
|
|
</body>
|
|
</html> |