How amin00sa/plateforme works
Project type and purpose
• This is a Vue 3 single-page application (SPA) scaffolded with Vite, Tailwind CSS, PostCSS, and ESLint/Prettier.
• It provides a component-based frontend “platform” template, intended to be deployed as static assets that interact with one or more external REST APIs (authentication, data services, etc.).
File structure
• Top-level files: Vite config (vite.config.js), Tailwind config (tailwind.config.js), linting/prettier configs, package.json.
• public/: Static assets (images, favicon, index.html).
• src/:
• main.js: App bootstrap, global plugin registration (router, store)
• App.vue: Root component
• assets/: Global CSS/SCSS, design system styles
• views/: Page-level components (e.g., HomeView.vue) wired to router.
• router/index.js: vue-router setup, route definitions.
• stores/: Pinia (or Vuex–style) state modules (auth.store.ts, openModal.js).
• utils/: Service layer helpers (axios-helper.ts, http.ts, error-handler.ts, toast.ts).
• types/: TypeScript interfaces for domain models (students, schools, pagination, errors).
README for additional insights
• Basic instructions on installing, running dev server, building for production, and linting.
a. Main components:
• Developer workstation (IDE, Git)
• CI/CD pipeline (Git commit → Vite build)
• Static asset host (CDN or S3/Netlify)
• Browser client running the Vue SPA
• External backend services (Authentication API, Data API, other third-party services)
b. Relationships & data flow:
1. Developer pushes code → CI/CD triggers install → Vite builds static bundle.
2. Built assets are deployed to static hosting/CDN.
3. Browser downloads index.html + JavaScript/CSS.
4. Vue router renders views; user actions dispatch store mutations/actions.
5. Service layer (utils/axios-helper) sends HTTP requests to external APIs.
6. Responses update Pinia store → UI components re-render.
c. Architectural patterns & design principles:
• SPA with component-based UI and single root (App.vue)
• Modular CSS with Tailwind + PostCSS
• Centralized state management via Pinia stores
• Service abstraction layer (utils/http, axios-helper) for all HTTP calls
• Domain typing with TypeScript interfaces
• Routing with vue-router
d. Key technologies/frameworks:
• Vue 3 Composition API + SFCs (Single File Components)
• Vite for faster dev server & build
• Tailwind CSS for utility-first styling
• Pinia (or equivalent) for stores
• Axios for HTTP calls
• ESLint/Prettier for code quality