VanaDash
The internal back office of Vanadium Systems, a one-person software
company in Romania: invoicing, bank reconciliation, email, team chat, calendar, CRM and server
monitoring in a single app, on a single small VPS. It runs in production every day.
The source is public so you can read it, run it and send changes. It is source-available, not
open source: see License.
What's inside
| Module | What it does | Scope |
|---|
| Invoices | Issues and numbers invoices, renders PDF and UBL XML, tracks payment | Romania-specific |
| e-Factura / SPV | Sends issued invoices to ANAF, pulls received ones, reads SPV messages | Romania-specific |
| Declarations | Builds the D301 and D390 VAT declarations and a quarterly package | Romania-specific |
| Contracts | Editable contract templates, addenda, digital signature placement | Romanian contract text |
| Reconciliation | Imports bank transactions (Revolut Business) and matches them to invoices | Country-neutral |
| Financials | Profit and loss, cash flow, monthly reports; EUR/USD rates from the BNR | BNR feed is Romania-specific |
| Clients | Prospect list with scoring, a price calculator, promotion to client | Country-neutral |
| Tenders | Watches the Romanian public procurement portal (SICAP) for matching notices | Romania-specific |
| Email | Shared mailboxes, threads, templates, bulk sends, drip sequences | Country-neutral |
| Messages | Direct and group chat in real time, attachments, presence | Country-neutral |
| Calendar | Per-person calendars, sharing, common events, public booking | Country-neutral |
| Archive | Per-person file spaces on object storage, folder sharing | Country-neutral |
| Notes, Plan, Wishlist | Personal notes and goals | Country-neutral |
| Platforms, Alerts | Pulls KPIs from other products through connectors; threshold alerts | Country-neutral |
| Team, Modules, History | Invitations, roles, a feature catalog switched on per role, audit log | Country-neutral |
| Support, Guides, Updates | Tickets to the operator, per-page guides, release notes | Country-neutral |
| Assistant | An in-app assistant that can read what the user can read | Country-neutral |
There is also a thin Android shell (Capacitor) that loads the web app and receives push
notifications.
Why it is built this way
Everything follows from three facts: one developer, one VPS with 1 vCPU and 2 GB of RAM, one
company registered in Romania.
So there is one process and one database: Fastify, Drizzle and PostgreSQL, a React SPA, Docker
Compose. No queue, no cache server, no microservices. Chat runs over server-sent events with an
in-memory bus, which is enough for one container. Aggregation happens in SQL, not in JavaScript
over large arrays.
Romania comes first because that is where the invoices are. e-Factura is mandatory here, so the
ANAF connector, the UBL builder and the VAT declarations came early and are thorough. The app
exists because of them.
Connectors keep the country-specific parts at the edge. The tax authority, the bank and external
products each sit behind an interface in backend/src/connectors, and
nothing outside that folder knows which platform it is talking to.
Access is a catalog, checked at startup. Every route must resolve to exactly one feature in
features.ts or be declared self, public or machine.
A route that does not resolve stops the server from starting, and so does one registered without
authentication and not declared public. A new endpoint cannot ship unguarded by accident.
It serves a single company, so there is no tenant isolation. Roles and features decide what each
colleague sees.
Adapting it to another country
The neutral modules work as they are. To use the money side elsewhere you would replace:
- the accounting connector (
connectors/anaf) with your tax
authority's e-invoicing API, or none;
- the declaration builders (
connectors/anaf/declarations);
- the exchange-rate source (
shared/lib/bnr.ts);
- the contract templates, which are Romanian legal text.
Start with docs/CONNECTOR_GUIDE.md. Pull requests are not accepted
for now (see CONTRIBUTING.md), but an issue saying which country you need helps.
Run it locally
You need Docker, Node 22+ and pnpm 9+.
git clone https://github.com/Vanadium-Systems/vana-dash.git
cd vana-dash
pnpm install
cp .env.example .env
Set the three required values in .env:
ADMIN_PASSWORD= # at least 12 characters
JWT_SECRET= # openssl rand -base64 48
MASTER_ENCRYPTION_KEY= # openssl rand -hex 32
Then:
./dev start # postgres, backend on :3001, frontend on :5174; migrates and seeds
./dev db seed:demo en # optional: invented clients, invoices, prospects, messages (en or ro)
Open http://localhost:5174 and sign in with ADMIN_EMAIL and ADMIN_PASSWORD from .env.
The first start takes a couple of minutes because the containers install their dependencies.
The demo seed also switches off the scheduled jobs that poll Romanian public sources (BNR
exchange rates, the SICAP procurement portal) and the bank. Without it they are on; turn them
off under Settings if you do not need them.
./dev help lists the other commands (stop, logs, reset, db migrate). Every integration
in .env.example is optional: left empty, that feature is off and the rest works.
The checks that must pass before a change is merged:
pnpm typecheck && pnpm lint && pnpm test && pnpm build
The backend tests run against the local PostgreSQL from ./dev start.
Status
In production since mid-2026, used daily by its author and a few colleagues.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
