photo-map-app

一个基于地理位置管理照片的全栈应用,支持上传、地图展示和评分。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:photo-map-app。
它的用途是:一个基于地理位置管理照片的全栈应用,支持上传、地图展示和评分。
完整的 Skill 内容见:https://321skill.com/skills/photo-map-app/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我需要一个能在地图上展示我旅行照片的项目原型,要能自动读取照片位置。”,它会推荐你使用Photo Map MVP,并指导你通过提供的脚本快速搭建起包含前端地图组件、后端EXIF解析和数据库的完整可运行项目。

介绍

Photo Map MVP 是一个解决用户如何有效管理和可视化带有地理位置信息照片的应用。它允许用户上传照片,自动从EXIF数据中提取GPS坐标和拍摄日期,并在交互式地图上精确展示照片位置,同时提供照片评分功能。

使用方式非常便捷,项目提供了从一键脚本部署到手动配置的多种选择。推荐使用快速安装脚本,该脚本能自动完成数据库初始化、环境配置和前后端服务的启动,用户只需修改配置文件中的关键参数即可。

该应用非常适合全栈开发者、个人项目实践者以及对地理信息可视化感兴趣的内容创作者。它提供了一个完整、现代化的技术栈实践案例,涵盖了从前端交互到后端数据处理的全流程。

需要注意的是,该应用为MVP(最小可行产品)版本,功能相对聚焦。部署前请确保已安装Docker和Node.js等必要环境,并妥善保管配置文件中的JWT密钥和数据库密码。

核心特点

核心区别在于其完整且现代化的全栈技术实现(Angular 18 + Spring Boot 3),并深度集成了照片EXIF元数据(尤其是GPS)的自动提取与地图可视化功能,而非简单的文件管理。同时,它内置了基于权限的用户评分系统,提供了从数据处理到交互的闭环体验。

注意事项

不适合需要复杂照片编辑、高级社交功能或大规模商业部署的场景。

常见问题

如何快速启动Photo Map应用?

克隆仓库后,复制.env.example为.env并填写配置,然后运行 `./scripts/reset-data.sh` 和 `./scripts/start-dev.sh` 即可一键启动所有服务。

这个应用支持哪些照片格式?

支持常见的JPEG等格式,后端使用metadata-extractor库自动解析包含EXIF GPS信息的照片。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/photo-map-app/raw/index.md 读取 photo-map-app 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。