open-crm

• Node.js 20 LTS eller senare
• npm 10 eller senare
• Git
• macOS 12+, Windows 10+ eller Linux (Debian/Ubuntu rekommenderas)
• Minimum 4 GB RAM, 2 GB ledigt diskutrymme

Alla tre webbappar är Next.js-projekt och kan hostarnas på valfri plattform som stöder Node.js — Vercel, Railway, en egen VPS eller liknande. De kräver Node.js 20+ och delar Supabase-databasen med Desktop CRM.

open-crm använder Supabase (hanterad PostgreSQL) som databas. Supabase Cloud med gratis tier räcker för de flesta installationer. Självhostad Supabase stöds också — se supabase.com/docs/guides/self-hosting för instruktioner.

Skapa filen .env i projektets rot. Alla fyra variabler krävs:

SUPABASE_URL=https://<ditt-projekt-ref>.supabase.co
SUPABASE_ANON_KEY=<din-anon-nyckel>
SUPABASE_SERVICE_KEY=<din-service-nyckel>
SUPABASE_ACCESS_TOKEN=<din-personal-access-token>

Var du hittar nycklarna:

• SUPABASE_URL och ANON_KEY: supabase.com → ditt projekt → Settings → API → Project URL / anon key
• SUPABASE_SERVICE_KEY: samma sida → service_role key (håll hemlig, används bara server-side)
• SUPABASE_ACCESS_TOKEN: supabase.com/dashboard/account/tokens → "Generate new token"

npm run dev

Electron-fönstret öppnas automatiskt med hot-reload. Vid första start körs databasmigreringar automatiskt — tabeller skapas i din Supabase-instans utan manuella steg.

npm run build
# Output: /dist/<platform>/

Bygg genererar en installationsfil per plattform — .dmg för macOS, .exe för Windows och .AppImage / .deb för Linux.

• Namn, organisationsnummer (valfritt)
• Primär kontaktperson: namn, e-post, telefon
• Faktureringsadress
• Anteckningar (fritext)
• Status: Aktiv / Inaktiv

• Skapa ny kund — fyll i formuläret via "Ny kund"-knappen
• Redigera kontaktuppgifter direkt i detaljvyn
• Se alla projekt, offerter och fakturor kopplade till kunden
• Bjud in kunden till Kundportalen (se Kundportal-sektionen)

• Titel och beskrivning
• Kopplad kund
• Status och startdatum / beräknat slutdatum
• Budgetbelopp (SEK inkl. moms)
• Intern anteckning

Händelser som passerat datum och inte markerats som slutförda (och inte är återkommande) visas automatiskt i nuvarande vecka. Historiken är oföränderlig — händelserna visas i dag men ändrar inte ursprungsdatum.

Tidplanen visar ett projekts faser och milstolpar i en horisontell tidslinje. Varje fas kan ha ett start- och slutdatum och kopplas till Kalenders händelser. Tidplan är per projekt — välj projekt i dropdown för att se dess plan.

Ett förslag byggs upp av faser — t.ex. "Rivning", "Stomme", "Ytskikt". Varje fas innehåller rad-för-rad specificerade arbets- och materialkostnader. Systemet beräknar automatiskt delsummor, moms och ROT-avdrag.

Swedish ROT-avdrag (30 % skatteåterbäring för hushållsarbeten) hanteras per rad. Markera vilka rader som kvalificerar — totalen justeras automatiskt och visas separat i PDF-offerten.

Via AI Workflows-modulen kan du automatisera offertskrivning baserat på projektbeskrivning och historik. Systemet genererar ett utkast som du sedan justerar manuellt.

• Utkast — redigeras och förfinas internt
• Skickad — offerten har levererats till kunden
• Signerad — kunden har signerat digitalt
• Avvisad — kunden har avböjt

1. 1

   Öppna förslaget

   Gå till Förslag och öppna det aktuella förslaget.

2. 2

   Skicka för signering

   Klicka "Skicka för signering". Systemet genererar en unik URL och skickar ett e-postmeddelande till kundens e-postadress med en länk.

3. 3

   Kunden signerar

   Kunden öppnar länken i Signeringsportalen, granskar offerten och klickar "Signera". Ingen inloggning krävs.

4. 4

   Arkivering

   Signaturen stämplas med tidsstämpel, IP-adress och kryptografisk hash. PDF-dokumentet arkiveras och skickas automatiskt till båda parter.

