For utviklere¶
Teknisk referanse for utviklere som skal jobbe med eller integrere mot Knapphus Connect.
Kodebasene¶
| Repo | Innhold | Teknologi |
|---|---|---|
| Knapphus Connect Ionic App | Appen (web/Android/iOS) + denne håndboken | Angular 19 / Ionic 8 / Capacitor, pnpm |
| knapphus connect api | Connect API | ASP.NET Web API, .NET Framework 4.8, IIS |
| jhlVismaAPI (JHL_VismaBusinessInterface) | Forretningslag mot Visma Business — DLL brukt av API-et og ConnectMonitor | .NET Framework |
| Knapphus Connect Monitor | ConnectMonitor-synktjenesten | .NET konsoll + Task Scheduler |
Arkitektur i ett avsnitt¶
Appen autentiserer med brukernavn/passord/selskap mot API-et og får JWT
(4 timer) + refresh-token (lagres i RefreshTokens per selskapsdatabase). Alle
forretningskall går gjennom UserController m.fl., som bruker Business-klassen
i jhlVismaAPI (new Business(clientID)) — flertenant via
ConnectSQL_{id}/VismaSQL_{id} connection strings og companiesSection i
Web.config. Skriving til Visma skjer via VBS (GenericService);
beholdningstransaksjoner skrives direkte til FreeInf2. Skjema/avvik proxys mot
Landax. Se Systemadministrasjon for
arkitekturdiagram, og prosessflytene for tabellnivået:
ordrer,
beholdning.
Sider¶
- Connect API (Swagger) — endepunktreferanse
Kom i gang lokalt (appen)¶
pnpm install
pnpm start # ng serve på :4200
pnpm run build # produksjonsbygg → www/
pnpm run docs:validate # validerer håndboken
API-endepunktet appen bruker settes i src/app/shared/app-settings.ts
(API_ENDPOINT). E2E/skjermbilde-pipeline: .env fra .env.example +
pnpm docs:screenshots.