1、立项原因，旨在解决什么产品问题：
随着现代快节奏生活与远程办公的普及，个人时间碎片化严重，缺乏科学、直观的时间消耗统计与行为复盘工具，导致时间效率低下和目标感明确度不足。本项目旨在打造一款高效、私有化且功能完备的全栈时间管理与多维行为追踪系统（ActiFlow），帮助用户精确记录每日各项活动的耗时，通过精细化的多级分类体系、实时计时、JWT安全认证以及GitHub风格的活跃热图与饼图数据分析，直观呈现时间资产流向，解决个人时间管理模糊、缺乏数据支撑的痛点，满足现代职场人和开发者对深度效率复盘与自我提升的强烈需求。
2、行业场景，业务背景：
本系统适用于知识工作者、独立开发者、学生以及所有注重时间效率与自我管理的个人用户。在时间资产管理与效能分析领域，用户需要一个既能轻量化随时记录、又能进行多维度深度数据复盘的平台，以实现从“日常时间追踪”到“行为习惯优化”的闭环管理。
1. 用户认证与安全体系：基于 JWT（JSON Web Token）与 bcrypt 实现安全的用户注册、登录、Token 鉴权及多用户数据隔离，确保用户隐私与数据安全。
2. 国际标准多级分类体系：参考联合国统计司（UNSD）ICATUS（国际时间使用统计分类标准）构建科学的层级分类体系，支持动态分类创建、自定义图标（Iconify）与活动迁移策略。
3. 实时计时器功能：支持快捷活动选择、实时计时、后台持久化存储（usertimer 表）、中断与保存日志，确保计时数据永不丢失。
4. 多维度数据分析与可视化：提供分类时间聚合树状图（支持直观的下钻交互）、每日活动明细表格以及类似 GitHub 的年度活动热图（Heatmap），直观展示时间占比与主导分类。
5. 时区自适应处理：完美支持跨时区用户，前端自动上报 IANA 时区，后端基于用户本地时区进行精准的日期边界计算与数据聚合。
1、“我”负责哪些具体任务？
本人独立负责该全栈时间管理系统的整体架构设计、前后端开发、数据库设计与迁移、RESTful API 接口实现、权限控制以及前端数据可视化看板的开发。
2、项目使用了哪些技术栈、架构，实现上的亮点、难点：
技术栈与架构：采用前后端分离架构。后端基于 Python FastAPI 框架、SQLModel/SQLAlchemy ORM 及 SQLite/Postgres 数据库，结合 Alembic 管理数据库迁移；前端基于 Vue.js 3 (Composition API)、Vite、Pinia、Tailwind CSS 及 Naive UI，图表层集成 Chart.js 及自定义 SVG 热图组件。
技术亮点与难点：
1. 业务建模亮点：摒弃常规简单的标签系统，严格遵循联合国 ICATUS 国际标准进行多级分类与树状数据建模，使时间统计和行为分析具备科学的社会学和统计学依据，满足专业级时间资产管理的需求。
2. 高性能聚合与热图缓存：设计并实现了后端多级分类聚合算法及按需计算的年度热图缓存机制（HeatmapEntry），有效解决了大数据量下时间统计的性能瓶颈。
3. 跨时区边界计算：解决了 UTC 与用户本地时区转换的日期边界计算，保证全球用户在不同时区下数据统计的绝对准确性。
4. 流畅的树状下钻交互：前端通过本地状态管理实现分类树的层级下钻与返回导航，无需频繁请求后端 API 即可获得极致流畅的交互体验。
评论