编写产品需求文档：黄历日历小程序

整理产品需求文档：黄历日历小程序

版本：1.0
更新时间：2025-7-9

一、文档概述

1.1 产品背景

开发一款融合传统黄历文化的日历工具，提供每日吉凶查询、神煞展示和个人运势分析功能。

1.2 目标用户

关注传统历法的中老年群体
婚嫁/搬家等需要择吉的用户
传统文化爱好者

二、功能需求

2.1 核心功能清单

模块

功能点

优先级

备注

日历

吉凶展示（红黄蓝黑）

需对接黄历算法

神煞详情展示

包含吉神/凶神

每日宜忌提示

用户

个人信息设置

支持农历输入

出生地选择

结合地理编码

三、详细需求说明

3.1 日历页面

3.1.1 视觉规范

xml 复制代码

<!-- 日期格子示例 --> 
<div class="day-cell" style="color: #{color};"> <div class="date">15</div> <div class="omen">吉</div> </div>

3.1.2 交互逻辑

1、日期选择：

点击顶部日期栏唤起原生日期选择器
支持公历/农历切换

2、吉凶判断规则：

kotlin 复制代码

if (无凶神 && 有吉神) return '吉'; else if (凶神≤1 && 吉神≥2) return '良'; else if (无凶神 && 无吉神) return '平'; else return '凶';

3.2 用户信息模块

数据字段

字段

类型

必填

默认值

姓名

string

否

微信昵称

性别

enum

是

出生时间

datetime

是

出生地

string

否

四、数据架构

4.1 核心数据表

sql 复制代码

erDiagram
    CALENDAR_DAY ||--o{ GODS : contains
    CALENDAR_DAY {
        date date PK
        omen varchar
        suitable_actions text
        avoid_actions text
    }
    GODS {
        id int PK
        day_date date FK
        name varchar
        type enum('吉','凶')
    }

4.2 第三方服务依赖

黄历数据API

五、非功能性需求

5.1 性能指标

日历页面加载时间 ≤800ms
支持10万级日期数据存储

5.2 安全要求

用户出生信息加密存储
敏感操作需二次确认

六、项目计划

6.1 里程碑

阶段

时间

交付物

原型设计

2025-6-1

Figma交互稿

核心功能开发

2025-6-25

可运行MVP

数据对接

2025-7-10

完整黄历数据

6.2 风险预案

黄历算法延迟：准备本地简化版算法
用户量激增：启用云数据库自动扩容

附录

A. 术语表

神煞：传统历法中的吉凶神煞系统
喜用神：八字命理中的有利元素