Bilko — Balkan Accounting SaaS
Cloud accounting for Balkan SMBs (Serbia, BiH, Croatia). Fiken-inspired.
Frontend
Next.js 15 frontend — pages, components, design system
Pages & Routing
Bilko Frontend Pages Framework: Next.js 15 (App Router) Current State: Fully implemented with moc...
State Management
Bilko State Management Current State: Primarily React hooks (useState, useEffect) Installed but M...
Frontend — Status & Architecture
Bilko Web — Next.js Frontend BookStack — Provjeri PRVO Prije traženja bilo čega — provjeri BookSt...
Component Inventory
Bilko Component Inventory Last Updated: 2026-02-20 Source of Truth: Filesystem scan of apps/web/c...
Design System
Bilko Design System Source: Extracted from apps/web/tailwind.config.ts + brand identity spec Desi...
Forms & Validation
Bilko Forms Documentation Current State: Native HTML forms with React state Validation: Client-si...
Design & Brand
Figma designs, logo, tokens, validation
Documentation Index
Bilko Documentation Index Last updated: 2026-02-20 Project ID: bbd77cc0 Status: Backend SPECIFIC...
Architecture
High-Level Design (HLD)
Bilko — High-Level Design (HLD) Version: 1.0 Date: 2026-02-23 Project ID: bbd77cc0 Status: Curren...
Low-Level Design (LLD)
Bilko — Low-Level Design (LLD) Version: 1.0 Date: 2026-02-23 Project ID: bbd77cc0 Status: Current...
Validation Report
Bilko Validation Report Date: 2026-02-20 Validator: John (AI Director) — Gate Validation Phase Pr...
Bilko — Project Handbook
Bilko — Balkan Accounting SaaS BookStack — Provjeri PRVO Prije traženja bilo čega — provjeri Book...
Pipeline Gate Tracker
Bilko Pipeline — 8-Gate Tracker Overview This document tracks Bilko's progress through the 8-gate...
ADR-022 — Document Archive Strategy
MC #100025 | Published 2026-05-08 | Status: Approved (Pattern 3 — Skybound) Related:...
SPEC-022 — Document Archive Implementation
MC #100025 | Published 2026-05-08 | Status: Approved (Pattern 3 — Skybound) Related:...
COMPLIANCE-022 — Archive Review (HIPAA/GDPR/CQC)
MC #100025 | Published 2026-05-08 | Status: Approved (Pattern 3 — Skybound) / Compliance g...
HR eRačun — Architecture Decision Record (ADR) + Build Plan
STATUS: design accepted; build in progress (WP1+). Production activation PARKED pending legal (B...
Backend
Backend — Target Architecture
Bilko API — Express Backend BookStack — Provjeri PRVO Prije traženja bilo čega — provjeri BookSta...
Database — Schema & Models
Bilko Database — Prisma + PostgreSQL BookStack — Provjeri PRVO Prije traženja bilo čega — provjer...
API Reference
Bilko API Reference Status: SPECIFICATION (backend not implemented) Base URL: http://localhost:4...
Database Schema
Bilko Database Schema Status: IMPLEMENTED (Prisma schema exists) Location: /Users/makinja/ALAI/p...
Authentication & Authorization
Bilko Authentication & Authorization Status: SPECIFICATION (backend not implemented) Last update...
Business Logic
Bilko Business Logic Status: SPECIFICATION (backend not implemented) Last updated: 2026-02-20 ...
Middleware Stack
Bilko Middleware Stack Status: SPECIFICATION (backend not implemented) Last updated: 2026-02-20 ...
External Services Integration
Bilko External Services Status: SPECIFICATION (backend not implemented) Last updated: 2026-02-20...
API Coverage Report
API Coverage Report Date: 2026-02-20 Purpose: Map every frontend page to required API endpoints. ...
Bilko Authentication -- Entra External ID (CIAM)
Overview Bilko uses Microsoft Entra External ID (CIAM) as its sole identity provider. Entra authe...
Bilko RBAC -- Users / Roles / Permissions
Overview Bilko uses a flat RBAC model: users have one role per organisation; roles map to a permi...
Bilko Auth Migration Runbook + Admin Guide
Scope This runbook covers: (1) how an operator bootstraps the first admin after legacy auth is re...
ADR-037 -- Entra Authenticates, Bilko Authorises; Single-Role v1; Multi-Org Deferred
ADR-037 — Entra Authenticates, Bilko Authorises; Single-Role v1; Multi-Org Deferred FieldValue ...
Bilko Self-Serve Trial — CIAM Architecture and Auth Pattern (MC #103232)
Bilko Self-Serve Trial — CIAM Architecture & Auth Pattern MC: #103232 | Status: LIVE — Proveo 11...
Bilko Self-Serve Trial — CIAM Architecture and Auth Pattern (MC #103232)
Bilko Self-Serve Trial — CIAM Architecture & Auth Pattern MC: #103232 | Status: LIVE — Proveo 11...
Testing & QA
Test Plan
Bilko — Test Plan Version: 1.0 Date: 2026-02-23 Project ID: bbd77cc0 Status: Current — reflects a...
Testing Guide
Bilko — Testing Guide Status: NO TESTS EXIST YET — This document defines the testing strategy for...
Test Inventory
Bilko — Test Inventory Status: NO TESTS EXIST YET — This document tracks planned tests and implem...
Infrastructure & DevOps
Deployment Guide
Bilko Deployment Guide Last Updated: 2026-04-16Current State: Stable Cloud Run deployment with cu...
CI/CD Pipeline
Bilko — CI/CD Pipeline Status: PLANNED (GitHub Actions workflows not yet configured) This documen...
Environment Configuration
Bilko — Development Environment Setup This guide walks through setting up a local development env...
Bilko Stage Environment — Cloud SQL & IAM (Phase 1)
SummaryMC #10177 Phase 1 (FlowForge, 2026-04-29): bilko-staging-db Cloud SQL instance brought und...
Bilko Stage Environment — Cloud Run Services (Phase 2)
Overview MC: #10177 Phase 2 | Deployed: 2026-04-30 | Git SHA: 1f48fdc | Status: LIVE, healt...
Bilko demo — receipt upload/download fix (GCS shared storage) — MC #103095 (2026-06-07)
1. SymptomCEO reported that receipt upload (PNG, PDF, JPG) was not working — a central part of th...
Bilko Azure Observability + MS for Startups Credit Setup (2026-06-15)
Purpose Cross $100/month in foundational Azure spend to automatically unlock the Microsoft for S...
Bilko ACA Telemetry & Observability Wiring (Azure)
ContextGCP Cloud Monitoring dashboard (070613fa) was decommissioned 2026-06-23 after migration to...
Regulatory
Serbia — Regulatory Summary
Serbia (RS) Regulatory Requirements Overview Country Code: RS Currency: RSD (Serbian Dinar) EU S...
Bosnia — Regulatory Summary
Bosnia & Herzegovina (BA) Regulatory Requirements Overview Country Code: BA Currency: BAM (Conve...
Croatia — Regulatory Summary
Croatia (HR) Regulatory Requirements Overview Country Code: HR Currency: EUR (adopted January 20...
Multi-Region Overview
Multi-Region Accounting Standards Overview Source: Research report /Users/makinja/system/reports/...
Chart of Accounts (All Countries)
Unified Chart of Accounts Reference Last Updated: 2026-02-20 Purpose: Cross-country comparison an...
Serbia — SEF e-Invoicing
Serbia — Sistem Elektronskih Faktura (SEF) Last Updated: 2026-02-20 Confidence Level: HIGH (verif...
Bosnia — PDV System
Bosnia & Herzegovina — PDV (Porez na dodatu vrijednost) Last Updated: 2026-02-20 Confidence Level...
Croatia — eRačun & HR-FISK
Croatia — eRačun and Fiscalization (Fiskalizacija) Last Updated: 2026-02-20 Confidence Level: HIG...
Bilko HR eRačun — sveRačun (PostLink) Integration & Status Model
OverviewProvider: sveRačun by PostLink d.o.o. (Velika Gorica, HR).Contact: David Krišto david.kri...
Bilko B5 — Per-Line VAT Exemption Classification (MC #103593, 2026-06-15)
Context & DecisionDate: 2026-06-15 | MC: #103593 | Decision authority: CEO (Alem Basic)Domain...
Security & Compliance
Security architecture, RBAC, encryption, GDPR compliance
Security Architecture
Bilko — Security Architecture Status: PLANNED (backend not built yet, security measures documente...
GDPR & Compliance
Bilko — Regulatory Compliance Status: NOT COMPLIANT — Requires legal review and implementation (P...
Bilko CIAM abuse-gate fix — checkBefore moved outside SERIALIZABLE tx (MC #104069, root-cause of #103245)
Bilko CIAM abuse-gate fix — checkBefore moved outside SERIALIZABLE txMC #104069 | Root-cause of M...
Bilko demo — reverse-engineering + feature list + live Playwright test (MC #102883) — 2026-06-03
Summary MC #102883 reverse-engineered the Bilko demo product from existing code into a full spec ...
Bilko ADR-016: E-Invoice Adapter
Author: ALAI, 2026ADR-016: E-Invoice Adapter & UBL 2.1 Canonical Model Status: Accepted Date: 20...
Bilko ADR-015: Four-Jurisdiction Plugin
Author: ALAI, 2026# ADR-015: Four-Jurisdiction Plugin Architecture **Status:** Accepted **Date:*...
Bilko ADR-016: E-Invoice Adapter
Author: ALAI, 2026# ADR-016: E-Invoice Adapter & UBL 2.1 Canonical Model **Status:** Accepted **...
Bilko ADR-017: RLS Multi-Tenancy
Author: ALAI, 2026# ADR-017: RLS Multi-Tenancy Migration **Status:** Accepted **Date:** 2026-04-...
Bilko ADR-018: Market vs Locale
Author: ALAI, 2026# ADR-018: Market vs Locale Separation **Status:** Accepted **Date:** 2026-04-...
ADR-019: Integration Adapter Registry
ADR-019: Integration Adapter Registry Status: Accepted Date: 2026-04-21 (Updated: 2026-04-22) Aut...
Bilko CEO Decision: Croatia Peppol (Option B)
Author: ALAI, 2026# CEO Decision: Croatia Peppol Strategy — Option B (Storecove/Pagero Routing) ...
Bilko CEO Decision: Serbia Admin via ALAI Tech
Author: ALAI, 2026# CEO Decision: Serbia Admin Registrations via ALAI Tech d.o.o. **Date:** 2026...
Bilko Phase 1 Track A — Execution Record
Author: ALAI, 2026# Bilko Phase 1 Track A — Kotlin Interface Scaffolding (Execution Record) **Au...
Bilko SEF Adapter — Reference Implementation
$(cat /tmp/sef-adapter-page.html | jq -Rs .)
Bilko Storecove HR Adapter — Peppol Option B Implementation
$(cat /tmp/storecove-hr-page.html | jq -Rs .)
Bilko Flyway Baseline Strategy
$(cat /tmp/flyway-baseline-page.html | jq -Rs .)
Bilko Phase 1 Track B — Execution Record
$(cat /tmp/phase1b-execution-page.html | jq -Rs .)
Set-Cookie Cross-Origin Regression — RCA + Fix Pattern
Bilko Set-Cookie Cross-Origin Regression — RCA + Fix Pattern MC: #9499 (final fix), #9495 (canary...
Legal & Compliance
Bilko Terms of Service (with Sub-Processor disclosure GDPR Art. 28(4))
⚠️ DRAFT — pending final legal sign-off and translations (per Lexicon notes). MC #100045. 2026-05...
Bilko Privacy Notice (with Document Archive Sub-Processors §8.1)
⚠️ DRAFT — pending final legal sign-off and translations (per Lexicon notes). MC #100045. 2026-05...
DPA Template — Vedlegg B / Annex B: Sub-Processors for Bilko Archive Feature
⚠️ DRAFT — pending final legal sign-off and translations (per Lexicon notes). MC #100045. 2026-05...
Sub-Processor Notification Email Template (Bilko)
⚠️ DRAFT — pending final legal sign-off and translations (per Lexicon notes). MC #100045. 2026-05...
MC #100173 — Bilko Landing Pages UX Audit & Compliance Fixes
MC #100173 — Bilko Landing Pages UX Audit & Compliance Fixes (2026-05-09) Mission Control ID: #10...
FISK 2.0 Path Decision Research — 2026-05-10
Bilko HR FISK Research 2026-05-10 MC #8207 — Path Decision Data Test file to confirm writes work....
MC 102165 — Bilko PR #186 Deploy Evidence
Bilko PR #186 deploy evidence — MC #102165 Generated: 2026-05-26T15:30Z Source PR #186: https://...
MC 102233 102335 — Bilko HR demo currency, sent-state, pricing memo
Bilko HR demo — currency/accounting + sent/pricing/contact memo Date: 2026-05-21 MC: #102233 / #1...
Bilko demo — 7 real-user bug fixes + live verification (MC #102887) — 2026-06-04
Summary CEO smoke-tested the live Bilko demo and found real bugs in minutes that the prior Phase-...
Bilko Demo Event-Loop Freeze — Root Cause, Fix & Hardening (2026-06-08, MC #103134)
Bilko Demo Event-Loop Freeze — Root Cause, Fix & Hardening (2026-06-08, MC #103134) 1. Incident ...
Bilko Demo Event-Loop Freeze — Root Cause, Fix & Hardening (2026-06-08, MC #103134)
Bilko Demo Event-Loop Freeze — Root Cause, Fix & Hardening (2026-06-08, MC #103134) 1. Incident ...
Bilko Environment Topology — Corrected Canonical Reference (2026-06-09)
Bilko Environment Topology — Corrected Canonical Reference As of: 2026-06-09 | Authority: MC #103...
Bilko Infrastruktura — objašnjeno jednostavno (za CEO) — 2026-06-09
Bilko Infrastruktura — objašnjeno jednostavno (za CEO) Verzija 2026-06-09. Cilj: da za 5 minuta r...
Bilko Observability (GCP-native) 2026-06-10
Status LIVE and Proveo-verified as of 2026-06-10. GCP project tribal-sign-487920-k0, region europ...
Bilko Sentinel — Tier-0 Self-Healing Agent 2026-06-10
Status LIVE and Proveo-verified as of 2026-06-10. MC #103337 (AgentForge implementation) + MC #10...
Bilko Prod Topology — app.bilko.cloud Cutover (reuse-demo-as-prod)
Bilko Prod Topology — app.bilko.cloud Cutover (reuse-demo-as-prod) MC: #103300 | Completed: 20...
Bilko Sentinel — Tier-1 Bounded Auto-Remediation (Shadow-First) 2026-06-11
Status BUILT — SHADOW mode. MC #103435 (AgentForge build) + MC #103436 (Securion adversarial revi...
Bilko Observability & Self-Healing — Program Overview (MC #103328)
Bilko Observability & Self-Healing — Program Overview (MC #103328) This is the single entry poin...
Bilko Security & Engineering Decisions (Observability Program)
Bilko Security & Engineering Decisions (Observability Program) This page covers security finding...
Bilko Backoffice — Support & Fix Loop Runbook
Bilko Backoffice — Support & Fix Loop Runbook Scope: Operational runbook for ALAI staff handling...
Bilko Signup Jurisdiction Fix — MC #103501
Bilko Signup Jurisdiction Fix — MC #103501 Status: Branch-verified only. Merge, stage deploy, an...
Bilko Modul B (Knjigovodstvo) — Spec + Board presuda (2026-06-13)
TL;DR — 4/4 CONDITIONAL GO (jednoglasno). Modul B = dovršenje Modula A, ne ekspanzija. Četiri ...
Bilko Modul B-1 — GL Foundation Build (2026-06-13)
TL;DR Bilko Modul B-1 GL Foundation je KOMPLETAN. Backend (commit 6efb16f9) + frontend (commit...
Bilko GCP→Azure Brand Domain Cutover (2026-06-15) — MC #103633
Bilko GCP→Azure Brand Domain Cutover (2026-06-15) — MC #103633 Context Trigger: GCP billing d...
Bilko Azure IaC — Terraform azurerm (rg-bilko-demo)
Bilko Azure IaC — Terraform azurerm (rg-bilko-demo) MC: #103720 (child of #103715) Status: Conve...
Bilko Customer Funnel Architecture
Bilko Customer Funnel Architecture Context: This page documents the customer acquisition funnel ...
Bilko Add-On Catalog & Pricing Model (2026-06-19, CEO-approved)
Bilko Add-On Catalog & Pricing ModelCEO-Approved 2026-06-19 | MC #103934, Parent #103917Executive...
Bilko HR e-Račun Archive — GCS→Azure Blob Migration (2026-06-22)
Bilko HR e-Račun Archive — GCS→Azure Blob Migration (2026-06-22) Overview MC: #104172 T3 (build)...