docs: map existing codebase

2026-04-07 22:47:51 +02:00
parent 2378febe6f
commit 1b4e5eca0d
8 changed files with 1460 additions and 0 deletions
@@ -0,0 +1,164 @@
+# Technology Stack
+
+**Analysis Date:** 2026-04-07
+
+## Languages
+
+**Primary:**
+- TypeScript ~5.8.0 - Full application development
+- JavaScript (ES modules) - Frontend runtime
+
+**Secondary:**
+- HTML5 - Document structure (in `index.html`)
+- CSS - Styling with Tailwind CSS
+- Markdown - Documentation (README.md)
+- YAML - Configuration (implied through Dockerfile)
+
+## Runtime
+
+**Environment:**
+- Node.js 22 - Development and build environment
+- Browser environment - Vue 3 SFC runtime
+
+**Package Manager:**
+- npm - Dependency management
+- Lockfile: `package-lock.json` (present and tracked)
+
+## Frameworks
+
+**Core Frontend:**
+- Vue 3.5.13 - Progressive JavaScript framework for UI
+- Vue Router 4.5.0 - Client-side routing with lazy-loaded pages
+- Pinia 3.0.1 - State management (minimal usage - currently only `counter.ts`)
+- Vue I18n 9.14.4 - Internationalization (English and French locale files in `src/locales/`)
+
+**Build & Dev:**
+- Vite 6.2.4 - Build tool and dev server
+  - Config: `vite.config.ts` with Vue plugin, DevTools plugin, chunk splitting optimization
+  - Build output: `dist/` with CSS code splitting, Terser minification
+- Vite Plugin Vue DevTools 7.7.2 - Development utilities
+- @vitejs/plugin-vue 5.2.3 - Vue 3 SFC support
+
+**Styling:**
+- Tailwind CSS 4.1.10 - Utility-first CSS framework
+- @tailwindcss/postcss 4.1.10 - PostCSS plugin for Tailwind
+- PostCSS 8.5.6 - CSS transformation pipeline
+- Autoprefixer 10.4.21 - Vendor prefix handling
+- Terser 5.43.1 - JavaScript minification
+
+**Code Quality:**
+- ESLint 9.22.0 - Linting (config: `eslint.config.ts`)
+  - @vue/eslint-config-typescript 14.5.0
+  - @vue/eslint-config-prettier 10.2.0 - Prettier integration
+  - eslint-plugin-vue ~10.0.0
+- Prettier 3.5.3 - Code formatting (config: `.prettierrc.json`)
+  - Format settings: `semi: false`, `singleQuote: true`, `printWidth: 100`
+
+**Type Checking:**
+- vue-tsc 2.2.8 - Vue component type checking
+- TypeScript compiler with `type-check` npm script
+
+**Head Management:**
+- @vueuse/head 2.0.0 - Dynamic document head management for meta tags and SEO
+
+## Key Dependencies
+
+**Critical:**
+- vue 3.5.13 - Core framework
+- vue-router 4.5.0 - SPA routing with code splitting
+- pinia 3.0.1 - State management store
+- vue-i18n 9.14.4 - Multi-language support
+
+**Infrastructure & Build:**
+- vite 6.2.4 - Next-gen build tool with HMR
+- tailwindcss 4.1.10 - Rapid UI development
+- typescript 5.8.0 - Static typing and compilation
+
+**Developer Tools:**
+- eslint 9.22.0 - Code linting
+- prettier 3.5.3 - Code formatting
+- npm-run-all2 7.0.2 - Parallel script execution (used in build process)
+- @tsconfig/node22 22.0.1 - TSConfig preset for Node 22
+- @types/node 22.14.0 - Node.js type definitions
+- jiti 2.4.2 - CommonJS loader for TypeScript modules
+
+## Configuration
+
+**Environment:**
+- No `.env` files detected in source
+- Google Analytics tracking ID hardcoded: `G-CDVVNFY6MV` (in `index.html`)
+- Umami analytics script loaded from `umami.killiandalcin.fr` (in `index.html`)
+- Google AdSense client ID hardcoded: `ca-pub-5219367964457248` (in `index.html`)
+
+**Build Configuration:**
+- `vite.config.ts` - Build optimizations:
+  - Path alias: `@/` → `./src/`
+  - CSS code splitting enabled
+  - Terser minification with console/debugger removal
+  - Manual chunk splitting: `vue-vendor` and `ui-components`
+  - Content hash in chunk filenames for cache busting
+  - Source maps disabled
+  - Chunk size warning limit: 1000 KB
+
+**Type Configuration:**
+- `tsconfig.json` - References `tsconfig.app.json` and `tsconfig.node.json`
+- `tsconfig.app.json`:
+  - Extends `@vue/tsconfig/dom.json`
+  - Includes `src/**/*` and `*.vue` files
+  - Path alias: `@/*` → `./src/*`
+  - Excludes `src/**/__tests__/*`
+
+**Linting Configuration:**
+- `eslint.config.ts` - Flat config format:
+  - Files: `**/*.{ts,mts,tsx,vue}`
+  - Rules: Vue essential, TypeScript recommended
+  - Skips Prettier formatting enforcement
+
+**Formatting Configuration:**
+- `.prettierrc.json`:
+  - No semicolons
+  - Single quotes for strings
+  - 100 character line width
+
+**PostCSS Configuration:**
+- `postcss.config.js` - Tailwind CSS and Autoprefixer
+
+**Tailwind Configuration:**
+- `tailwind.config.js` - Content scanning for `index.html` and `src/**/*.{vue,js,ts,jsx,tsx}`
+
+## Platform Requirements
+
+**Development:**
+- Node.js 22+ (specified in Dockerfile)
+- npm 10+ (implied by Node 22)
+- TypeScript 5.8+
+- Any Unix-like shell (bash/zsh) or Windows with Node.js
+
+**Production:**
+- Docker - Multi-stage build with Node 22-alpine and nginx stable-alpine
+- Web server: nginx (configured in `nginx.conf`)
+- Deployment target: Static HTML served via nginx
+  - Base image: `nginx:stable-alpine`
+  - Document root: `/usr/share/nginx/html`
+  - Port: 80
+  - SPA fallback: All requests route to `/index.html`
+
+**Browser Support:**
+- JavaScript enabled (noscript fallback message in `index.html`)
+- Modern browsers with ES2020+ support (Vite default targets)
+
+## Scripts & Commands
+
+```bash
+npm run dev              # Start Vite dev server with HMR
+npm run build           # Type check + build (parallel with npm-run-all2)
+npm run type-check      # Run vue-tsc type checking
+npm run build-only      # Build without type checking
+npm run preview         # Preview production build
+npm run lint            # Run ESLint with --fix
+npm run format          # Format src/ with Prettier
+```
+
+---
+
+*Stack analysis: 2026-04-07*