Skip to content

Conversation

@naoki-00-ito
Copy link
Member

This pull request introduces several documentation and developer experience improvements, adds new scripts for running the API and mobile app, and updates OpenAPI references throughout the project. The most significant changes are updates to the workflow and instructions for consistency, new Makefile targets for easier development, and enhancements to API documentation and sample endpoints.

Documentation and Workflow Updates

  • Updated all references to OpenAPI 3.0.3 to OpenAPI 3.0.0 in README.md, api/README.md, and .github/copilot-instructions.md to ensure consistency across documentation and scripts. [1] [2] [3] [4] [5] [6]
  • Expanded and clarified setup, build, validation, and troubleshooting instructions in .github/copilot-instructions.md, including environment requirements, workflow timeouts, and manual validation scenarios. [1] [2] [3] [4] [5] [6] [7] [8] [9]

Developer Experience Improvements

  • Added new Makefile targets: run_api_dev for running the Go API server with automatic Swagger UI launch, and run_mobile_app for starting the mobile app, streamlining local development.
  • Added .env to api/.gitignore to prevent accidental commits of sensitive environment configuration.
  • Added a VSCode spell-check configuration for project-specific terms.

API Documentation and Sample Endpoints

  • Added a new getHealth endpoint in api/health.go for health checks, including Swagger documentation comments.
  • Updated api/main.go to load environment variables from .env using godotenv and refactored imports for clarity. [1] [2]
  • Added new endpoints in API documentation for bicycle route search and destination candidate retrieval, and clarified sample endpoints.

README and Project Overview Enhancements

  • Significantly expanded the project overview, features, and motivation in README.md, including diagrams, screenshots, and detailed descriptions of supported data sources and open data integration. [1] [2] [3] [4] [5]

Dependency and Configuration Updates

  • Added new Go dependencies: github.com/google/uuid and github.com/joho/godotenv for improved API functionality and configuration management.

These changes collectively improve onboarding, developer workflow, API clarity, and project documentation.

naoki-00-ito and others added 30 commits August 17, 2025 22:26
make run_api_dev
Catch SIGINT in run_api_dev
🐞 fix(#9): mock test コマンド変更
…y/charimachi into feature/api-specifications

# Conflicts:
#	openapi-specifications/api.swagger.json
/api/v1/directions/bicycle
Without Route adjustment
naoki-00-ito and others added 27 commits August 24, 2025 00:59
✨ feat(#36): 違反件数と違反率を表示
📃 docs: Open Data usage
📃 docs: add res open data
📃 docs: update demo section in README and add demo GIF
@naoki-00-ito naoki-00-ito self-assigned this Aug 24, 2025
@naoki-00-ito naoki-00-ito merged commit 3043729 into main Aug 24, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants