Go4-Group-Project
一个使用 Flutter 前端和 Node.js 后端构建的多模态零售指南移动应用。通过 Docker 协调,利用 Gemini 和 Serper API 实现 AI 驱动的产品搜索。
- 星标
- 4
- 复刻
- 1
- 最近推送(UTC)
- 2026年9月19日
- 项目状态
- 未归档
原始 README
以下为英文项目原文快照,最新内容请访问 GitHub。
Overview
Go4 is a comprehensive, multimodal retail guide mobile application designed to enhance the shopping experience through artificial intelligence . The system utilizes advanced AI models and a robust full-stack architecture to provide users with intelligent product searching, personalized recommendations, and real-time mapping capabilities .
The application is split into a scalable, containerized backend and a cross-platform mobile frontend, ensuring a seamless and responsive user experience across both Android and iOS devices .
Architecture & Infrastructure
The project follows a decoupled client-server architecture, prioritizing modularity and scalable deployment :
- Backend API: A Node.js application responsible for handling core business logic, user authentication, and third-party API integrations .
- Cross-Platform Client: A Flutter-based mobile application that consumes the backend services and handles complex UI states across various feature modules .
- Containerization: The entire backend ecosystem is orchestrated using Docker, with both standard (
docker-compose.yml) and production-ready (docker-compose.prod.yml) configurations ensuring consistent deployment environments . - CI/CD Pipeline: Automated workflows for deployment and APK release generation are managed via GitHub Actions (
deploy.yml,release-apk.yml) .
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Flutter (Dart), targeting Android and iOS |
| Backend | Node.js (REST API architecture) |
| AI & Search Services | Gemini API, Serper API |
| DevOps | Docker, GitHub Actions |
Core Features
Based on the application's underlying architecture, Go4 delivers several key functionalities:
- Multimodal AI Integration: The backend features dedicated services for Gemini API integration (
geminiService.js,geminiEnrichService.js,geminiFilterService.js) to process complex user queries and intelligently filter results . Additionally, atranscriptionService.jsindicates support for voice-based or audio-driven input . - Intelligent Search & Discovery: The application leverages the Serper API (
serperService.js) alongside custom search routes (search.js) and product endpoints (product.js) to locate items efficiently . - Personalization Engine: A dedicated
preferenceLearningService.json the backend works in tandem with user preference models to deliver tailored content via the recommendations route (recommendations.js) and frontend screens (recommendations_screen.dart) . - Location & Mapping: Users can visualize places and retail locations through the backend
places.jsroute, rendered on the frontend via an interactive Map module (map_screen.dart) . - User Management & State: The frontend utilizes comprehensive provider patterns (
auth_provider.dart,search_provider.dart,wishlist_provider.dart) to manage user profiles, authentication, search histories, and personal wishlists seamlessly .
File Structure Highlights
The repository maintains a clean separation of concerns, heavily utilizing modular structures for both the frontend and backend :
Go4-Group-Project/
├── backend/ ← Node.js API Service
│ ├── Dockerfile ← Backend container definition
│ ├── middleware/ ← Request interceptors (e.g., auth.js)
│ ├── models/ ← Data schemas (User, SearchHistory, UserPreferences)
│ ├── routes/ ← API endpoints (auth, analyze, product, places)
│ └── services/ ← Core AI logic (Gemini, Serper, Transcription)
│
├── frontend/ ← Flutter Mobile App
│ ├── android/ & ios/ ← Native platform configurations
│ ├── lib/
│ │ ├── core/ ← API clients, routing, and theme utilities
│ │ ├── features/ ← UI Modules (home, map, profile, wishlist, results)
│ │ ├── models/ ← Dart data classes (product, search_tag, history_item)
│ │ └── providers/ ← Application state management
│ └── pubspec.yaml ← Flutter dependencies
│
├── docker-compose.yml ← Development orchestration
└── .github/workflows/ ← CI/CD automation pipelines
分类
如何选择适合项目的代码仓?
先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。
- 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
- 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
- 使用前在 GitHub 核对 README、许可证与 Issues。
来源与维护
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