Lägg till produktdirektiv: Master Prompt v1.0

Styrdokument för utvecklingsteamet med projektmål, designfilosofi,
arbetsflöde, kärnfunktioner, AI-principer, dokumentationskrav,
API-first, infrastruktur, säkerhet, integrationer, kundrapport,
affärsmål och MVP-avgränsning. Länkas från VISION.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012EQg3rJsrQ1ZNTvkzmQAtt
This commit is contained in:
Claude
2026-08-02 22:19:40 +00:00
parent 11ec7cb351
commit 2f3dad123a
2 changed files with 239 additions and 0 deletions
+237
View File
@@ -0,0 +1,237 @@
# Guidad Felsökning Master Prompt v1.0
Det här är ett produktdirektiv, inte en teknisk specifikation ett styrdokument som ett utvecklingsteam kan använda från dag ett. Visionen och de resonemang som ligger bakom finns i [VISION.md](VISION.md).
---
## Projektmål
Bygg en produktionsklar SaaS-plattform med namnet **Guidad Felsökning**.
Plattformen är ett professionellt arbetsverktyg för mekaniker, servicetekniker och felsökare inom alla tekniska områden där strukturerad diagnostik används.
Exempel:
- Fordon
- Lastbilar
- Bussar
- Entreprenadmaskiner
- Lantbruksmaskiner
- Kompressorer
- Generatorer
- Industrimaskiner
- Marin utrustning
- Elsystem
- Hydraulik
- Pneumatik
- Automation
Systemet ska fungera som en digital diagnostikhandledare. Det ska inte ersätta teknikerens kompetens eller fatta beslut åt användaren, utan metodiskt vägleda genom en dokumenterad felsökningsprocess.
---
## Designfilosofi
Designen ska kännas som ett professionellt fabriksverktyg.
Målbild:
- enkel
- robust
- extremt tydlig
- inga onödiga animationer
- inga sociala funktioner
- inga distraktioner
- stora knappar
- hög kontrast
- optimerad för arbete med handskar
- fullt stöd för mobil, surfplatta och dator
Varje skärm ska ha ett tydligt syfte och minimera antalet val.
---
## Arbetsflöde
1. Identifiera objektet.
2. Starta arbetsloggen.
3. Beskriv felet.
4. AI leder användaren genom verifierbara kontroller.
5. Bilder, video och mätvärden dokumenteras.
6. Alla aktiviteter tidsstämplas.
7. Rapport genereras.
8. Rapport exporteras eller delas via API.
---
## Kärnfunktioner
- Samtalsbaserad guidning (text och röst)
- Bildanalys
- OCR
- Objektidentifiering
- Automatisk arbetslogg
- Tidrapportering
- Fotodokumentation
- Videostöd
- Mätvärdeslogg
- Checklista
- Kundrapport
- API-export
- Integration med affärssystem
- Integration med tillverkarinformation via användarens egna behörigheter
- Rollbaserad behörighet
- Offline-läge med synkronisering
---
## AI-principer
AI får aldrig gissa.
Alla rekommendationer ska tydligt skilja mellan:
- observation
- verifierat faktum
- hypotes
- rekommenderat nästa steg
Varje svar ska ha en tydlig tillförlitlighetsnivå.
AI ska vara konsekvent, kortfattad och metodisk.
---
## Dokumentation
Varje aktivitet ska lagras.
Exempel:
- tid
- användare
- GPS (om aktiverat)
- objekt
- bilder
- video
- mätvärden
- användarens kommentarer
- AI:s rekommendation
- resultat
Loggen ska vara revisionssäker, vilket innebär att historik bevaras och ändringar kan spåras.
---
## API-first
Hela plattformen byggs API-first.
Alla objekt ska kunna:
- hämtas
- uppdateras
- exporteras
- integreras
Dokumentationen ska vara komplett (exempelvis OpenAPI/Swagger) så att externa system enkelt kan anslutas.
---
## Infrastruktur
Bygg för hög tillgänglighet och skalbarhet.
Exempel på målarkitektur:
- AWS
- Kubernetes
- Docker
- PostgreSQL
- Redis
- Objektlagring för bilder och dokument
- CDN
- Lastbalansering
- Automatisk skalning
- Övervakning och loggning
- Dagliga säkerhetskopior
- Katastrofåterställning
- Kryptering av data under överföring och lagring
---
## Säkerhet
Systemet ska vara lämpligt för professionella verksamheter.
Prioritera:
- stark autentisering
- rollbaserad åtkomst
- API-nycklar och OAuth där det passar
- detaljerad revisionslogg
- principen om minsta behörighet
- säker nyckelhantering
- möjlighet att uppfylla krav enligt relevanta regelverk (t.ex. GDPR)
---
## Integrationer
Systemet ska kunna integreras med:
- DMS-system
- ERP-system
- CRM-system
- elektroniska serviceböcker
- garantihantering
- fakturering
- tidredovisning
- reservdelssystem
- tillverkarnas informationssystem, när användaren har giltig behörighet och integration finns tillgänglig
---
## Kundrapport
Efter varje avslutat arbete ska systemet kunna generera en professionell rapport med:
- identifierat objekt
- felbeskrivning
- utförda kontroller
- bilder
- mätvärden
- provkörning
- rekommenderade nästa steg
- total tidsåtgång
- komplett arbetslogg
Rapporten ska kunna delas via länk, PDF eller API.
---
## Affärsmål
Produkten ska ge värde på flera nivåer:
- Teknikern får metodstöd och mindre administration.
- Verkstaden får bättre kvalitet, spårbarhet och debiteringsunderlag.
- Kunden får insyn i vad som faktiskt utförts.
- Organisationen bygger över tid en sökbar kunskapsbas.
- I framtiden kan anonymiserade och aggregerade data användas för trendanalyser, förutsatt att detta sker i enlighet med avtal och tillämpliga regler.
---
## MVP-avgränsning
Det här är en produkt som lämpar sig väl för ett MVP. Den första versionen behöver inte stödja alla maskintyper eller alla integrationer.
Om man bygger en stabil kärna
1. objektidentifiering,
2. AI-guidad felsökning,
3. arbetslogg,
4. dokumentation,
5. ett öppet API
finns en plattform som sedan kan utökas bransch för bransch utan att behöva göras om i grunden.
+2
View File
@@ -1,5 +1,7 @@
# Guidad Felsökning # Guidad Felsökning
> Styrdokument för utveckling: [Master Prompt v1.0](MASTER-PROMPT.md)
## Vision ## Vision
Guidad Felsökning är en professionell diagnostikplattform som steg för steg vägleder tekniker genom en strukturerad felsökningsprocess. Plattformen dokumenterar varje moment, hämtar information från tillverkarens system via användarens egna behörigheter och skapar en komplett, spårbar felsökningshistorik. Guidad Felsökning är en professionell diagnostikplattform som steg för steg vägleder tekniker genom en strukturerad felsökningsprocess. Plattformen dokumenterar varje moment, hämtar information från tillverkarens system via användarens egna behörigheter och skapar en komplett, spårbar felsökningshistorik.