Artifact 616b3d57d5bf7d805487322c2dad4c3b96bdb62b61abd515af20cad9d160ee7e:
- File
README.md
— part of check-in
[5bb18ed4d4]
at
2026-10-23 03:34:10
on branch trunk
— 把来肯对接和本地库落到可切换的后端。
账号从环境读取，商品由人工增量同步，订单按五分钟轮询并缓存登录会话。开发期用 SQLite，同一套结构可切到 PostgreSQL。 (user: pluto size: 2634)
# SwiftFlow SwiftFlow 是一个基于 Monorepo（单仓库）架构的全端系统，后端采用 **Gleam** 开发，多端应用统一协同。 ## 目录结构规划 ```text SwiftFlow/ ├── backend/ # 后端服务（基于 Gleam，负责核心业务逻辑与 API 提供） ├── web/ # Web 前端（基于 Vite 构建，支持 SPA / SSR） ├── miniapp/ # 小程序端（微信小程序 / Uni-app / Taro 等） ├── desktop/ # 客户端 / 桌面端（支持 macOS、Windows） │ ├── macos/ # macOS 客户端配置/原生工程（或统一跨端如 Tauri） │ └── windows/ # Windows 客户端配置/原生工程 ├── mobile/ # APP 端（移动端，支持 iOS、Android） │ ├── ios/ # iOS 工程（原生或跨端壳） │ └── android/ # Android 工程（原生或跨端壳） ├── shared/ # 跨端共享层（协议定义、通用类型、通用工具库） │ └── ql361api/ # 第三方/外部 API 对接或特定公共模块 └── docs/ # 项目综合文档库 ├── architecture/ # 架构设计与技术选型文档 ├── api/ # API 接口规范与契约文档 └── guides/ # 开发规范、环境搭建与部署指南 ``` ## 技术栈与端侧定位 | 端侧 | 目录 | 推荐/采用技术栈 | 说明 | | :--- | :--- | :--- | :--- | | **后端** | `backend/` | Gleam (Mist / Wisp / Bandit) | 强类型、函数式、高并发 BEAM 生态 | | **Web端** | `web/` | Vite + React / Vue / Lustre | 现代化前端工程，负责桌面/移动浏览器访问 | | **小程序端** | `miniapp/` | Uni-app / Taro / 微信原生 | 覆盖微信生态及国内小程序平台 | | **客户端** | `desktop/` | Windows & macOS (建议 Tauri / Rust) | 性能高效、体积轻量，复用前端能力 | | **APP端** | `mobile/` | iOS & Android (Flutter / React Native / Tauri Mobile) | 移动端原生体验 | | **共享层** | `shared/` | OpenAPI / Gleam types / TS types | 跨端通信协议、接口类型定义 | | **文档** | `docs/` | Markdown 文档体系 | 架构、API、开发指南 | --- ## 快速指引 - **文档中心**：查看 [`docs/README.md`](file:///Users/pluto/MyProject/NMProject/fosi.dev/SwiftFlow/docs/README.md) - **后端开发**：请进入 [`backend/`](file:///Users/pluto/MyProject/NMProject/fosi.dev/SwiftFlow/backend) - **Web 前端**：请进入 [`web/`](file:///Users/pluto/MyProject/NMProject/fosi.dev/SwiftFlow/web)