Нема описа

zyh fe29011dbc 更新 README.md,添加平台部署说明和在 D8D 平台运行的详细步骤,增强用户对应用创建和运行的理解。 пре 8 месеци
asset 5ddef63040 init пре 8 месеци
README.md fe29011dbc 更新 README.md,添加平台部署说明和在 D8D 平台运行的详细步骤,增强用户对应用创建和运行的理解。 пре 8 месеци
app.tsx 6c6bcb9857 init пре 8 месеци
deno.json 6c6bcb9857 init пре 8 месеци
deno.lock 6c6bcb9857 init пре 8 месеци
migrations.ts 6c6bcb9857 init пре 8 месеци
routes_auth.ts 6c6bcb9857 init пре 8 месеци
routes_charts.ts 6c6bcb9857 init пре 8 месеци
routes_maps.ts 6c6bcb9857 init пре 8 месеци
routes_sys.ts 6c6bcb9857 init пре 8 месеци
routes_users.ts 6c6bcb9857 init пре 8 месеци

README.md

管理端与移动端启动模板 (Admin-Mobile Starter)

项目概述

这是一个基于 Deno 和 Hono 框架开发的管理系统与移动端应用启动模板,提供了完整的用户认证、权限管理、系统设置、文件上传、地图组件、图表组件等功能,可以快速构建企业级应用。

技术栈

  • 后端框架:Deno + Hono
  • 前端框架:React 19 + Ant Design 5
  • 状态管理:TanStack Query
  • 认证系统@d8d-appcontainer/auth
  • API客户端@d8d-appcontainer/api
  • 地图组件:高德地图(支持在线/离线模式)
  • 图表组件:Ant Design Charts
  • 日期处理:Day.js
  • 网络请求:Axios

目录结构

  • asset/ - 前端资源文件
    • admin/ - 管理端资源
    • mobile/ - 移动端资源
    • share/ - 共享资源和类型定义
  • routes_*.ts - 各模块路由定义文件
  • app.tsx - 应用主入口
  • migrations.ts - 数据库迁移
  • deno.json - Deno配置文件

功能模块

  • 用户认证与管理 - 登录、注册、用户信息管理
  • 系统设置 - 站点信息、主题配置、全局参数设置
  • 文件管理 - 文件上传、分类管理
  • 地图组件 - 在线/离线地图、位置标记、地图交互
  • 图表组件 - 数据可视化图表
  • 移动端适配 - 响应式设计,支持移动端访问

平台部署说明

本应用在 D8D开发者平台 上可以直接运行,无需复杂部署:

  1. 访问 www.d8d.fun 网站并注册账号
  2. 登录后进入开发者控制台
  3. 点击"创建应用"按钮创建新应用
  4. 选择"管理端与移动端启动模板"作为应用模板
  5. 配置应用基本信息(名称、描述等)
  6. 完成创建后,直接点击"预览"按钮即可运行应用,无需额外部署步骤
  7. 系统会自动初始化并启动应用,可直接在浏览器中访问和使用

快速开始

环境要求

  • Deno 2.2.8 或更高版本
  • 数据库(由 @d8d-appcontainer/api 支持的数据库)

环境变量配置

在启动应用前,可配置以下环境变量:

# 应用配置
APP_NAME=应用名称
ENV=development
JWT_SECRET=your-jwt-secret-key

# OSS配置
OSS_TYPE=aliyun  # 可选值: aliyun, minio
OSS_BASE_URL=https://your-oss-url.com

# 地图配置
MAP_MODE=online  # 可选值: online, offline
AMAP_KEY=您的地图API密钥

启动应用

本地开发环境

# 开发模式启动
deno run -A app.tsx

# 或使用配置文件启动
deno run -A --config=deno.json app.tsx

在D8D平台运行

  1. 在D8D平台上创建应用后,可以直接在平台提供的在线编辑器中修改代码
  2. 完成代码修改后,直接点击"预览"按钮即可运行应用,无需部署
  3. 预览模式下,应用会立即启动并可在浏览器中访问测试

配置说明

系统配置可通过环境变量或数据库中的系统设置进行管理,支持以下配置项:

  • 站点名称、图标、Logo
  • 主题设置(明/暗模式)
  • 地图模式(在线/离线)
  • 图表主题
  • API 基础路径
  • 文件存储方式

D8D平台专属配置

在D8D平台运行时,可以通过平台的"应用配置"面板设置以下内容:

  • 应用资源限制(CPU、内存等)
  • 公网访问设置
  • 域名绑定
  • 自动备份
  • 日志记录级别

数据库迁移

系统首次启动时会自动执行数据库迁移,创建必要的表结构和初始数据。

自定义开发

添加新路由

routes_*.ts 文件中定义新的路由处理函数,然后在 app.tsx 中引入并注册。

前端开发

前端资源位于 asset/ 目录下,区分为管理端和移动端,可根据需要进行修改和扩展。

许可证

[License] - 请参阅LICENSE文件了解详情


© 2023 D8D. 保留所有权利。