Zasady Fabryki

{{>toc}}

**Strona nadrzędna:** [[Wiki|Zasady Fabryki]]

Źródło: `ZasadyRealizacji\redmine-instrukcja-dla-projektow.md` w drzewie FB. Wiki jest kopią do czytania – zmiany nanosimy w pliku źródłowym, nie tutaj.

---

Ustanowiona 2026-08-23 po pierwszym pełnym przebiegu kanału zadań (Akademia UKSC, projekt `laa-2026`). Obowiązuje w każdym projekcie FB – komercyjnym i rozwojowym. Uzupełnia `most-sesja-redmine.md` (zasada kanału) o stronę wykonawczą: jak wystawiać zadania, czym, w jakim formacie i czego nie robić.

## Podział serwerów i kanałów

<table style="width:100%">

<tr><th style="width:20%"></th><th style="width:35%">s62 (<code>projekty.fabrykabezpieczenstwa.pl</code>)</th><th style="width:45%">s87 (<code>r.fabrykabezpieczenstwa.pl</code>)</th></tr>

<tr><td>Rola</td><td>klienci: projekty aktualne, baza wiedzy</td><td>baza Fabryki: projekty rozwojowe, zasady biznesowe</td></tr>

<tr><td>Co trafia</td><td><code>ProjektyC\Komercyjne\*</code>, domeny PIWJ, <strong>oraz wszystkie zadania – także rozwojowe</strong></td><td>wiki doktryny i zasad: <code>FB_rozwojowe\*</code>, <code>ZasadyRealizacji\*</code></td></tr>

<tr><td>Stan</td><td>działa (wiki + zadania)</td><td>uruchamiany 2026-08-23; projekt <code>zasady-fabryki</code></td></tr>

</table>

**Zadania mają jeden kręgosłup – s62** (rozstrzygnięcie 2026-08-23). Powód: relacje między zgłoszeniami (blokady, powiązania) działają wyłącznie w obrębie jednej instancji Redmine, a zależności między rozwojem a robotą u klientów są realne – wydanie metodyki blokuje zadania wdrożeniowe. Projekt organizacyjny dla rozwoju: **`fb-rozwojowe`** (`https://projekty.fabrykabezpieczenstwa.pl/projects/fb-rozwojowe/`).

Docelowo s87 przejmie także klientów; migracja będzie tania, bo zadania generujemy ze stagingu, a źródłem prawdy są harmonogramy w plikach – przeniesienie to ponowny przebieg skryptu z czystym mapowaniem, nie przepisywanie zgłoszeń.

Kanały równoległe, jedno źródło:

- **pliki projektu** (`Administracja\Harmonogram.md`) – źródło prawdy;

- **Redmine** – wykonanie, zależności, przypomnienia mailowe;

- **Google Tasks** – prywatny widok dnia (tylko zadania własne).

## Skrypty

<table style="width:100%">

<tr><th style="width:30%">Skrypt</th><th style="width:70%">Do czego</th></tr>

<tr><td><code>ProjektyC\Skrypty\Publikuj-Zadania-Redmine.ps1</code></td><td>zadania → zgłoszenia Redmine (create/update + relacje)</td></tr>

