In Arbeit

Projekte, an denen ich gerade arbeite. Die Roadmap zeigt, was fertig ist und was als Nächstes kommt, und wird mit dem Fortschritt aktualisiert.

Leverandørvakt

In Entwicklung

Ein Frühwarndienst für norwegische Unternehmen, basierend auf offenen Daten des Brønnøysund-Registerzentrums. Nutzer folgen den Firmen, mit denen sie arbeiten, und werden benachrichtigt, wenn sich etwas Wichtiges ändert.

Begonnen: 8. November 2026

  • Node.js
  • TypeScript
  • Express 5
  • PostgreSQL
  • Sequelize
  • Umzug
  • JWT
  • Swagger

Warum ich es baue

Kleine Unternehmen merken oft erst dann, dass ein Lieferant oder Kunde in Schwierigkeiten ist, wenn eine Rechnung unbezahlt bleibt. Das öffentliche Register zeigt die Warnsignale bereits: ein neuer Geschäftsführer, Änderungen im Vorstand, verspätete Jahresabschlüsse oder die Eröffnung eines Insolvenzverfahrens. Leverandørvakt beobachtet diese Signale, damit der Nutzer es nicht tun muss.

Roadmap

49 / 54 Meilensteine erledigt

Aus der README des Projekts · auf Englisch

Foundation

  • Express 5 + TypeScript project setup
  • Brønnøysund API integration: lookup by organization number and search by name
  • Layered architecture: routes, controllers, services, mappers
  • Swagger / OpenAPI documentation
  • PostgreSQL connection with Sequelize
  • Versioned migrations with Umzug, applied on startup

Authentication and users

  • User registration and login (bcrypt + JWT)
  • Internal ID + public UUID, roles (user / admin)
  • requireAuth middleware for protected endpoints
  • GET /api/auth/me — current user's profile
  • Getting-started steps and closing the list (/api/auth/me/onboarding)
  • Admin account created once on startup from environment variables

Watchlist and change detection

  • Data model design: companies, watchlist_entries, company_changes
  • Add and remove companies from a user's watchlist
  • Scheduled change detection using the Brønnøysund update feeds (companies and roles)
  • Change history per company
  • Notifications for followed companies

Testing and CI

  • Test setup: Vitest + Supertest with a separate test database
  • Fake Brønnøysund API for tests, so the suite never depends on the network
  • Tests for auth, companies, watchlist, change detection, role changes, annual accounts, risk signals, notifications, the AI assistant and admin
  • GitHub Actions CI: type check and tests on every push

Company data

  • Roles: CEO and board changes from the Brønnøysund roles API
  • Annual accounts: key figures from the Register of Company Accounts
  • Annual accounts: storing every filing, detecting new filings and warning signs
  • Ownership service: separate Python ETL for Skatteetaten shareholder data

Insights

  • Role network: shared people and audit firms across your companies, matched on name and birth date without storing them
  • Risk signals: explainable assessment, stored levels and early warning
  • Regional trends: new registrations by month, municipality, industry and form, with industry breakdowns

AI

  • AI assistant with tool calling, using the existing service functions

Delivery

  • Docker Compose for local development
  • Docker Compose for servers, behind Cloudflare Tunnel, with nightly database backups
  • Production on a netcup VPS (Debian, Docker Compose), deployed manually with git pull and a rebuild
  • Email from its own domain (Resend, verified with DKIM)
  • Automatic deployment from GitHub Actions after CI passes
  • Staging on a home server
  • Off-site backups
  • Usage guide with scenarios

Web app

  • Next.js app with a Designsystemet theme, light and dark mode, English and Norwegian
  • Landing page, log in and create account, with the token kept on the server (BFF)
  • App header with menu, user menu and a notification bell
  • Overview, watchlist, search and company pages (overview, roles, accounts, risk, changes)
  • Charts: annual accounts per year, new companies per month
  • Trends with municipality, industry, form and period filters
  • Assistant and notifications pages
  • About and contact pages
  • Admin page
  • In-app guide and a getting-started checklist
  • End-to-end tests (Playwright) and the web app in CI and Docker Compose
  • Company report to print or save as PDF, Excel and CSV exports of the watchlist and its changes

Production readiness

  • Limits on login and registration attempts, security headers
  • Password reset by email
  • Account settings: changing the password, downloading your data and deleting the account (GDPR)
  • Email notifications: critical changes at once, the rest as a daily summary
  • Logging and error alerts
Quellcode