imexrps/.ai/file-map.md

File Map

Use this as a quick locator before making changes.

Root

• package.json: scripts, dependencies, electron-builder config, product metadata.
• package-lock.json: npm dependency lock.
• vite.config.js: Vite renderer config.
• index.html: Vite app HTML entry.
• README.md: old Create React App boilerplate; partially stale.
• Usage.md: release usage notes; ignored by git but present.
• deployment.md: deployment note; very terse.
• update-targets.md: historical GraphQL target load example.
• SGI.md: SGI-related domain notes.
• electron-builder.pack-check.cjs: no-publish local packaging config for npm run pack.
• .gitignore: generated artifacts and local secret files.

Electron

• electron/main.js: chooses source or bundled main process.
• electron/main-src.js: main process source of truth.
• electron/preload.js: chooses source or bundled preload.
• electron/preload-src.js: context bridge for IPC/logger.
• electron/ipc-main-handler.js: shared IPC registration.
• electron/electron-store.js: async ESM-compatible electron-store wrapper.
• electron/analytics.js: Amplitude analytics IPC.
• electron/changelog.json: versioned release notes.
• electron/licenses.txt: third-party notice content shown in the app.
• electron/file-watcher/: chokidar watcher and watcher IPC.
• electron/file-scan/: manual scan/delete estimate file logic and IPC.
• electron/decoder/: DBF estimate decoding and ruleset application.
• electron/claims-clerk/: line-level alert rules.
• electron/audit/: audit spreadsheet dialog/parsing IPC.
• electron/estimate-scrubber/: external estimate scrubber API integration.
• electron/notification-wrapper/: native notification helper.

Renderer Entrypoints

• src/index.jsx: React root, Redux Provider, MemoryRouter, PersistGate, Sentry renderer.
• src/App/App.jsx: Apollo provider, AntD theme/app provider, auth check, top-level IPC side effects.
• src/App/App.styles.scss: app-level styles.
• src/index.css: global CSS.

Renderer Components

• src/components/pages/routes/routes.page.jsx: authenticated app shell and routes.
• src/components/pages/jobs/: main jobs page.
• src/components/pages/reporting/: reporting page.
• src/components/pages/audit/: audit page.
• src/components/pages/scan/: scan page.
• src/components/pages/settings/: settings page.
• src/components/pages/admin/: admin page.
• src/components/pages/sign-in/: sign-in page.
• src/components/organisms/jobs-list-latest/: latest jobs infinite list.
• src/components/organisms/jobs-list-search/: search jobs infinite list.
• src/components/organisms/jobs-detail/: selected job detail panel.
• src/components/organisms/watcher-manager/: file watcher controls.
• src/components/organisms/shop-settings/: shop settings workflows.
• src/components/organisms/update-manager/: updater UI.
• src/components/organisms/notification-modal/: notification UI.
• src/components/molecules/jobs-lines-table/: jobline table.
• src/components/molecules/estimate-scruber-results/: estimate scrubber results UI. Note the folder name contains scruber.
• src/components/molecules/estimate-scrubber-button/: estimate scrubber action.
• src/components/molecules/reporting-dates/: reporting date range picker.
• src/components/templates/error-boundary.template.jsx: app error boundary.
• src/components/templates/ipc-upsert-job/: IPC import/upsert template.

State

• src/redux/store.js: store, saga middleware, logger, persist store.
• src/redux/root.reducer.js: combines reducers.
• src/redux/root.saga.js: combines sagas.
• src/redux/application/: watcher/app/update/selection/scrubber state.
• src/redux/user/: auth/bodyshop/targets/notifications/dark mode.
• src/redux/reporting/: report/audit/scorecard state.
• src/redux/scan/: scan state.

GraphQL and Auth

• src/graphql/GraphQLClient.js: Apollo links, auth, retry, Sentry, cache policies.
• src/graphql/jobs.queries.js: job queries/mutations.
• src/graphql/joblines.queries.js: jobline mutations.
• src/graphql/bodyshop.queries.js: shop and notifications.
• src/graphql/user.queries.js: user upsert/auth lookup.
• src/graphql/reporting.queries.js: reporting queries.
• src/graphql/notification.queries.js: notification acceptance.
• src/graphql/veh_group.queries.js: vehicle groups.
• src/firebase/firebase.utils.js: Firebase auth/app setup.

IPC

• src/ipc.types.json: canonical IPC channel map.
• src/ipc.types.js: ESM wrapper.
• src/ipc.types.commonjs.js: CommonJS wrapper.
• src/ipc/ipc-renderer-handler.js: central renderer IPC listeners.
• src/ipc/ipc-estimate-utils.js: estimate upsert and close-date GraphQL helpers.

Utilities and Assets

• src/util/antdFeedback.js: context-safe AntD message/notification bridge.
• src/util/day.js: day/date setup.
• src/util/CalculateJobRps.js: RPS calculation utility.
• src/util/GetJobTarget.js: target calculation utility.
• src/util/decimalPrecision.js: numeric precision utility.
• src/util/sorters.js: table/list sort helpers.
• src/assets/: app logos/images.
• src/icons/: app icons by platform/size.
• public/: web app static files.

Hasura and Firebase

• hasura/config.yaml: Hasura project config.
• hasura/config.yaml.prod: production Hasura config.
• hasura/metadata/: tracked Hasura metadata.
• hasura/migrations/default/: active SQL migrations.
• hasura/migrations_backup/: historical migration backup.
• firebase/functions/: Firebase functions project.
• firebase/firebase.json: Firebase config.

Generated/Ignored

• build/: renderer production output.
• dist-electron/: bundled Electron main/preload output.
• dist/: electron-builder output.
• node_modules/: dependencies.