fix: remove nested .git folders, re-add as normal directories

2026-03-22 17:50:47 -05:00
parent f55c7e47c9
commit 6b7eec67b8
1870 changed files with 4170168 additions and 3 deletions
@@ -0,0 +1,157 @@
+# Copilot Instructions for ttscm-ui
+
+## Project Overview
+
+**ttscm-ui** is an Electron desktop application built with **SvelteKit**, TypeScript, and Vite. It connects to the Optima API for credential and company management. The app uses standard SvelteKit routing for single-page navigation and bun for package management with patches applied to SvelteKit.
+
+## Architecture Layers
+
+### Electron Architecture
+
+- **`electron/main.ts`**: Main process—creates/manages windows, handles file system access. Loads preload script and serves the renderer.
+- **`electron/preload.ts`**: Currently empty bridge between main and renderer processes. Extend here to expose secure IPC handlers if needed.
+- **`forge.config.ts`**: Electron Forge configuration with Vite plugin for building main, preload, and renderer targets.
+
+### Frontend (SvelteKit)
+
+- **`src/routes/`**: SvelteKit file-based routing with standard pathname router.
+  - `(auth)` group: Authentication pages (login)
+  - `(secure)` group: Protected pages requiring auth
+- **`src/lib/`**: Reusable modules
+  - `optima-api/`: API client abstraction with modular endpoints (auth, companies, credentials, etc.)
+  - `axios.ts`: Base axios instance with `PUBLIC_API_URL` env variable
+- **`src/components/`**: Reusable Svelte components (modals, spinners, error boundaries)
+
+### API Communication
+
+The `$lib/index.ts` exports `optima` object aggregating all API modules. Example:
+
+```typescript
+export const optima = {
+  auth: (await import("./optima-api/modules/auth")).auth,
+  company: (await import("./optima-api/modules/companies")).company,
+  // etc.
+};
+```
+
+Each module (e.g., `auth.ts`) exports functions that call the API using a custom axios instance.
+
+## Key Conventions
+
+### Routing
+
+- **Use standard SvelteKit routing with `/` prefix** (e.g., `href="/credentials"`)
+- Routes in `src/routes/` map to `/path` at runtime
+- Do NOT use hash-based routing (`#/` routes)
+
+### API Module Pattern
+
+Create API modules in `src/lib/optima-api/modules/` following this pattern:
+
+```typescript
+// Example: credentials.ts
+export const credential = {
+  async fetchCredentials(api: AxiosInstance) {
+    // Implementation
+  },
+};
+```
+
+Export as a named object, then import/aggregate in `src/lib/index.ts`.
+
+### Environment Variables
+
+- `PUBLIC_API_URL`: API base URL, used in `src/lib/optima-api/axios.ts`
+- Prefixed with `PUBLIC_` to be accessible in client code
+
+### File Organization
+
+- Components go in `src/components/` (e.g., modals, spinners)
+- Page-specific logic in `src/routes/[route]/+page.svelte` and `+page.server.ts`
+- Styles in `src/styles/` with Tailwind CSS + TailwindCSS vite plugin
+- Tests colocated: `*.spec.ts` or `*.test.ts` next to source files
+
+## Development Workflow
+
+### Installation & Setup
+
+```bash
+bun install
+```
+
+Uses bun with SvelteKit patches (see `patches/` directory).
+
+### Running in Development
+
+```bash
+bun start
+```
+
+Electron Forge + Vite handles dev server and hot module replacement (HMR). Dev tools open automatically. Main window loads `/login` first.
+
+### Building & Packaging
+
+- **Build for production**: `bun run package` → outputs to `out/` directory
+- **Create distributable**: `bun run make` → creates installers (configure in `forge.config.ts`)
+- **Check types & lint**: `bun run check` (runs svelte-kit sync + svelte-check)
+
+### Testing
+
+#### Unit Tests (Vitest)
+
+```bash
+bun run test:unit
+```
+
+- Client tests: `src/**/*.svelte.{test,spec}.{js,ts}` (jsdom environment)
+- Server tests: `src/**/*.{test,spec}.{js,ts}` excluding svelte tests (node environment)
+- Setup: `vitest-setup-client.ts` mocks `window.matchMedia` for Svelte 5 + jsdom compatibility
+
+#### E2E Tests (Playwright)
+
+```bash
+bun run test:e2e
+```
+
+- Tests in `e2e/` directory
+- Config: `playwright.config.ts` (builds and previews before testing)
+
+#### Run All Tests
+
+```bash
+bun run test
+```
+
+Runs unit tests first, then e2e.
+
+## Critical Integration Points
+
+### IPC (Electron Main ↔ Renderer)
+
+**Status**: Preload script is currently empty. If file system access is needed, define IPC handlers in `electron/main.ts` and expose them via `electron/preload.ts` to renderer process.
+
+### API Authentication
+
+- Auth flow starts in `src/lib/optima-api/modules/auth.ts` with `fetchAuthRedirectUri()`
+- TODO: Enforce auth checks on every page change (see `src/lib/index.ts` comment)
+
+### Build Artifacts
+
+- **Dev server URL**: `MAIN_WINDOW_VITE_DEV_SERVER_URL` (injected by Electron Forge)
+- **Output**: Rendered app built to `.vite/renderer/main_window/` (configured in `svelte.config.js`)
+
+## Common Patterns & Gotchas
+
+1. **Standard Routing**: Use standard SvelteKit routing with `/` prefix (e.g., `href="/credentials"`) — do NOT use hash-based routing
+2. **SvelteKit Patches**: Project patches SvelteKit in `patches/` to work around issues. When updating SvelteKit, verify patches still apply.
+3. **Async Components**: Svelte 5 has `experimental.async: true` enabled; be aware of async component patterns.
+4. **Tailwind**: Uses `@tailwindcss/vite` plugin; configure utilities in tailwind config if needed.
+5. **API Error Handling**: API modules throw errors with descriptive messages. Use `$lib/errorHandler.ts` for consistent error formatting.
+
+## Useful Entry Points for Navigation
+
+- **Frontend Layout**: [src/routes/+layout.svelte](src/routes/+layout.svelte) (main shell, sidebar, header)
+- **API Abstraction**: [src/lib/optima-api/axios.ts](src/lib/optima-api/axios.ts) (base client)
+- **API Modules**: [src/lib/optima-api/modules/](src/lib/optima-api/modules/) (auth, companies, credentials, etc.)
+- **App Entry**: [src/app.html](src/app.html)
+- **Electron Main**: [electron/main.ts](electron/main.ts)
@@ -0,0 +1,137 @@
+name: Build and Publish
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build-server:
+    name: Build Server Image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Build and push the Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          build-args: |
+            PUBLIC_API_URL=https://opt-api.osdci.net
+          tags: |
+            ghcr.io/project-optima/ttscm-ui:latest
+            ghcr.io/project-optima/ttscm-ui:${{ github.event.release.tag_name }}
+
+  build-desktop-macos:
+    name: Build Desktop (macOS)
+    runs-on: macos-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Rebuild native modules
+        run: npm rebuild
+
+      - name: Build macOS distributables
+        run: bun run make:macos
+        env:
+          PUBLIC_API_URL: https://opt-api.osdci.net
+
+      - name: Upload macOS artifacts to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            out/make/**/*.dmg
+            out/make/**/*.zip
+
+  build-desktop-windows:
+    name: Build Desktop (Windows)
+    runs-on: windows-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build Windows distributables
+        run: npm run make -- --platform win32
+        env:
+          PUBLIC_API_URL: https://opt-api.osdci.net
+
+      - name: Upload Windows artifacts to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            out/make/**/*.exe
+            out/make/**/*.nupkg
+            out/make/**/*.msi
+
+  deploy:
+    name: Deploy
+    needs: [build-server]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set the Kubernetes context
+        uses: azure/k8s-set-context@v2
+        with:
+          method: kubeconfig
+          kubeconfig: ${{ secrets.KUBECONFIG }}
+
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Lint Kubernetes manifests
+        uses: azure/k8s-lint@v3
+        with:
+          lintType: dryrun
+          manifests: |
+            kubernetes/deployment.yaml
+            kubernetes/ingress.yaml
+          namespace: optima
+
+      - name: Deploy to the Kubernetes cluster
+        uses: azure/k8s-deploy@v5
+        with:
+          namespace: optima
+          force: true
+          skip-tls-verify: true
+          manifests: |
+            kubernetes/deployment.yaml
+            kubernetes/ingress.yaml
+          images: |
+            ghcr.io/project-optima/ttscm-ui:${{ github.event.release.tag_name }}