> ## Documentation Index
> Fetch the complete documentation index at: https://hub.ypym.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Tessera Note

> Structured note-taking and knowledge organization tool built by YPYM for clarity and precision.

## Overview

Tessera Notes is YPYM's internal knowledge organization tool, built to capture, structure, and distill complex information into actionable intelligence. In a world of noise, Tessera Note enforces clarity.

It reflects our core belief: **good systems start with good notes**, structured, logical, and always accessible.

<Note>
  Tessera Notes is a YPYM internal product. Demo access is available at [tessera-notes.ypym.app](https://tessera-notes.ypym.app/).
</Note>

## Core Capabilities

<ParamField body="structured_capture" type="boolean" default="true">
  Enforces structured note-taking with predefined templates for research, strategy, and technical documentation.
</ParamField>

<ParamField body="knowledge_graph" type="boolean" default="true">
  Connects related notes, tags, and entities into an interconnected knowledge graph for cross-referencing.
</ParamField>

<ParamField body="distillation_engine" type="string" default="auto">
  Automatically distills long-form research into executive summaries and key takeaways. Modes: `auto`, `manual`, `hybrid`.
</ParamField>

<ParamField body="export_format" type="string" default="markdown">
  Export notes in multiple formats. Supported: `markdown`, `pdf`, `json`, `html`.
</ParamField>

## Use Cases

| Use Case                   | Description                                                                                                            |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Research Capture**       | Structure raw research from market analysis, competitor audits, and sector intelligence into reusable knowledge blocks |
| **Strategy Documentation** | Document SEO strategies, campaign plans, and venture studio blueprints with version control                            |
| **Client Briefings**       | Generate structured briefing documents from accumulated intelligence for partner engagements                           |
| **Technical Specs**        | Maintain living technical specification documents that evolve alongside product development                            |

## Architecture

Tessera Notes is built on a Ghost CMS backbone with a custom MySQL persistence layer, containerized via Docker for portability and resilience.

| Component      | Stack                                              |
| -------------- | -------------------------------------------------- |
| **Frontend**   | Ghost 5 (Alpine): content management and rendering |
| **Database**   | MySQL 8.0: structured data persistence             |
| **Network**    | Docker bridge network (`tessera-network`)          |
| **Deployment** | Docker Compose: single-command orchestration       |

## Access

<Card title="Live Demo" icon="globe" href="https://tessera-notes.ypym.app/">
  Access the Tessera Notes demo instance
</Card>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://tessera-notes.ypym.app/ghost/api/content/posts/ \
    --header 'Accept: application/json'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://tessera-notes.ypym.app/ghost/api/content/posts/",
    {
      method: "GET",
      headers: { "Accept": "application/json" }
    }
  );
  const data = await response.json();
  console.log(data.posts);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://tessera-notes.ypym.app/ghost/api/content/posts/",
      headers={"Accept": "application/json"}
  )
  posts = response.json()["posts"]
  print(posts)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "posts": [
      {
        "id": "abc123",
        "title": "Market Intelligence: Q1 2026",
        "slug": "market-intelligence-q1-2026",
        "status": "published",
        "created_at": "2026-01-15T08:00:00.000Z",
        "updated_at": "2026-03-01T10:30:00.000Z",
        "tags": [
          { "name": "market-intel", "slug": "market-intel" },
          { "name": "quarterly", "slug": "quarterly" }
        ],
        "excerpt": "Structured intelligence report covering IDX sector movements, competitor positioning, and organic search landscape shifts."
      }
    ],
    "meta": {
      "pagination": {
        "page": 1,
        "limit": 15,
        "pages": 1,
        "total": 1
      }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "errors": [
      {
        "message": "Resource not found",
        "type": "NotFoundError"
      }
    ]
  }
  ```
</ResponseExample>