5. 5

   Status uppdateras

   Förslaget markeras automatiskt som "Signerat" i Desktop CRM.

• Utkast — skapas och redigeras internt
• Godkänd — internt godkänd för beställning
• Skickad — beställning skickad till leverantör
• Levererad — material/tjänst mottagen
• Avbruten — order ej genomförd

ÄTA-poster skapas när kunden beställer arbeten utanför den ursprungliga offerten. Varje ÄTA kopplas till ett projekt och innehåller beskrivning, timmar/material och pris. ÄTA-poster kan faktureras separat eller samlas till en slutfaktura.

Kostnadsmodulen separerar arbets- och materialkostnader. Varje post kopplas till ett projekt och eventuellt till en fas i Tidplanen.

• Arbetskostnad: antal timmar × timpris per resurs
• Materialkostnad: antal × enhetspris per artikel
• ROT-markering per post
• Automatisk summering mot projektets budget

Tabeller: arbetskostnad, materialkostnad

Fakturamodulen hanterar utgående fakturor. Fakturor kopplas till projekt och kan innehålla rader från kostnader, ÄTA eller manuellt tillagda poster.

• Status: Planerad → Skickad → Betald / Förfallen
• Förfallodatum med automatisk påminnelseflagga

Tabell: fakturor · IPC: db:fakturor:list

Kvittomodulen tar emot inkommande kvitton (inköp, utlägg) och kopplar dem till projekt och kostnadsrader. Kvitton kan importeras som bild och matchas mot befintliga materialkostnadsposter.

Den inbyggda e-postmodulen är en fullständig inkorg integrerad via Zoho Mail. Meddelanden kopplas automatiskt till rätt kund och projekt baserat på avsändarens e-postadress.

• Läs, svara och skicka e-post direkt i appen
• Automatisk kundkoppling baserat på avsändar-epost
• Anpassningsbara mallar för offerter, fakturabekräftelser och uppföljningar
• SMTP-stöd för alternativa e-postleverantörer

Chattfunktionen är ett internt kommunikationsverktyg för teamet. Den är tillgänglig både i Desktop CRM och i Remote-appen, vilket gör att kontor och fältpersonal kan kommunicera i samma kanal.

• Projektkanaler — ett chattrum per projekt
• Direktmeddelanden mellan teammedlemmar
• Olästa meddelanden visas som badge i sidomenyn
• Medarbetare med status "Inaktiv" döljs från chattlistan

Personalregistret samlar alla medarbetare med roller, kontaktuppgifter och tillgänglighet. Personaldata synkroniseras med Kalender och Remote-appen.

• Roller: Admin, Projektledare, Tekniker, Fältpersonal
• Status: Aktiv / Inaktiv (inaktiva döljs i chatt och kalender)
• Tilldelning av händelser i Kalender
• Åtkomst till Remote-appen konfigureras här (se Remote → Autentisering)

Tabell: personal · IPC: db:personal:list

Leverantörsregistret lagrar kontaktuppgifter för underleverantörer och materialleverantörer. Leverantörer kopplas till order och materialkostnadsposter.

• Namn, organisationsnummer, kontaktperson
• E-post och telefon
• Koppling till order och materialposter

Tabell: leverantorer · IPC: db:leverantorer:list

• Anthropic Claude (Haiku, Sonnet, Opus) — rekommenderas för offertgenerering
• OpenAI GPT-4 / GPT-4o
• Google Gemini Pro

NEXT_PUBLIC_SUPABASE_URL=https://<ditt-projekt-ref>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<din-anon-nyckel>

Remote använder bara ANON_KEY med RLS-policys för åtkomststyrning. Ingen service key exponeras i webbappen.

1. 1Öppna Desktop CRM → Inställningar → Personal
2. 2Välj medarbetaren och aktivera "Åtkomst till Remote"
3. 3Ange medarbetarens e-postadress (samma adress de använder för att logga in)
4. 4Spara — systemet skapar automatiskt en post i app_admins
5. 5Medarbetaren får ett välkomstmejl med inloggningslänk

Fältpersonalen ser sin personliga veckokalender med alla händelser tilldelade till dem. Händelser kan markeras som slutförda direkt från telefonen.

Samma chattfunktion som i Desktop CRM — projektkanaler och direktmeddelanden. Olästa meddelanden visas som badge vid ikonen. Medarbetare med status "Inaktiv" döljs från chattlistan.

En förenklad kundöversikt för att snabbt hitta kontaktuppgifter och projektadress ute på fältet. Redigering sker i Desktop CRM.

