初始提交:浏览器首页 MyHomePage 全栈项目
# 项目概述 个人浏览器首页导航应用,支持书签分类管理、搜索引擎快捷搜索、 必应每日壁纸轮播、前后端分离部署,适配 1Panel 服务器(Docker 模式)。 # 技术栈 - 前端:Vue 3 + TypeScript + Vite + Pinia + Capacitor(Android 打包) - 后端:.NET 8 + SqlSugar(多数据库) + SQLite/MySQL + Swashbuckle - 部署:1Panel 应用商店自定义应用(Docker Compose 模式) # 项目结构 - backend/ .NET 8 API 后端(8 个 Controller + 15 个 Service) - frontend/ Vue 3 前端(19 个组件 + 9 个 API 模块 + 5 个 Store) - docker/ Docker 部署文件(后端镜像 + Nginx 反代) - docs/ 部署手册(1Panel 实战版) - scripts/ E2E 测试脚本 # 已实现功能 - 书签管理:增删改查 + 树形分类 + 拖拽排序 + 主色自适应 - 搜索引擎:8 个内置引擎 + 自定义引擎 + favicon 自动抓取 - 必应壁纸:每日轮播 + 多分辨率自动选择 + 1.6MP 质量优先 - 全局设置:主题/行为/数据/工具 4 分类 + 跨设备同步 - 文件上传:图标/书签/通用(容器持久化 + 跨域 URL 拼接) - 同步:基于变更日志的设备间数据同步 - 跨域部署:前后端分离 + runtime config.json 无需重新编译 # 进度记录 - 已完成 P0~P52 共 53 个开发节点(详细见 说明文档.md) - 当前版本:v1.0 部署就绪 # 部署文档 - README.md:项目说明 + 快速开始 - 说明文档.md:完整开发进度(中文) - docs/DEPLOY.md:1Panel 部署手册(Docker 模式)
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
using Microsoft.AspNetCore.Mvc;
|
||||
using MyHomePage.Api.Common;
|
||||
using MyHomePage.Api.Models.Dtos;
|
||||
using MyHomePage.Api.Services;
|
||||
|
||||
namespace MyHomePage.Api.Controllers;
|
||||
|
||||
/// <summary>多端同步:拉取增量变更 + 全量快照。</summary>
|
||||
[ApiController]
|
||||
[Route("api/sync")]
|
||||
public class SyncController : ControllerBase
|
||||
{
|
||||
private readonly ISyncService _service;
|
||||
private readonly ILogger<SyncController> _logger;
|
||||
|
||||
public SyncController(ISyncService service, ILogger<SyncController> logger)
|
||||
{
|
||||
_service = service;
|
||||
_logger = logger;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 拉取自 <paramref name="since"/> 之后的变更。
|
||||
/// <paramref name="since"/> 为空或解析失败时返回全量(P34.2 防御:避免前端传 ?since=undefined 触发 400)。
|
||||
/// </summary>
|
||||
[HttpGet("changes")]
|
||||
public async Task<ApiResponse<SyncChangesResponse>> Changes([FromQuery] string? since)
|
||||
{
|
||||
DateTime? sinceDt = null;
|
||||
if (!string.IsNullOrWhiteSpace(since))
|
||||
{
|
||||
// 严格解析(RoundtripKind 接受 ISO8601 字符串);失败则降级为全量
|
||||
if (DateTime.TryParse(since, System.Globalization.CultureInfo.InvariantCulture,
|
||||
System.Globalization.DateTimeStyles.RoundtripKind, out var parsed))
|
||||
{
|
||||
sinceDt = parsed;
|
||||
}
|
||||
else
|
||||
{
|
||||
_logger.LogWarning("Sync changes received unparseable since={Since}, fallback to full snapshot", since);
|
||||
}
|
||||
}
|
||||
return ApiResponse<SyncChangesResponse>.Ok(await _service.GetChangesAsync(sinceDt));
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user