56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# AGENTS.md — GestionDesCompetences
|
|
|
|
## Project
|
|
|
|
React 19 SPA (skills management) built with Vite 8, JavaScript (not TypeScript), Tailwind CSS v4, shadcn/ui, Supabase backend, React Router v7.
|
|
|
|
## Commands
|
|
|
|
```
|
|
npm run dev # Vite dev server with HMR
|
|
npm run build # Production build → dist/
|
|
npm run lint # ESLint (flat config)
|
|
npm run preview # Serve dist/ locally
|
|
```
|
|
|
|
No test runner, no typecheck script.
|
|
|
|
## Architecture
|
|
|
|
- **Entry**: `src/main.jsx` → `src/App.jsx`
|
|
- **Auth**: `src/context/AuthContext.jsx` — Supabase Auth + `members` table profile (role: admin/member)
|
|
- **Routing**: `src/App.jsx` — public routes `/login`, `/register`, `/accept-invite`; protected routes wrapped in `<ProtectedRoute>`; admin-only routes (`/members`, `/skills`) also wrapped in `<AdminRoute>`
|
|
- **Pages**: `src/pages/` — Dashboard, Members, Skills, SkillMatrix, History, Profile
|
|
- **UI**: `src/components/ui/` — shadcn components (radix-nova style, JS, no TSX)
|
|
- **Supabase client**: `src/lib/supabase.js` — reads `VITE_SUPABASE_URL` / `VITE_SUPABASE_ANON_KEY` from env
|
|
- **Path alias**: `@/*` → `src/*` (configured in both `vite.config.js` and `jsconfig.json`)
|
|
|
|
## Supabase
|
|
|
|
- DB schema + RLS policies in `supabase/migrations/001_init.sql`
|
|
- Tables: `categories`, `skills`, `members`, `level_descriptions`, `skill_levels`, `skill_history`, `invitations`
|
|
- `handle_new_user()` trigger auto-creates a `members` row on auth signup
|
|
- RLS: read-all for most tables, write restricted to admin role
|
|
- `.env` points to a local Supabase instance (`192.168.2.220:8000`) — this is committed but `.env` is gitignored; adjust for your environment
|
|
|
|
## Docker
|
|
|
|
Multi-stage: `node:20-alpine` build → `nginx:alpine` serve.
|
|
Requires `VITE_SUPABASE_URL` and `VITE_SUPABASE_ANON_KEY` as build args.
|
|
SPA routing handled by nginx `try_files`.
|
|
|
|
## shadcn/ui
|
|
|
|
Config in `components.json`. Add components with:
|
|
```
|
|
npx shadcn@latest add <component>
|
|
```
|
|
Components land in `src/components/ui/`. Uses Lucide icons.
|
|
|
|
## Conventions
|
|
|
|
- JavaScript only (`.jsx`), no TypeScript
|
|
- ESLint flat config (`eslint.config.js`) — ignores `dist/`
|
|
- Tailwind v4 via `@tailwindcss/vite` plugin (no `tailwind.config.js`)
|
|
- French UI labels (application is in French)
|