Teamöversikt med tillgänglighet och kontaktuppgifter. Synkroniseras i realtid med Desktop CRM.

1. 1Öppna Desktop CRM → Personal
2. 2Skapa eller välj medarbetaren
3. 3Ange e-postadress och aktivera "Åtkomst till Anställdapp"
4. 4Medarbetaren får ett välkomstmejl med länk för att sätta lösenord
5. 5Vid första inloggning väljer medarbetaren sitt föredragna språk

Den anställde ser sina tilldelade händelser från Kalendermodulen i Desktop CRM — uppgifter, besök och leveranser för dag och vecka. Vyn är avsiktligt enkel: datum, tid, plats och beskrivning.

Uppgifter kan markeras som påbörjade eller slutförda direkt i appen. Statusen synkroniseras i realtid till Desktop CRM och syns i Kalendermodulen.

Samma chattinfrastruktur som Desktop CRM och Remote — projektkanaler och direktmeddelanden. Den anställde ser bara kanaler kopplade till projekt de är tilldelade.

Gränssnittet detekterar automatiskt webbläsarens språk och väljer bland SV, EN, ES och PL. Den anställde kan byta språk manuellt i inställningar. All affärsdata (kundnamn, projektnamn) visas som den lagrats — ingen maskinöversättning av innehåll.

1. 1Öppna Desktop CRM → Kunder → Välj kunden
2. 2Klicka "Bjud in kund till portal"
3. 3Ange kundens e-postadress
4. 4Systemet skapar en post i kund_users och skickar ett inbjudningsmejl
5. 5Kunden klickar länken i mejlet och sätter ett lösenord

Kunden ser alla sina projekt med status, tidslinje och kortfattad beskrivning. Projektdetaljer uppdateras i realtid från Desktop CRM.

Kunden kan läsa fullständiga offertdokument i portalen och välja att godkänna eller avvisa. Godkännande i portalen skickar kunden till Signeringsportalen för digital underskrift.

Direkt kommunikation mellan kund och företag via ett inbyggt meddelandesystem. Meddelanden från portalen visas i Desktop CRM under kundens profil.

NEXT_PUBLIC_SUPABASE_URL=https://<ditt-projekt-ref>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<din-anon-nyckel>
SUPABASE_SERVICE_ROLE_KEY=<din-service-role-nyckel>

Signeringsportalen kräver SERVICE_ROLE_KEY för server-side PDF-generering och signaturstämpling — nyckeln exponeras aldrig i klientkoden.

1. 1

   Desktop CRM genererar länk

   Administratören klickar "Skicka för signering" på ett förslag. Systemet genererar en unik URL med begränsad giltighetstid och skickar ett e-postmeddelande till kundens adress.

2. 2

   Kunden öppnar länken

   Signeringsportalen laddar offertdokumentet från länkens token. Ingen inloggning krävs. Länken kan bara användas en gång.

3. 3

   Granskning

   Kunden läser igenom offerten med alla faser, rader och priser. Dokumentet kan scrollas och zoomstas.

4. 4

   Digital signatur

   Kunden klickar "Signera" och bekräftar sitt namn. Inga plugin, inga certifikat — signaturens autenticitet garanteras av systemets metadata.

5. 5

   Stämpling & arkivering

   Signaturen stämplas med exakt tidsstämpel (UTC), kundens IP-adress och en kryptografisk hash av dokumentinnehållet. PDF genereras och arkiveras.

6. 6

   Bekräftelse till båda parter

   Det signerade PDF-dokumentet skickas automatiskt till kundens och företagets e-postadress. Förslaget uppdateras till status "Signerat" i Desktop CRM.

Signeringslänkar har en konfigurerbar TTL (time-to-live). Standardvärdet är 72 timmar. Om länken löper ut utan signering kan administratören generera en ny från samma förslag i Desktop CRM — det ursprungliga dokumentet ändras inte.

När signaturlänken genereras beräknas en SHA-256-hash av offertdokumentets innehåll och sparas i databasen. Samma hash beräknas vid signeringstillfället och jämförs — om dokumentet har manipulerats under resans gång avvisas signaturen.

• Signaturdatum och exakt tid (UTC)
• Signatärens namn (som de angivit)
• IP-adress vid signeringstillfället
• SHA-256-hash av dokumentinnehållet
• URL till arkiverat PDF-dokument

NEXT_PUBLIC_SUPABASE_URL=https://<ditt-projekt-ref>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<din-anon-nyckel>

