---
title: "Knowledge"
description: "Artykuły i poradniki. Każda aplikacja jest modułem na jednym modelu danych."
canonical: "https://obop.dev/pl/apps/knowledge/"
lang: "pl"
---

# Knowledge

## Do czego służy

A wiki of articles arranged in a tree, with draft, published and archived states and tags. Visibility is a label: there are no row-level permissions yet, so everyone with access to the app reads every article.

## Co pakiet robi, a czego nie robi

A wiki: articles arranged in a tree through a parent article, with a draft, published, archived flow, a visibility setting and tags. Visibility is a label for the UI and for people to respect; the platform has no row-level permissions yet, so everyone with the Knowledge groups can read every article.

## Modele

### `knowledge_article`

An article of the knowledge base

Grupa odczytu: `knowledge.user`. Grupa zapisu: `knowledge.user`.

| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
| `title` | text | `none` | nie | `knowledge.user` | jawnie | Article title |
| `parent_id` | ref → knowledge_article | `none` | nie | `knowledge.user` | jawnie | The article this one is nested under; empty for a top-level article |
| `body` | longtext | `none` | nie | `knowledge.user` | jawnie | Article content (Markdown) |
| `visibility` | select (private, workspace, public) | `none` | nie | `knowledge.user` | jawnie | Who the article is meant for: private, workspace, public |
| `tags` | text | `none` | nie | `knowledge.user` | jawnie | Comma-separated tags, for example onboarding,hr |
| `author_name` | text | `public_directory` | tak | `knowledge.user` | zamaskowane | Name of the author |
| `sequence` | number | `none` | nie | `knowledge.user` | jawnie | Order among its siblings, lowest first |
| `published_on` | date | `none` | nie | `knowledge.user` | jawnie | Day the article was published (YYYY-MM-DD) |
| `state` | select (draft, published, archived) | `none` | nie | `knowledge.user` | jawnie | Article status: draft, published, archived |

## Przepływy pracy

### `knowledge_article`

| Akcja | Przenosi | Kto może uruchomić | Zatwierdzenie |
|---|---|---|---|
| `knowledge_article.publish` | state: draft → published | `knowledge.manager` | nie |
| `knowledge_article.unpublish` | state: published → draft | `knowledge.manager` | nie |
| `knowledge_article.archive` | state: published → archived | `knowledge.manager` | nie |

## Grupy uprawnień

Grupy używane przez tę aplikację:

- `knowledge.manager`
- `knowledge.user`

## Kroki zatwierdzania

Żaden krok w tej aplikacji nie wymaga zatwierdzenia, poza usuwaniem rekordów.

## Co agenci mogą, a czego nie mogą

Agent może odczytywać, wyszukiwać, tworzyć i aktualizować rekordy tej aplikacji oraz uruchamiać akcje niewymagające zatwierdzenia, w ramach grup uprawnień swojego tokenu.

Te kroki może tylko zaproponować, a człowiek musi je zatwierdzić: `knowledge_article.delete`.

Dane osobowe są maskowane jako tokeny zastępcze: `knowledge_article.author_name`.

## Zależności

Brak.

## Instalacja

Zainstaluj ją w aplikacji Customize (Marketplace) lub z wiersza poleceń:

```bash
obop modules install-from knowledge
```

Wymaga bazy danych i uprawnień administratora.

## Zbuduj własną

[Przewodnik po modułach pokazuje, jak pisze się takie aplikacje](/pl/docs/reference/module-manifest/)