{"id":51706638,"url":"https://github.com/kvalkanovaa/auto-service-platform","last_synced_at":"2026-07-16T16:36:23.928Z","repository":{"id":366446561,"uuid":"1246176209","full_name":"kvalkanovaa/auto-service-platform","owner":"kvalkanovaa","description":"AI-powered auto service platform - vehicle management, symptom diagnosis, and workshop booking","archived":false,"fork":false,"pushed_at":"2026-06-21T20:57:46.000Z","size":325,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-21T22:16:21.288Z","etag":null,"topics":["cloudinary","express","gemini-api","jwt","mailtrap","mongodb","mongoose","nodejs","react","tailwindcss","typescript","vite","vitest","zod-validation"],"latest_commit_sha":null,"homepage":"https://diagnaut.onrender.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kvalkanovaa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-22T00:24:17.000Z","updated_at":"2026-06-21T21:04:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kvalkanovaa/auto-service-platform","commit_stats":null,"previous_names":["kvalkanovaa/auto-service-platform"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kvalkanovaa/auto-service-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvalkanovaa%2Fauto-service-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvalkanovaa%2Fauto-service-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvalkanovaa%2Fauto-service-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvalkanovaa%2Fauto-service-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kvalkanovaa","download_url":"https://codeload.github.com/kvalkanovaa/auto-service-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvalkanovaa%2Fauto-service-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35551282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-16T02:00:06.687Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudinary","express","gemini-api","jwt","mailtrap","mongodb","mongoose","nodejs","react","tailwindcss","typescript","vite","vitest","zod-validation"],"created_at":"2026-07-16T16:36:23.247Z","updated_at":"2026-07-16T16:36:23.923Z","avatar_url":"https://github.com/kvalkanovaa.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Diagnaut\n\nAI-powered platform connecting vehicle owners with service centers in Bulgaria. Describe a car problem in plain language, let AI diagnose it, and book a slot at a matching workshop.\n\n\u003e **Diagnaut** = _diagnosis_ + the suffix _-naut_ (explorer/voyager) — a navigator through your car's diagnosis.\n\nBuilt as a diploma thesis project (2026) — full-stack monorepo with a React frontend and a Node.js backend.\n\n---\n\n## Features\n\n- **Vehicle management** — register, edit and delete vehicles with full specs and photos\n- **AI symptom diagnosis** — describe a problem in plain text and get a structured analysis (summary, urgency, suggested service categories) powered by Google Gemini\n- **AI follow-up** — answer clarifying questions for a refined, more precise diagnosis\n- **Service center matching** — AI-recommended workshops based on the diagnosed categories\n- **Online booking** — reserve a free time slot, **with or without** a prior AI diagnosis\n- **Reviews \u0026 ratings** — leave a review after a completed booking; the center's rating is recalculated automatically\n- **Become a partner** — service centers apply through a public form; an admin reviews and approves them\n- **Email notifications** — booking confirmation/cancellation to the shop, password reset, contact messages (via Nodemailer/Mailtrap)\n- **Profile \u0026 avatar** — edit account details and upload a profile photo\n- **Forgot / reset password** — secure email-based flow\n- **Guest mode** — browse public content without registration\n- **FAQ \u0026 Contact** — informational pages with a working contact form\n- **Automated tests** — Vitest unit tests on both client and server\n\n---\n\n## Tech Stack\n\n**Frontend**\n\n- React 19 + TypeScript + Vite\n- React Router v7\n- SCSS Modules (BEM) + Tailwind CSS\n- React Hook Form + Zod\n- Vitest\n\n**Backend**\n\n- Node.js + Express + TypeScript\n- MongoDB + Mongoose (7 collections)\n- JWT (access token + httpOnly refresh cookie) + bcrypt\n- Google Gemini 2.5 Flash (structured JSON output)\n- Nodemailer + Mailtrap\n- Cloudinary + Multer\n- Zod validation, rate limiting\n- Vitest\n\n---\n\n## Pages\n\n- **Dashboard** — landing with quick links and a \"how it works\" overview\n- **Auth** — login, register, forgot password, reset password\n- **Vehicles** — list, add, detail (with service history)\n- **Problem reports** — list, new (AI analysis), detail (recommended centers)\n- **Service centers** — list \u0026 filter, detail (free slots + reviews), become a partner\n- **Bookings** — list, new, complete \u0026 leave a review\n- **Profile** — account details and avatar\n- **FAQ** \u0026 **Contact**\n- **Admin panel** — create, edit, approve and delete service centers; regenerate time slots\n\n---\n\n## Project Structure\n\n```\nauto-service-platform/\n├── client/          # React frontend (Vite)\n└── server/          # Express backend (REST API)\n```\n\n---\n\n## Documentation\n\n- [Architecture \u0026 technical reference](docs/ARCHITECTURE.md) — data models, REST API, AI flow and the full page list\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 20+\n- MongoDB (local or Atlas)\n- Google Gemini API key — [aistudio.google.com](https://aistudio.google.com)\n\n### Setup\n\n```bash\n# Clone\ngit clone https://github.com/kvalkanovaa/auto-service-platform.git\ncd auto-service-platform\n\n# Install dependencies\ncd server \u0026\u0026 npm install\ncd ../client \u0026\u0026 npm install\n\n# Configure environment\ncp server/.env.example server/.env\n# Fill in: MONGODB_URI, JWT_SECRET, JWT_REFRESH_SECRET, GEMINI_API_KEY, CLOUDINARY_*, MAILTRAP_*\n```\n\n### Run locally\n\n```bash\n# Terminal 1 — backend (port 5000)\ncd server \u0026\u0026 npm run dev\n\n# Terminal 2 — frontend (port 5173)\ncd client \u0026\u0026 npm run dev\n```\n\n### Tests\n\n```bash\ncd server \u0026\u0026 npm test    # backend unit tests\ncd client \u0026\u0026 npm test    # frontend unit tests\n```\n\n---\n\n## User Roles\n\n| Role    | Access                                                                            |\n| ------- | --------------------------------------------------------------------------------- |\n| `user`  | Vehicle management, AI problem reports, bookings, reviews                         |\n| `admin` | All of the above + service center management and approval of partner applications |\n\nService centers join by submitting a public **\"Become a partner\"** application, which becomes visible only after an admin approves it.\n\n---\n\n## Author\n\n**Kalina Valkanova** — [GitHub](https://github.com/kvalkanovaa) · [LinkedIn](https://www.linkedin.com/in/kalina-valkanova/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvalkanovaa%2Fauto-service-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkvalkanovaa%2Fauto-service-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvalkanovaa%2Fauto-service-platform/lists"}