| | |
|---|
| | | # XPeng Robotaxi |
|---|
| | | # Xp Robotaxi |
|---|
| | | |
|---|
| | | 基于 Spring Cloud Alibaba 的 Robotaxi 微服务系统，面向自动驾驶出行场景，包含账户、订单、地图、自动驾驶、远程驾驶等业务域，以及一组对应的 Spring Boot 应用（`xp-robotaxi-*-boot`）用于实际部署。 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 一、技术栈概览 |
|---|
| | | ## Getting started |
|---|
| | | |
|---|
| | | - Java 8 |
|---|
| | | - Spring Boot 2.7.7 |
|---|
| | | - Spring Cloud 2021.0.5 |
|---|
| | | - Spring Cloud Alibaba 2021.0.4.0 |
|---|
| | | - Nacos（注册中心 / 配置中心） |
|---|
| | | - Sentinel（流量控制与熔断降级） |
|---|
| | | - Seata（分布式事务） |
|---|
| | | - MyBatis-Plus（ORM） |
|---|
| | | - Druid（数据库连接池） |
|---|
| | | - Swagger / Springfox（接口文档） |
|---|
| | | - Redis、MySQL、MongoDB 等 |
|---|
| | | To make it easy for you to get started with GitLab, here's a list of recommended next steps. |
|---|
| | | |
|---|
| | | --- |
|---|
| | | Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)! |
|---|
| | | |
|---|
| | | ## 二、顶层模块结构 |
|---|
| | | ## Add your files |
|---|
| | | |
|---|
| | | 根工程 `robotaxi` 下包含以下子模块： |
|---|
| | | - [ ] [Create](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#create-a-file) or [upload](https://docs.gitlab.com/ee/user/project/repository/web_editor.html#upload-a-file) files |
|---|
| | | - [ ] [Add files using the command line](https://docs.gitlab.com/ee/gitlab-basics/add-file.html#add-a-file-using-the-command-line) or push an existing Git repository with the following command: |
|---|
| | | |
|---|
| | | - `xp-robotaxi-api`：对外和内部共享的 API、DTO、proto 风格 VO 定义 |
|---|
| | | - `xp-robotaxi-common`：公共能力（日志、权限、安全、数据源、Redis 等） |
|---|
| | | - 一组 `xp-robotaxi-*-boot`：每个业务域对应的 Spring Boot 应用，可独立部署 |
|---|
| | | ``` |
|---|
| | | cd existing_repo |
|---|
| | | git remote add origin http://gitlab.xiaopeng.local:18080/robotaxi1/xp-robotaxi.git |
|---|
| | | git branch -M master |
|---|
| | | git push -uf origin master |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 下面重点说明各个 `boot` 模块的功能职责。 |
|---|
| | | ## Integrate with your tools |
|---|
| | | |
|---|
| | | --- |
|---|
| | | - [ ] [Set up project integrations](http://gitlab.xiaopeng.local:18080/robotaxi1/xp-robotaxi/-/settings/integrations) |
|---|
| | | |
|---|
| | | ## 三、Boot 应用模块职责 |
|---|
| | | ## Collaborate with your team |
|---|
| | | |
|---|
| | | ### 1. xp-robotaxi-gateway-boot（网关应用） |
|---|
| | | - [ ] [Invite team members and collaborators](https://docs.gitlab.com/ee/user/project/members/) |
|---|
| | | - [ ] [Create a new merge request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html) |
|---|
| | | - [ ] [Automatically close issues from merge requests](https://docs.gitlab.com/ee/user/project/issues/managing_issues.html#closing-issues-automatically) |
|---|
| | | - [ ] [Enable merge request approvals](https://docs.gitlab.com/ee/user/project/merge_requests/approvals/) |
|---|
| | | - [ ] [Set auto-merge](https://docs.gitlab.com/ee/user/project/merge_requests/merge_when_pipeline_succeeds.html) |
|---|
| | | |
|---|
| | | - 基于 Spring Cloud Gateway 的统一入口网关 |
|---|
| | | - 负责路由转发、鉴权校验、限流熔断、灰度发布 |
|---|
| | | - 统一接入层日志与基本安全控制 |
|---|
| | | ## Test and Deploy |
|---|
| | | |
|---|
| | | ### 2. xp-robotaxi-account-boot（账户中心） |
|---|
| | | Use the built-in continuous integration in GitLab. |
|---|
| | | |
|---|
| | | - 账户/用户域的对外应用 |
|---|
| | | - 用户注册登录、账号信息管理、角色与权限管理 |
|---|
| | | - 为管理后台和其他业务服务提供账户相关 REST 接口 |
|---|
| | | - [ ] [Get started with GitLab CI/CD](https://docs.gitlab.com/ee/ci/quick_start/index.html) |
|---|
| | | - [ ] [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/ee/user/application_security/sast/) |
|---|
| | | - [ ] [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/ee/topics/autodevops/requirements.html) |
|---|
| | | - [ ] [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/ee/user/clusters/agent/) |
|---|
| | | - [ ] [Set up protected environments](https://docs.gitlab.com/ee/ci/environments/protected_environments.html) |
|---|
| | | |
|---|
| | | ### 3. xp-robotaxi-automatic-pilot-boot（自动驾驶业务） |
|---|
| | | *** |
|---|
| | | |
|---|
| | | - Robotaxi 自动驾驶业务对外应用 |
|---|
| | | - 负责云端与 XPU 的消息交互（MQTT / Kafka），包括下行指令和上行状态 |
|---|
| | | - 订单与自动驾驶系统联动（创建任务、控制任务、状态应答等） |
|---|
| | | - 封装自动驾驶相关业务接口，供运营平台和其他服务调用 |
|---|
| | | # Editing this README |
|---|
| | | |
|---|
| | | ### 4. xp-robotaxi-itinerary-boot（行程管理） |
|---|
| | | When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template. |
|---|
| | | |
|---|
| | | - 行程生命周期管理应用 |
|---|
| | | - 行程创建、修改、取消 |
|---|
| | | - 行程状态跟踪、历史行程查询 |
|---|
| | | - 与订单、地图等服务协同进行路径规划与调度 |
|---|
| | | ## Suggestions for a good README |
|---|
| | | |
|---|
| | | ### 5. xp-robotaxi-maintenance-boot（运维与车辆维护） |
|---|
| | | Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information. |
|---|
| | | |
|---|
| | | - 车辆运维与保障相关应用 |
|---|
| | | - 车辆维护计划、保养记录、故障报修流程 |
|---|
| | | - 保单管理和维修记录追踪 |
|---|
| | | - 为运营平台提供车辆健康状态和维护数据 |
|---|
| | | ## Name |
|---|
| | | Choose a self-explaining name for your project. |
|---|
| | | |
|---|
| | | ### 6. xp-robotaxi-map-boot（地图与位置服务） |
|---|
| | | ## Description |
|---|
| | | Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors. |
|---|
| | | |
|---|
| | | - 地图与位置相关应用 |
|---|
| | | - 路线规划、距离与时间预估 |
|---|
| | | - POI 查询、地理围栏管理 |
|---|
| | | - 与自动驾驶、行程、订单等服务协同提供位置能力 |
|---|
| | | ## Badges |
|---|
| | | On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge. |
|---|
| | | |
|---|
| | | ### 7. xp-robotaxi-operation-boot（运营管理） |
|---|
| | | ## Visuals |
|---|
| | | Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method. |
|---|
| | | |
|---|
| | | - 平台运营域应用 |
|---|
| | | - 车辆调度策略、运营数据统计与报表 |
|---|
| | | - 价格策略配置、优惠活动管理 |
|---|
| | | - 支持运营后台对 Robotaxi 业务进行集中管理 |
|---|
| | | ## Installation |
|---|
| | | Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection. |
|---|
| | | |
|---|
| | | ### 8. xp-robotaxi-order-boot（订单服务） |
|---|
| | | ## Usage |
|---|
| | | Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README. |
|---|
| | | |
|---|
| | | - 订单全生命周期管理应用 |
|---|
| | | - 下单、改派、取消、完成等订单流程 |
|---|
| | | - 订单状态机与状态变更通知 |
|---|
| | | - 与支付、行程、自动驾驶等服务联动 |
|---|
| | | ## Support |
|---|
| | | Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc. |
|---|
| | | |
|---|
| | | ### 9. xp-robotaxi-payment-boot（支付与结算） |
|---|
| | | ## Roadmap |
|---|
| | | If you have ideas for releases in the future, it is a good idea to list them in the README. |
|---|
| | | |
|---|
| | | - 支付结算域应用 |
|---|
| | | - 集成微信等第三方支付渠道 |
|---|
| | | - 支付请求、退款、对账、结算与发票管理 |
|---|
| | | - 对订单服务提供支付能力，对财务提供对账数据 |
|---|
| | | ## Contributing |
|---|
| | | State if you are open to contributions and what your requirements are for accepting them. |
|---|
| | | |
|---|
| | | ### 10. xp-robotaxi-push-message-boot（消息推送） |
|---|
| | | For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self. |
|---|
| | | |
|---|
| | | - 消息通知与推送应用 |
|---|
| | | - 支持短信、APP 推送、邮件、站内信等多种渠道 |
|---|
| | | - 提供统一消息模板与发送接口 |
|---|
| | | - 与订单、行程、运营等服务集成，实现业务事件触达用户 |
|---|
| | | You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser. |
|---|
| | | |
|---|
| | | ### 11. xp-robotaxi-remote-driving-boot（远程驾驶） |
|---|
| | | ## Authors and acknowledgment |
|---|
| | | Show your appreciation to those who have contributed to the project. |
|---|
| | | |
|---|
| | | - 云代驾 / 远程驾驶应用 |
|---|
| | | - 远程控制指令下发、实时状态回传 |
|---|
| | | - 支持紧急接管、远程辅助等场景 |
|---|
| | | - 与自动驾驶、行程、车辆状态服务协同 |
|---|
| | | ## License |
|---|
| | | For open source projects, say how it is licensed. |
|---|
| | | |
|---|
| | | ### 12. xp-robotaxi-vehicle-convoy-boot（车队管理） |
|---|
| | | |
|---|
| | | - 车队及编队管理应用 |
|---|
| | | - 车队组建与成员管理 |
|---|
| | | - 编队行驶控制与协同调度 |
|---|
| | | - 提供面向车队运营场景的接口能力 |
|---|
| | | |
|---|
| | | ### 13. xp-robotaxi-job-boot（定时任务） |
|---|
| | | |
|---|
| | | - 统一定时任务调度应用 |
|---|
| | | - 基于 Quartz，对多业务域的定时任务进行集中管理 |
|---|
| | | - 任务配置、执行监控、失败重试等 |
|---|
| | | |
|---|
| | | ### 14. xp-robotaxi-file-boot（文件服务） |
|---|
| | | |
|---|
| | | - 文件上传/下载/存储应用 |
|---|
| | | - 支持对象存储或分布式文件系统接入 |
|---|
| | | - 提供统一的文件访问域名与权限控制能力 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 四、基础能力模块概览 |
|---|
| | | |
|---|
| | | 虽然具体代码在 `xp-robotaxi-common` 与 `xp-robotaxi-api` 中，这里简要说明它们的角色，方便理解整体结构： |
|---|
| | | |
|---|
| | | - `xp-robotaxi-common`：日志、安全、数据源、Redis、数据权限、分布式事务等通用能力 |
|---|
| | | - `xp-robotaxi-api`：对各个 boot 应用暴露的统一 API/DTO/VO 定义，是服务间通信的契约层 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 五、运行与部署提示（概览） |
|---|
| | | |
|---|
| | | - 所有 `xp-robotaxi-*-boot` 模块均为独立 Spring Boot 应用，可按需选择部署 |
|---|
| | | - 网关（`xp-robotaxi-gateway-boot`）通常需要多实例部署以保证高可用 |
|---|
| | | - 订单、支付、自动驾驶、运营等核心域建议根据业务量做水平扩展 |
|---|
| | | - Nacos / Sentinel / Seata 等基础组件需先行部署，并在各 boot 应用中配置好连接信息 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | *文档更新时间: 2026-02-06* |
|---|
| | | ## Project status |
|---|
| | | If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers. |
|---|
