# vibe-coding-103 **Repository Path**: EverywhereGodLantern/vibe-coding-103 ## Basic Information - **Project Name**: vibe-coding-103 - **Description**: 戴威共享单车David Bike，包括用户端和平台端，技术栈：go+flutter+typescript - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-14 - **Last Updated**: 2026-06-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # vibe-coding-103 ## 戴威共享单车 DavidBike 基于 Flutter + React + Go + TypeScript 的共享单车系统。 ## 效果图 > 说明：目前第一期，先实现到这个程度，第二期完善后面的todo，因为是linux环境 ，微信小程序还没联调测试，后面有钱买了新电脑再更新截图以及安卓和IOS应用截图 ![截图](docs/images/Snipaste_2026-06-28_20-52-04.png) ![截图](docs/images/Snipaste_2026-06-28_20-52-35.png) ![截图](docs/images/Snipaste_2026-06-28_20-52-43.png) ![截图](docs/images/Snipaste_2026-06-28_20-52-51.png) ![截图](docs/images/Snipaste_2026-06-28_20-52-58.png) ![截图](docs/images/Snipaste_2026-06-28_20-53-05.png) ![截图](docs/images/Snipaste_2026-06-28_20-53-11.png) ![截图](docs/images/Snipaste_2026-06-28_20-53-18.png) ![截图](docs/images/Snipaste_2026-06-28_20-53-45.png) ![截图](docs/images/Snipaste_2026-06-28_20-56-18.png) ![截图](docs/images/Snipaste_2026-06-28_20-56-30.png) ![截图](docs/images/Snipaste_2026-06-28_20-56-38.png) ![截图](docs/images/Snipaste_2026-06-28_20-56-45.png) ![截图](docs/images/Snipaste_2026-06-28_20-56-53.png) ![截图](docs/images/Snipaste_2026-06-28_20-57-08.png) ![截图](docs/images/Snipaste_2026-06-28_20-57-15.png) ![截图](docs/images/Snipaste_2026-06-28_20-58-58.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-03.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-18.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-24.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-34.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-41.png) ![截图](docs/images/Snipaste_2026-06-28_20-59-48.png) ![截图](docs/images/Snipaste_2026-06-28_21-00-01.png) ![截图](docs/images/Snipaste_2026-06-28_21-00-14.png) ## 项目结构 ``` ├── _workspace/ │ ├── app/ # Flutter 移动端 │ ├── admin/ # React 管理后台 │ ├── backend/ # Go 后端 API │ ├── official-website/ # 静态官网 (HTML) │ ├── official-website-vue/ # Vue 3 官网 │ └── mini-program/ # 微信小程序 ├── docs/ # PRD 需求文档 └── design/ # UI 设计稿 ``` --- ## 后端 (Go) **目录**: `_workspace/backend` ### 环境要求 - Go 1.24+ - MySQL 8.0+ - Redis 7.0+ ### 常用命令 ```bash cd _workspace/backend # 安装依赖 go mod download # 配置 cp config.yml.example config.yml # 编辑数据库/Redis连接信息 # 开发运行（热重载，需要 air） make dev # 直接运行 make run # 构建 make build # 输出: ofo-api # 测试 make test # 全量测试 make test-coverage # 测试 + 覆盖率报告 make test-check # 测试 + 覆盖率 ≥70% 检查 # 代码质量 make fmt # 格式化 make vet # 静态分析 make lint # golangci-lint # Swagger 文档 make swagger # 生成到 docs/swagger/ # 数据库 make migrate # 运行迁移 make seed # 初始化数据 ``` ### 创建管理员账号 ```bash cd _workspace/backend go run ./cmd/create_admin \ -username admin \ -password 123456 \ -real-name "管理员" \ -role 1 # 完整参数 # -username (必填) 用户名 # -password (必填) 密码 # -real-name 真实姓名 # -email 邮箱 # -phone 手机号 # -role 1=超级管理员 2=管理员(默认) # -config 配置文件路径(默认 config.yml) ``` --- ## Flutter APP **目录**: `_workspace/app` ### 环境要求 - Flutter 3.44.x - Dart SDK >=3.10.0 ### 常用命令 ```bash cd _workspace/app # 安装依赖 flutter pub get # 代码生成（freezed/json_serializable） dart run build_runner build --delete-conflicting-outputs # 运行 flutter run -d linux # Linux 桌面 flutter run -d android # Android 设备 flutter run -d ios # iOS 设备 flutter run -d chrome # Web（实验性） # 代码分析 flutter analyze # 测试 flutter test # 全量测试 flutter test --coverage # 带覆盖率 # 构建之前接收许可证 sdkmanager --sdk_root=$ANDROID_HOME --licenses # 构建 flutter build apk --debug # Android Debug APK flutter build apk --release # Android Release APK flutter build appbundle --release # Android App Bundle flutter build linux --release # Linux Release flutter build web --release # Web ``` ### 环境变量 ```bash # 通过 --dart-define 传入 flutter run -d linux \ --dart-define=AMAP_KEY=your_key \ --dart-define=API_BASE_URL=https://api.example.com/v1 \ --dart-define=MOCK_ENABLED=true ``` > Debug 构建默认启用 Mock 数据，无需后端即可运行。 --- ## React 管理后台 **目录**: `_workspace/admin` ### 环境要求 - Node.js 18+ - npm 9+ ### 常用命令 ```bash cd _workspace/admin # 安装依赖 npm install # 开发 npm run dev # Vite 开发服务器 # 构建 npm run build # TypeScript 编译 + Vite 构建 # 代码质量 npm run lint # ESLint 检查 npm run lint:fix # ESLint 自动修复 npm run format # Prettier 格式化 npm run type-check # TypeScript 类型检查 # 测试 npm run test # Vitest 运行 npm run test:watch # 监听模式 npm run test:coverage # 覆盖率报告 ``` --- ## Vue 3 官网 **目录**: `_workspace/official-website-vue` ### 环境要求 - Node.js 18+ - npm 9+ ### 常用命令 ```bash cd _workspace/official-website-vue # 安装依赖 npm install # 开发 npm run dev # Vite 开发服务器 # 构建 npm run build # Vite 生产构建 # 预览 npm run preview # 预览生产构建 ``` --- ## 静态官网 **目录**: `_workspace/official-website` 纯 HTML + CSS + JS，无需构建，直接用浏览器打开 `index.html`。 --- ## 微信小程序 **目录**: `_workspace/ofo-applet` 使用微信开发者工具打开 `project.config.json` 即可运行。 --- ## Docker 部署 ```bash cd _workspace # 启动所有服务 docker-compose up -d # 查看日志 docker-compose logs -f backend # 停止 docker-compose down ``` --- ## 贡献指南 1. Fork 本仓库 2. 创建功能分支: `git checkout -b feature/xxx` 3. 提交代码并编写测试 4. 通过所有 CI 检查 5. 创建 Pull Request ### Commit 规范 ``` feat(bike): 实现扫码开锁API fix(payment): 修复支付回调验签失败问题 docs(api): 更新Swagger文档 ``` #### UI设计 + [ofo小黄车 app 2.0 Update](https://www.zcool.com.cn/work/ZMjI1MDQ5MDA=.html) + [ofo小黄车 国际版 2.0 全新升级](https://www.zcool.com.cn/work/ZMjQ4NzI0NjQ=.html) #### 需求设计 + [ofo小黄车产品体验报告](https://www.cnblogs.com/zgq123456/articles/10232750.html) #### 同类产品 + [芒果电单车](https://mangoebike.com/download.html) + [雷风行共享电单车](https://www.letfungo.com/) + [小安科技](https://www.xiaoantech.com/) #### 待办事项 1. 支付宝沙箱支付流程写完了还没测试 2. 目前UI与设计高保真效果图还有差距，后续还需要仔细打磨下 3. 微信小程序联调测试 4. 自行车模拟器还没实现，后续计划使用flutter实现一个模拟器，可以模拟单个，也可以并发模拟N台自行车，随机骑行时长、自动换车、自动支付、上报模拟位置，后台可实时查看当前收入、自行车状态。自行车与平台接入目前采用coap协议（后续考虑接入GTP，作为GTP案例项目之一）。 5. 运营营销模块搭建，优惠券、邀请好友、月卡、季卡、年卡、周边商城（考虑做另一个）等 #### 提示词 ``` 请先帮我设计这个项目的 Claude Code harness。 先别着急建文件,先给我一份设计方案: 1. 项目目标推断 2. 需要哪些 agents 3. 需要哪些 skills 4. workflow 流程 5. CLAUDE.md 规则 6. _workspace 标准 审核通过后再生成实际文件。 敏感信息不要写入。 ```