How ma2903/devlooks works
Project type and purpose
• This is a full-stack academic e-commerce platform (“DevLooks”) built to demonstrate modern web development.
• Front-end: Vue 3 SPA (Vite, TailwindCSS).
• Back-end: Node.js with Express, TypeScript, MongoDB.
• Integrations: Mercado Pago payments, Google Gemini AI for avatar generation and sentiment analysis, email (Nodemailer), shipping via Correios.
File structure
• Top-level:
• package.json, tsconfig.json, vite.config.js, static index.html
• server/ → Express app (MVC):
– controllers/ (request handlers)
– services/ (business logic)
– models/ (Mongoose schemas)
– routes/ (Express routers)
– middlewares/ (auth, validation)
– config/ (DB, environment, test data)
– factories/ (Factory Pattern for test data)
– validators/ (request payload validation)
• view/ → Vue source:
– App.vue, main.js, router.js
– components/ (reusable UI parts)
– pages/ (views/routes)
– composables/ (custom hooks, e.g. useMercadoPago)
– services/ (API wrappers, user store)
• public/ → static assets, manifest, SEO files
• Various config files: .env examples, Lighthouse guide
README for additional insights
• Confirms MVC architecture on the back-end, Factory and Observer patterns.
• Lists core features (auth, cart, checkout, admin).
• Specifies technology stack and CI/build status.
• Describes performance optimizations and deployment targets (Vercel/Render, MongoDB Atlas).