MonoPilot Kira

Repozytorium produktu MonoPilot MES — multi-tenant Manufacturing Execution System dla zakładów produkcji spożywczej.

---

Struktura repozytorium

monopilot-kira/
├── README.md               ← ten plik
├── .env.example            ← zmienne środowiskowe
│
├── prototypes/             ← wszystkie prototypy UI i moduły produktu
│   ├── colors_and_type.css ← tokeny design systemu
│   ├── components.html     ← komponenty desktop
│   ├── patterns.html       ← wzorce layoutu
│   ├── scanner-kit.html    ← komponenty mobile/dark
│   ├── example-screen.html ← przykładowy ekran
│   ├── MONOPILOT-SITEMAP.html
│   ├── SCANNER-PROTOTYPE (2).html
│   ├── auth/
│   ├── dashboard/
│   ├── design/             ← UX specs per moduł
│   ├── npd/ · settings/ · technical/ · planning/ · planning-ext/
│   ├── warehouse/ · scanner/ · production/ · quality/ · finance/
│   ├── reporting/ · maintenance/ · multi-site/ · oee/
│   ├── screenshots/
│   └── uploads/
│
├── docs/                   ← dokumentacja projektu
│   ├── prd/                ← Product Requirements Documents (00–15)
│   ├── BACKLOG.md
│   ├── SKILL.md
│   ├── TUNING-PATTERN.md
│   └── ...
│
├── _meta/                  ← planowanie, atomic-tasks, audyty, decyzje
├── _foundation/            ← ADR-y, architektura, skill registry
├── _shared/                ← wspólne komponenty (modals, primitives, CSS)
└── _archive/               ← archiwum

---

Kontekst produktu

Co to jest MonoPilot. Przeglądarkowy MES obejmujący pełny cykl produkcyjny: Technical (produkty, BOM, routing), Planning (dostawcy, PO, WO, MRP), Production (realizacja WO, wydajność, odpady), Warehouse (LP tracking, GRN, przesunięcia), Scanner (mobilna aplikacja dla operatorów), Quality (specyfikacje, blokady, NCR, HACCP), Shipping (SO, picking, pakowanie) + dodatki premium: NPD, Finance, OEE, Reporting, Multi-Site, Maintenance.

Kto używa.

• Desktop — kierownicy, planiści, QA, technolodzy, kupcy. Sidebar + gęste tabele + dashboardy KPI. Jasny motyw.
• Skaner mobilny — operatorzy na hali, magazynierzy. Duże strefy dotykowe, skanowanie kodów, jeden przepływ na ekran. Ciemny motyw.

Tenants. Pierwszy tenant: Apex (mleczarnia). System jest white-label.

---

Jak korzystać z prototypów

1. Otwórz prototypes/colors_and_type.css — wszystkie tokeny (kolory, typografia, spacing).
2. Desktop: prototypes/components.html + prototypes/patterns.html.
3. Mobile/scanner: prototypes/scanner-kit.html.
4. Pełne widoki: prototypes/MONOPILOT-SITEMAP.html (każdy ekran) lub prototypes/SCANNER-PROTOTYPE (2).html.

---

Local Development

If stale Supabase cookies or bearer headers block local pages while no local Supabase JWKS endpoint is running, set DEV_AUTH_BYPASS=true in .env.local and restart the Next.js dev server. The flag only accepts the literal string true, is ignored when NODE_ENV=production, and bypasses only page-routing middleware auth; next-intl routing and Server Action/API authorization still run normally.

---

PRD-y

Wszystkie Product Requirements Documents w docs/prd/ — od docs/prd/00-FOUNDATION-PRD.md do docs/prd/15-OEE-PRD.md.