Formulärappen exponerar enbart ANON_KEY. Inga sekretnycklar används — all känslig logik hanteras server-side i Supabase Edge Functions.

npm run dev   # Startar på port 3000

# Produktion
npx vercel --prod

Formulärappen bör ha en dedikerad domän, t.ex. form.dittforetag.se. Domänen konfigureras i Desktop CRM under Inställningar → Allmänt → Formulärappens URL — systemet använder den för att bygga länkarna som skickas till kunder.

I Desktop CRM, under Projekt → Frågor, klickar administratören Generera med AI. En konfigurerbar AI-assistent (typen Formulärgenerator) skapar ett JSON-formulär med relevanta frågor baserade på projektnamnet och eventuell beskrivning. Frågorna kan redigeras manuellt innan formuläret sparas.

När formuläret är sparat visas en unik länk i formatet form.dittforetag.se/f/{token}. Länken kan kopieras direkt eller skickas via e-post med ett klick — systemet förifyller avsändare, mottagare (kundens e-postadress) och ämnesrad via e-postmallen Frågeformulär — länk till klient. Sändningen loggas i projektets Anteckningar.

Kunden öppnar länken och möts av en välkomstskärm med företagsnamn och projektnamn. Formuläret visas sedan fråga för fråga. När kunden skickar svaren sparas de i databasen och en notifikation skickas till företagets e-post via Supabase Edge Function. Svarstillfället loggas som en grön anteckning i projektets Anteckningar.

Svaren sparas som en .md-fil i projektets dokumentbibliotek (mapp questions). AI-offertflödets data:projekt:text-files-nod läser automatiskt dessa filer — svaren vägs in i offertgenereringen utan manuell handpåläggning.

E-postmallar för formulärflödet hanteras under Inställningar → E-post → Mallar:

• "Frågeformulär — länk till klient" — mallen för e-posten som skickas till kunden med formulärlänken
• "Formulär besvarat — notifikation" — notifikation till företaget när kunden har svarat. Kan avaktiveras med toggle.

Handlers kastar ett vanligt Error vid fel — inga wrapper-objekt. Renderer-komponenter fångar felet med try/catch och visar det i UI:t.

Alla tabeller använder snake_case och pluralis. Kolumner är konsekvent snake_case. Primärnyckel är alltid id UUID DEFAULT gen_random_uuid().

supabase/
└── migrations/
    ├── 20240101120000_create_kunder.sql
    ├── 20240102120000_create_projekt.sql
    ├── 20240103120000_create_forslag.sql
    └── ...

Filer namnges YYYYMMDDHHMMSS_beskrivning.sql och appliceras i lexikografisk ordning. Varje fil körs exakt en gång — systemet spårar körda filer i tabellen _applied_migrations.

Hela migrationssetet för en fresh installation finns i rankgnar/open-crm-setup — ett separat repo med bootstrapscript för self-hosted Supabase (VPS).

Alla tabeller har RLS aktiverat. Varje app i ekosystemet har sin egna åtkomstkontroll:

Appen startar i dark mode som standard. Användaren kan växla tema via knappen i titelraden. Valet sparas lokalt och återställs vid nästa start.

Tabellen app_installningar innehåller både publika konfigurationsvärden och känsliga API-nycklar. Supabase RLS är konfigurerat med kolumn-nivå behörighet — anon-rollen kan bara läsa de kolumner som är icke-känsliga. Service-nycklar exponeras aldrig via PostgREST.

E-postintegrationen kräver ett Zoho Mail-konto. Alternativt kan vilken SMTP-server som helst konfigureras.

• Konfigureras under Inställningar → E-post
• Inkommande e-post kopplas till kunder via avsändar-e-postadress
• Mallar för offerter, fakturabekräftelser och påminnelser
• SMTP-alternativ: ange host, port, användarnamn och lösenord

Supabase Auth hanterar autentisering för Remote och Kundportalen. Desktop CRM autentiseras inte via Auth — den kör med service_role i main-processen.

• TypeScript strict — inga any-typer, inga @ts-ignore
• IPC-kanaler följer mönstret db:<entitet>:<åtgärd>
• Komponenter max ~200 rader — dela upp vid behov
• Inga hårdkodade färger — använd CSS-tokens (bg-bg, text-muted osv.)
• Inga kommentarer som förklarar VAD koden gör — bara VARFÖR när det inte är uppenbart
• npm run typecheck måste passera innan PR öppnas