<tr><td><code>ProjektyC\Skrypty\Publikuj-Zadania-GoogleTasks.ps1</code></td><td>te same zadania → Google Tasks (lista „Fabryka")</td></tr>

<tr><td><code>ProjektyC\FB_rozwojowe\Redmine\Publikuj-PIWJ-Redmine.ps1</code></td><td>strony wiki PIWJ</td></tr>

<tr><td><code>Akademia_UKSC_2026-07\Redmine\Publikuj-Akademia-Redmine.ps1</code></td><td>strony wiki Akademii</td></tr>

</table>

Oba skrypty zadaniowe czytają ten sam staging: `ProjektyC\Redmine_STAGING\zadania\RRRR-MM-DD_<projekt>.json`. Podfolder `wstrzymane\` = pliki zaparkowane (nie publikują się).

## Format stagingu

```json

{

  "projekt": "VCN",

  "projekt_redmine": "vcn",

  "tracker": 2,

  "przypisz_do": 7,

  "przypisz_do_mnie": false,

  "do_google": true,

  "zadania": [

    {

      "id": "VCN-3.1",

      "zadanie": "Warsztaty: szacowanie i ocena ryzyka",

      "opis": "treść z linkami [[Strona_Wiki]]",

      "start": "2026-09-01",

      "koniec": "2026-09-30",

      "godziny": 11.0,

      "tracker": 2,

      "przypisz_do": 7,

      "google": true,

      "zaleznosc": ["VCN-2.5", "VCN-2.6"]

    }

  ]

}

```

Pola opcjonalne działają kaskadowo: ustawienie przy zadaniu ma pierwszeństwo przed ustawieniem przy pliku.

<table style="width:100%">

<tr><th style="width:30%">Pole</th><th style="width:70%">Znaczenie</th></tr>

<tr><td><code>tracker</code></td><td>typ zgłoszenia; <strong>domyślnie 2 = Zadanie</strong>. 1 = Uwaga ogólna – bez jawnego podania Redmine wybiera pierwszy typ projektu</td></tr>

<tr><td><code>przypisz_do</code></td><td>numer użytkownika Redmine (Greg = <strong>7</strong>)</td></tr>

<tr><td><code>przypisz_do_mnie</code></td><td><code>true</code> → właściciel klucza API (przydatne przy kontach projektowych, np. LAA2026 = #43)</td></tr>

<tr><td><code>do_google</code> / <code>google</code></td><td>co idzie do prywatnej listy zadań; zadania innych osób zostają wyłącznie w Redmine</td></tr>

<tr><td><code>zaleznosc</code></td><td>jedno ID albo lista ID – zakładane jako relacje <code>blocked</code></td></tr>

<tr><td><code>godziny</code></td><td><code>estimated_hours</code>; parowanie z rozliczeniem godzin po <code>id</code></td></tr>

</table>

## Trzy role, zero dublowania treści (ustalone 2026-08-23)

- **Redmine – miejsce pracy.** Tam się wpisuje ustalenia, podpina dokumenty, prowadzi ślad. Treść zadania żyje tutaj.

- **Google Tasks – magazyn listy dnia.** Nie zawiera treści; notatka to **link do zgłoszenia** plus jedna linia opisu. Termin dzienny, bez godziny.

- **Google Calendar – podgląd.** Pokazuje zadania z Tasks obok spotkań; to jest widok, na który Greg patrzy rano na iPadzie.

Konsekwencja praktyczna: z kalendarza klikasz zadanie → link → jesteś w zgłoszeniu, gdzie dopisujesz i podpinasz. Lista dnia zostaje listą, praca zostaje w Redmine.

## Konwencje treści

- **ID zadania** = identyfikator z harmonogramu, prefiks projektu (`VCN-3.1`, `AQU-01`, `S2-Z1-U1`). Trafia do tematu w nawiasie kwadratowym: `[VCN-3.1] Nazwa zadania`.

- **Jedno zgłoszenie = jeden produkt.** Nie „przerób sekwencję", tylko „wypełnij tabelę charakterystyki".

- **Odesłanie do wiki linkiem** `[[Nazwa_Strony]]`, nigdy kopia treści.

- **Narzędzie wskazane wprost** – jeśli zadanie wykonuje się promptem, link do strony promptu jest w opisie.

- Opisy z polskimi znakami; skrypt wysyła treść jawnie jako UTF-8 (PowerShell 5.1 potrafi inaczej zrobić mojibake).

## Przebieg

```powershell

cd C:\Users\Greg\FB\ProjektyC\Skrypty

.\Publikuj-Zadania-Redmine.ps1 -DryRun    # kontrola: co powstanie, komu, z jakimi blokadami

.\Publikuj-Zadania-Redmine.ps1            # na żywo (klucz przez Read-Host)

.\Publikuj-Zadania-GoogleTasks.ps1        # zadania własne do listy „Fabryka"

```

Cały raport wklejasz do czatu – asystent weryfikuje i odhacza manifest. Klucz API nigdy nie trafia do pliku ani do agenta.

## Ziarnistość zadań: jedno zadanie = jeden dokument (2026-08-24)

Zadanie obejmujące pakiet („przegląd sześciu polityk") jest wygodne przy zakładaniu i bezużyteczne w pracy: nie da się go powiązać ze stroną wiki, na której leży konkretny dokument, a postęp widać dopiero po zamknięciu całości.

**Reguła:** jeden dokument do przeglądu albo opracowania = jedno zgłoszenie. W opisie zgłoszenia pierwszy wiersz to **link do strony wiki z dokumentem**, dalej liczby (wymagania, pozycje otwarte) i pytanie do rozstrzygnięcia.

Skutki, dla których warto tego pilnować:

- **wiązanie dwustronne** – zgłoszenie wskazuje stronę wiki, tabela przeglądu statusów wskazuje zgłoszenie; jedno źródło prawdy, dwa widoki,

- **postęp per dokument** zamiast per pakiet,

- **oszacowania są uczciwsze** – pół godziny na politykę jest sprawdzalne, trzy godziny na pakiet są życzeniem,

- pakiet nadal widać: jako wspólny termin i sąsiedztwo w tabeli przeglądu.

Konsekwencja dla wiki: **każdy dokument roboczy w formacie md, który czeka na przegląd, dostaje własną podstronę**. Bez niej zgłoszenie nie ma do czego odesłać, a przegląd wymaga otwierania drzewa plików zamiast czytania w przeglądarce.

## Pułapki techniczne (sprawdzone w boju)

Wszystkie z tej samej rodziny: PowerShell i .NET rozumieją to samo pojęcie inaczej.

<table style="width:100%">

<tr><th style="width:20%">Pułapka</th><th style="width:35%">Objaw</th><th style="width:45%">Rozwiązanie</th></tr>

<tr><td><code>Get-Content -Raw</code> + <code>ConvertTo-Json</code></td><td>rozsypana treść strony wiki (lekcja <code>UOPP_rozdzial1</code>)</td><td>czytać przez <code>[System.IO.File]::ReadAllText(..., UTF8)</code></td></tr>

<tr><td>Kodowanie w REST</td><td>krzaki w polskich znakach</td><td>treść wysyłać jako bajty UTF-8 + <code>charset=utf-8</code> w Content-Type</td></tr>

<tr><td>Ścieżki względne w <code>[System.IO.File]</code></td><td>„Nie można odnaleźć części ścieżki C:\WINDOWS\…"</td><td>.NET rozwija je wobec katalogu <strong>procesu</strong>, nie lokalizacji PowerShella – normalizować do bezwzględnej (<code>Resolve-Path</code>)</td></tr>

<tr><td>Brak <code>tracker_id</code></td><td>zgłoszenia jako „Uwaga ogólna"</td><td>podawać jawnie, domyślnie 2</td></tr>

<tr><td>Wstawianie wierszy w xlsx</td><td>rozjechane formuły podsumowań</td><td>po <code>insert_rows</code> przeliczyć zakresy sum i odwołania</td></tr>

<tr><td>Landing pod własną nazwą</td><td>zakładka „Wiki" projektu otwiera pusty edytor</td><td>stronę główną projektu publikować <strong>pod nazwą <code>Wiki</code></strong></td></tr>

<tr><td>Zawinięte akapity w źródle</td><td>zdania łamane co wiersz (Hardbreaks)</td><td>staging renderować z <strong>rozwiniętymi akapitami</strong> (jedna linia = jeden akapit); listy, tabele i cytaty bez zmian</td></tr>

</table>

## Formatowanie stron wiki – kanon

**Nie powielamy tego opisu.** Konwencja formatowania stron Redmine jest opisana w pamięci projektu PIWJ i obowiązuje wszystkie projekty:

- `ZasadyRealizacji\pamiec-asystenta\projekty\PIWJ\instrukcja.md`, sekcja „Narzędzia i formaty";

- `ZasadyRealizacji\pamiec-asystenta\projekty\PIWJ\memory.md`, punkt „Redmine wiki table formatting".

Skrót do szybkiego sprawdzenia (źródłem pozostają pliki wyżej): tabele o nierównych szerokościach **wyłącznie HTML** `<table style="width:100%">` z jawnym `style` na każdej kolumnie (dwie kolumny 30/70, nawigacyjne trzy 20/35/45); w komórkach HTML używać `<strong>` i `<code>`, nie składni Markdown; tekst wprowadzający jako **zwykły akapit**, nie cytat `>`; strony złożone jako strona nadrzędna plus podstrony z `**Strona nadrzędna:**` w nagłówku.

## Rejestry na wiki: kotwice i odesłania (zasada, 2026-08-24)

Sprawdzone w boju na s62 przy rejestrze decyzji VCN, potwierdzone przez Grega. Dotyczy każdego rejestru pozycji numerowanych: decyzji, ustaleń audytowych, wymagań, pozycji do potwierdzenia.

### Zapis obowiązujący

**Rejestr to jedna tabela. Identyfikator pozycji stoi w pierwszej kolumnie jako nagłówek `<h3>` – i to on tworzy kotwicę.**

```

<table style="width:100%">

<tr><th style="width:6%">Nr</th><th style="width:9%">Data</th><th style="width:22%">Czego dotyczy</th><th style="width:57%">Treść</th><th style="width:6%">St.</th></tr>

<tr><td><h3>D24</h3></td><td>2026-08-03</td><td>Temat pozycji</td><td>Pełna treść</td><td>P</td></tr>

</table>

```

Odesłanie z dowolnego dokumentu: `[[Decyzje#D24|D24]]`, międzyprojektowo `[[vcn-robocze:Decyzje#D24|D24]]`. Link dowozi do konkretnego wiersza.

Trzy warunki, bez których to nie działa:

1. **Nagłówek zawiera wyłącznie identyfikator** (`D24`, `P-FIZ-03`), nigdy tytuł opisowy – kotwica powstaje z treści nagłówka, więc każda zmiana brzmienia zerwałaby wszystkie odesłania.

2. **Atrybutu `id` nie używamy** – jest zbędny (identyfikator i tak powstaje z treści) i bywa usuwany przy sanityzacji.

3. **Odwołania w tekście zawsze jako link**, nigdy jako goły kod – `D24` w treści dokumentu bez linku jest ślepym zaułkiem dla czytającego.

### Co nie działa

<table style="width:100%">

<tr><th style="width:30%">Zapis</th><th style="width:70%">Zachowanie</th></tr>

<tr><td><code><a id="D24"></a></code> w treści albo w komórce</td><td>znacznik usuwany przy renderowaniu, odesłanie ląduje na początku strony</td></tr>

<tr><td>kotwica w komórce bez nagłówka</td><td>brak celu, jak wyżej</td></tr>

</table>

### Czego już nie budujemy

Warianty „tabela plus pełne wpisy pod spodem" oraz „dwie strony: tabela i rejestr z nagłówkami" są śladem po nieudanych próbach z kotwicami HTML. Mnożą treść albo miejsca do otwierania, a nagłówek w komórce daje jedno i drugie naraz: **widok do skanowania i cel odesłania w tym samym wierszu**.

## Sesja przeglądarki a świeżość strony

Objaw z 2026-08-24: opublikowana strona nie pokazuje treści, mimo że raport publikacji potwierdza zapis, a historia strony ma nową wersję. Przyczyna nie leży po stronie skryptu ani cache przeglądarki – **pomaga wylogowanie i ponowne zalogowanie do Redmine**. Zanim zaczniemy szukać błędu w treści, sprawdzamy to jako pierwsze.

## Projekt roboczy obok klienckiego (wzorzec z 2026-08-23)

Klient nie ogląda wersji roboczych. Dlatego przy projektach, w których publikujemy treść merytoryczną do Redmine, obowiązuje **para projektów**:

<table style="width:100%">

<tr><th style="width:20%">Projekt</th><th style="width:35%">Widoczność</th><th style="width:45%">Rola</th></tr>

<tr><td><code><klient>-robocze</code></td><td>wyłącznie FB (prywatny)</td><td>wersja wstępna: przegląd, poprawki, praca nad treścią</td></tr>

<tr><td><code><klient></code></td><td>klient</td><td>treść zatwierdzona, do której klient ma dostęp</td></tr>

</table>

Przepływ: staging → projekt roboczy → **przegląd Grega** → dopiero stamtąd do projektu klienckiego. Publikacja do projektu klienckiego jest osobną decyzją, nie automatem.

Zastosowanie źródłowe: VCN – 14 obszarów SZBI z plików `00_Wprowadzenie.md` jako strony wiki; cel dodatkowy: pokazać klientowi, że cały SZBI da się prowadzić na Redmine, a co najmniej na wiki.

## Zasady twarde

1. **Ręczna zmiana w Redmine wygrywa tylko wtedy, gdy wróci do źródła.** Po ręcznym przypisaniu albo zmianie statusu: albo parkujesz staging w `wstrzymane\`, albo nanosisz zmianę w pliku. Inaczej kolejny przebieg przywróci stan z pliku.

2. **Mapowania są święte.** `mapowanie_<projekt>.json` i `mapowanie_gtasks_<projekt>.json` wiążą ID harmonogramu z numerami zgłoszeń. Skasowanie = duplikaty przy następnym przebiegu.

3. **Agent nie ma dostępu sieciowego do Redmine ani Google.** Kończy na stagingu; publikuje człowiek.

4. **Tracker podawaj jawnie** (lekcja 2026-08-23: 18 zgłoszeń wyszło jako „Uwaga ogólna").

5. **Nie publikuj zadań innych osób do swojej listy zadań** – od tego są flagi kanału.

## Google Tasks – uwagi

- Konfiguracja OAuth jednorazowa; poświadczenia w `%APPDATA%\FB\gtasks.cred`, szyfrowane DPAPI.

- Ekran zgody typu **Internal** (Greg jest administratorem Workspace) – bez testowych użytkowników i bez wygasania tokenu.

- **Google Tasks przyjmuje wyłącznie datę terminu, godzinę ignoruje** – zadanie ma dzień, spotkania mają godziny.

- Lista domyślna: `Fabryka` (parametr `-Lista`).

## Przypomnienia terminów

Redmine ma wbudowane `rake redmine:send_reminders days=N` – do wpięcia w cron na s62 (**[do zrobienia]**). To zdejmuje problem braku przypomnień bez dokładania kolejnego narzędzia.

## Numery i identyfikatory

<table style="width:100%">

<tr><th style="width:30%">Co</th><th style="width:70%">Wartość</th></tr>

<tr><td>Greg – użytkownik Redmine</td><td><strong>7</strong></td></tr>

<tr><td>Konto projektowe Akademii</td><td><strong>LAA2026 (#43)</strong></td></tr>

<tr><td>Projekt Akademii</td><td><code>laa-2026</code></td></tr>

<tr><td>Uczestnicy Akademii 2026-07</td><td>U1 – Cynamon 16, U2 – lukrak, U3 – GB</td></tr>

<tr><td>Identyfikatory projektów klienckich</td><td><strong>[do uzupełnienia przy pierwszym pushu]</strong> – skrypt zapyta i zapamięta</td></tr>

</table>