夏水仙是一个为跨性别者提供无障碍设施信息和互助信息的平台 💗
正式网站：lycoris-map.com。新 Web 提供地图、附近搜索、点位详情、收藏、贡献、账号与设置；后端使用 Rust。原生 iOS 工程位于 apps/ios/，旧 React Native 应用仅保留作历史参考。
下载 Lycoris 1.0.1 Android APK · SHA-256 校验文件 · 发布说明
本次版本为 Lycoris 1.0.1（versionCode 3），支持 Android 7.0 及以上，包含 arm64-v8a 和 x86_64 架构。APK 沿用 2026-09-06 开始使用的 Release 签名，可在真机侧载安装。
旧 v1.0 或此前开发包无法被本包覆盖安装，需先卸载旧包。卸载会清除本机登录状态、设置等应用数据。
2026-09-06 使用同一证书的 1.0.3 测试版（versionCode 2）可以直接覆盖更新，无需卸载。本次显示版本为 1.0.1，Android 用于判断更新顺序的 versionCode 已由 2 递增至 3。
此历史 APK 固定连接旧 API https://api.lycoris.online，旧后端已停用，不再作为可用客户端推荐。请使用新网站；下载链接仅作为历史发布归档。
- 标记：可以在地图上标注无障碍卫生间，友好医疗机构，母婴室等点位信息，包含名称 图片 开放时间等。
- 搜索附近：快速搜索定位点附近（可自定义搜索范围）的无障碍卫生间等信息。
- 收藏：可以把点位添加到自己的收藏列表中，需要时快速查看。
注意：添加或编辑点位需要管理员审核，这是为了防止被恶意破坏，敬请谅解。
以温柔与专业守护跨性别者的日常安全，让信息共享成为彼此的光。
所有跨性别都有权利生活在阳光下，自然的展示自己，不必躲闪，不必隐藏，堂堂正正，大大方方。每一个人都应当有平等的权益，跨性别者也不例外。
社会的进步是缓慢的，然而每一个微小的努力都会被看见。就从无障碍卫生间开始。
我们会搜集很多个无障碍卫生间，只要打开手机，就可以看到哪里可以上厕所。这样做，就可以让跨性别者，尽量不被误解、避免尴尬，能够放心大胆的出门。
你不是孤单的。 无论你现在处在探索、挣扎，还是重建生活的哪一步，你都值得被尊重、被认真对待。我们希望在你需要的时候，给你一点真实可用的支持，让你在现实世界里更安全一点、少受一点伤。
如果这盏小灯能在某个夜晚帮到你，那我们做的一切，就都值得。
开发者快速了解项目：Rust 后端说明。
- frontend：Web v2 新工程，React 19 + TypeScript 7 + Vite 8 + Tailwind 4（正式 Web，部署到 Cloudflare Pages）
- frontend-old：旧 Web 本地归档，已取消 Git 跟踪并加入
.gitignore；历史版本仍可从 Git 提取 - backend：Rust + Axum + SQLx（默认后端；无 ORM）
- backend-old：旧 Java / Spring Boot 本地归档，已取消 Git 跟踪并忽略；历史源码仍可从 Git 提取
- apps/ios：原生 Swift / SwiftUI iOS 应用；mobile 为仅本地保留的旧 React Native 应用
- 数据库：PostgreSQL + PostGIS；Redis 用于会话、缓存与限流
本项目采用 MIT License 开源。
本仓库已采用单仓库（Monorepo）结构，backend / frontend 在同一仓库中，backend-old/、frontend-old/ 和 mobile/ 仅保留本地并由 Git 忽略；apps/ios/ 为原生 iOS 工程。
| 组件 | 本仓库的要求 |
|---|---|
| JavaScript | Node.js 24.19.0（frontend/.nvmrc 已固定）与 pnpm 11.19.0（packageManager 已固定）。 |
| 后端 | rustup；进入 backend/ 后按 rust-toolchain.toml 使用 Rust 1.98.1。Windows 原生编译需 Visual Studio C++ Build Tools。后端不再要求 JDK/Maven。 |
| 数据库 | 本地 Compose 固定 PostgreSQL 18.6 + PostGIS 3.6.4；附近查询使用 PostGIS 候选筛选与距离计算。 |
| 缓存与会话 | 本地 Compose 固定 Redis 8.10.1；登录会话需要 Redis。 |
以下示例获取主分支：
git clone --branch main https://github.com/Eleanor1018/lycoris-map.git
cd lycoris-map已有仓库时切换到该分支再更新；本机配置和依赖分别安装，不要复制其他机器的 node_modules。
git switch main
git pull以下各节从仓库根目录开始操作。后端和网页分别保留在独立终端运行。
仓库与本地默认后端为 backend/（Axum + SQLx）。 线上 API https://api.lycoris-map.com 已运行于新服务器；backend-old/ 仅保留历史参考，不能直接重启旧数据库副本上的写入服务。
从仓库根目录启动本地 PostgreSQL / PostGIS 与 Redis（需要 Docker）：
docker compose -f backend/compose.test.yml up -d --waitRust 二进制读取进程环境变量，不自动加载 .env。完整变量见 backend/.env.example；下面使用 Compose 的空开发库示例，自定义本地数据库或上传目录时设置对应变量。
Windows PowerShell：
cd backend
$env:DATABASE_URL = 'postgres://lycoris:lycoris_local_test@127.0.0.1:55432/lycoris_rust'
$env:REDIS_URL = 'redis://127.0.0.1:56379'
$env:WRITE_ALLOWED_ORIGINS = 'http://localhost:5173,http://127.0.0.1:5173,https://localhost:5173,https://127.0.0.1:5173'
$env:SQLX_OFFLINE = 'true'macOS / Linux：
cd backend
export DATABASE_URL='postgres://lycoris:lycoris_local_test@127.0.0.1:55432/lycoris_rust'
export REDIS_URL='redis://127.0.0.1:56379'
export WRITE_ALLOWED_ORIGINS='http://localhost:5173,http://127.0.0.1:5173,https://localhost:5173,https://127.0.0.1:5173'
export SQLX_OFFLINE=true新开发库首次显式迁移，然后启动；日常只需最后一条命令：
cargo run --locked -- --migrate
cargo run --locked在 backend/ 内运行 Cargo，使用目录中固定的 Rust 工具链。默认服务地址为 http://127.0.0.1:8080，可访问 /health/ready 和 /api/markers/public 检查服务；新开发库返回空列表正常。普通启动只读校验迁移状态，不自动建表；已有 Java 数据库按 Rust 基线接管说明 处理。
Web 的 /api 与 /uploads 经 Vite 同源代理访问 Rust。若页面端口或域名改变，需调整 WRITE_ALLOWED_ORIGINS；真机联调另需设置 SERVER_HOST=0.0.0.0 并使用电脑局域网地址。
Python 开发脚本与根 docs/ 文档仅保留本地，不随 Git 分发。已有本地 run-local.py 仍可读取自己的 .env 运行；新拉取仓库使用上面的 Cargo 命令，不需要 Python。详细配置与测试见 Rust 后端说明。
frontend/是唯一正式 Web 工程。 开发、测试和部署均使用这个目录。部署配置见 Cloudflare 说明。
在新的终端，从仓库根目录执行：
cd frontend
pnpm install
pnpm dev开发服务器固定为 http://127.0.0.1:5173（strictPort，避免自动换端口导致后端 Cookie/写入来源白名单失配）。Vite 将 /api、/uploads 与仅用于本机诊断的 /health 同源代理到本地 Rust 后端 http://127.0.0.1:8080，代理目标为本机固定值，不读取环境变量、不配置服务器地址或密钥，也不改写 Origin。
构建和检查：
pnpm build
pnpm typecheck
pnpm format:check
pnpm test:unit静态产物在 frontend/dist/。本工程不包含 ESLint 或 lint 脚本，类型边界由 TypeScript 7 strict 检查负责。
Cloudflare Pages 的 Git 集成跟踪 main，构建根目录为 frontend/，输出为 dist/。测试和类型检查成功后发布静态资源及同源 API 代理。开发分支推送用于预览，合并 PR 后触发正式站点更新；无需手动上传 ZIP。
/__dev/map-spike、/__dev/qa、/__dev/places-performance 是仅开发模式按需加载的合成数据诊断页，不进入正式应用构建。旧 frontend-old/ 保留在已有本机副本中，新克隆不再包含它；需要历史代码时从切换前的 Git 提交提取。
原生 iOS 工程与运行说明见 apps/ios/README.md。Android 原生应用后续开发。旧 mobile/ 目录由 Git 忽略；上方 APK 链接仅保留历史发布记录。