Leverandørvakt
Under utviklingEn varslingstjeneste for norske virksomheter, bygget på åpne data fra Brønnøysundregistrene. Brukerne følger selskapene de jobber med og får beskjed når noe viktig endrer seg.
Startet: 8. november 2026
- Node.js
- TypeScript
- Express 5
- PostgreSQL
- Sequelize
- Umzug
- JWT
- Swagger
Hvorfor jeg bygger det
Små bedrifter merker sjelden at en leverandør eller kunde er i trøbbel før en faktura ikke blir betalt. Det offentlige registeret viser allerede varselsignalene: ny daglig leder, endringer i styret, forsinket årsregnskap eller åpning av konkurs. Leverandørvakt følger med på disse signalene, så brukeren slipper.
Veikart
49 / 54 milepæler ferdigFra prosjektets README · på engelsk
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) requireAuthmiddleware for protected endpointsGET /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 pulland 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