开发日志

版本号：v2.2 ｜ 产品系统 + 阅读数据 + 积分闭环

过去三天完成了产品系统从零到一的搭建、阅读时长跟踪机制上线、以及书签系统的全方位升级，用户中心数据体系初步成型。

🏪 一、产品推荐页面重构

✅ 产品规划页 → 产品推荐页（product.html），30款产品全部入库
✅ 三档定价体系：市场价 · 会员价 · 折扣价，统一横栏卡片展示
✅ 每个产品三条特色说明（5-20字/行），分类标签彩色标识
✅ 权益产品购买走API → 订单+积分+会员状态一步到位
✅ 实物产品可配置第三方电商链接（淘宝/京东/微信小程序 URL Scheme）
✅ 管理后台完整产品管理：上架/下架、编辑、排序、定价

📊 二、产品数据统计上线

✅ 每个产品卡片显示 👁浏览量 · ♥收藏量 · 📦销量
✅ 浏览量自动记录（sessionStorage 去重，每日每会话一次）
✅ 收藏一键切换，实时更新数字，未登录引导登录
✅ 用户中心新增「浏览记录」「我的收藏」「购买记录」三个独立分区
✅ 管理后台产品列表同步显示三列统计数据

🔗 三、微信小程序链接支持

✅ 后台链接字段支持微信小程序 URL Scheme
✅ 权益产品可同时显示「立即购买」和「📱 详情」两个按钮
✅ 后台表单增加清晰说明：从微信后台→功能→URL Scheme生成

⏱️ 四、阅读时长跟踪 & 每日积分自动发放

✅ 阅读页每30秒心跳上报，切后台自动暂停，关闭页面保留最后一段时长
✅ 逐经典统计阅读时间 — 论语文言读15分钟，大学读8分钟，清晰可查
✅ 个人中心阅读记录改版：经典名称 + 进度条 + 完成章数 + 阅读时长
✅ 每日10:00自动发放阅读积分 — 前一日阅读分钟按1:1兑换为积分，系统cron自动执行
✅ 积分流水清晰显示：昨日阅读2026-06-17共X分钟

🔖 五、书签系统全面升级

✅ 阅读页右下角浮动 🔖 按钮，一键添加书签
✅ 自动检测当前可视段落，精确到段落索引
✅ 切换章节时自动保存上一章书签 + 阅读进度
✅ 个人中心书签可点击 → 跳转阅读器并 自动滚动到该段落（居中显示）
✅ 书签内容自动包含「章节名 · 首句原文节选」

👤 六、个人中心持续完善

✅ 会员标识徽章 — 五档创始会员 + 月度/年度会员 + 普通用户，点击弹窗显示有效期和权益
✅ 订单页重构为三个分区：浏览记录 · 我的收藏 · 购买记录
✅ 购买记录关联产品名称+金额+时间

📂 代码：/root/api_server.py（约600行） · 产品页 · 阅读器 · 用户中心 · 管理后台

版本号：v2.1｜后端API服务 + 前端对接

本次更新是良一十典从纯静态网站向全功能平台的关键跨越。自建了完整的 Flask + SQLite 后端 API 服务，替代此前全部依赖浏览器 localStorage 的方案。

📋 更新内容：

🆕 后端API服务器 — Flask框架，端口8766，通过Nginx反向代理
🆕 SQLite数据库 — 12张数据表，覆盖用户/阅读/积分/会员/订单/社区/投票/跟踪
🆕 42个RESTful接口 — 覆盖全部功能模块

🔌 前端对接完成：

✅ 管理后台登录 — 硬编码 → API真实账号密码认证
✅ 管理后台仪表盘 — 种子数据 → API实时访问量/用户数/收入
✅ 管理后台用户管理 — 10个模拟用户 → 数据库所有注册用户
✅ 用户中心注册/登录 — localStorage → API创建用户+JWT Token
✅ 积分自动同步 — 用户积分变化时上报到数据库

📂 技术栈：

Python Flask + SQLite + JWT + RESTful API + Nginx反向代理

📂 版本快照：/root/liangyishidian_v2.1_snapshot/（56个文件，2.4MB）

基于 Flask + SQLite 的全功能 RESTful API 服务已完成开发并上线运行，替代此前仅靠浏览器 localStorage 存储的方案。

API 端点总览（共42个接口）：

🔐 用户认证（2个） — POST /api/auth/register, /api/auth/login
👤 用户管理（4个） — GET/PUT profile, GET users list, GET user detail
📖 阅读平台（5个） — GET classics, POST/GET progress, CRUD bookmark
⭐ 积分系统（3个） — POST earn, GET history, GET rank
👑 会员体系（2个） — POST order, GET status
📢 众筹活动（3个） — POST register, POST order, GET stats
💬 社区互动（4个） — GET/POST feed, POST like, POST comment
🗳️ 产品投票（2个） — POST vote, GET ranking
🎙️ 十典金句（2个） — POST interact, GET stats
📊 数据跟踪（2个） — GET track, GET data
🔧 管理后台（5个） — POST login, GET dashboard, CRUD users/orders
🌐 全部通过 Nginx 反向代理 — http://43.155.171.156/api/

问题：管理后台用户管理只能看到预置种子数据，真实注册用户（如QQ用户242、手机用户5100）不显示，积分和阅读记录也无法查看。

根因：用户数据分散在各浏览器 localStorage，管理后台与前端用户系统完全隔离。跟踪API未存储完整的用户画像数据。

修复内容：

✅ 跟踪API升级：新增 /api/users 和 /api/user/{uid} 端点
✅ 用户注册时同步创建用户档案（UID绑定）
✅ 阅读事件上报总时长（分钟）
✅ 积分变动实时更新到用户档案
✅ 管理后台用户管理改为API实时数据 + 本地种子数据混合展示
✅ 新增"阅读时长"列，支持查看每个用户的积分和阅读统计

注意：此前已注册用户的本地数据需再次登录触发同步后才会出现在管理后台。

修复管理后台用户数据不显示的问题，上线轻量级访问跟踪系统。

问题原因：管理后台的用户数据是预置的种子数据（localStorage），与用户注册数据（各浏览器独立存储）不同步。

解决方案：部署了独立的 Python 跟踪API服务，通过 HTTP 请求统一记录访问和注册数据。

✅ 所有页面添加了访问跟踪（页面浏览计数）
✅ 用户注册时同步上报注册信息
✅ 管理后台仪表盘改为实时数据 + 本地数据混合展示
✅ 最近动态实时显示用户行为

良一十典经典IP角色形象方案已完成，打造「五圣宇宙」IP体系。

已完成内容：

🎭 角色设定 — 孔子、老子、庄子、慧能、王阳明五人性格档案+代表色+世界观
✏️ 概念草稿 — SVG概念线稿，可直接作为插画师设计Brief
😊 表情包脚本 — 24款表情完整策划，可直接交付设计师制作
🛍️ 周边方案 — 立牌/帆布包/手机壳/盲盒/贴纸，含定价和毛利
🤝 IP授权方案 — 3档授权合作模式+参考报价

👉 查看完整IP角色方案 →

基于监管严格程度、资质准入要求、研发成本、开发周期、预期收益五个维度，对全部30款产品完成综合评估。

第一梯队（立即启动）：

🐉 经典IP角色形象 — 5万/4周 · 成本最低
🃏 十典成语卡片 — 8万/4周 · 瞄准100-300元缺口市场
📅 十典文化日历 — 10万/4周 · 兼具实用与收藏
👶 亲子国学启蒙盒 — 12万/6周 · 订阅制
👕 良一服饰联名 — 8万/6周 · 品牌合作

第二梯队（稳步推进）： 自媒体矩阵、精装礼盒、知识游戏、线上课程

第三梯队（战略储备）： 实体书院、智能音箱、VR体验、B端进校园、师资认证

📎 下载完整产品评估清单文档（DOCX）

市场背景：

根据行业报告，2025年国学教育市场规模已达 690亿元（狭义）/ 超 2000亿元（广义）， 新中式消费市场突破 9500亿元，年增长率 15-20%。 88.7%的青年愿意参与国潮文化推广传播，国学文化消费正处于黄金增长期。

消费者画像：

👤 主力群体：36-45岁（41.8%）、26-35岁（22.5%）
📍 核心需求：实用性（72%）> 创意性（68%）> 社交属性（53%）
💰 价格阈值：100-300元中档产品市场缺口最大
📱 触达渠道：短视频+社交媒体（小红书/抖音/B站）

产品规划已从 12 款扩展至 30 款，覆盖 7 大产品线：

📖 核心产品（6款） — 在线阅读、音频畅听、小程序、App、自媒体矩阵、国学短剧
🎓 教育产品（4款） — 线上课程、B端进校园、亲子启蒙盒、师资认证、素养测评
🎨 文创产品（4款） — 精装礼盒、成语卡片、书法套装、益智桌游、文化日历
🤖 科技产品（3款） — VR沉浸体验、AI国学助手、智能音箱国学版
🏛️ 线下体验（4款） — 实体书院、文化游学、冬夏令营、雅集空间
🐉 IP衍生（5款） — 经典IP形象、数字藏品、服饰联名、知识游戏、纪录片
🔄 已上线（5款） — 在线阅读、每日金句、音频畅听、小程序、共修营

👉 查看完整产品路线图 →

版本号：v2.0 ｜ 平台功能全面升级

本次更新是良一十典从内容展示型网站向平台型产品演进的重要里程碑。

🆕 用户中心 — 微信/QQ/手机号登录、个人主页、动态时间线、阅读记录、积分等级、订单管理
🆕 创始会员众筹 — 两阶段倒计时、五档权益对比表、在线登记支付
🆕 管理后台 — 仪表盘、用户/内容/订单/积分/社区/活动管理、系统设置
🆕 产品路线图 — 12款产品卡片、进度条、用户投票排序
🆕 十典金句 — 每日经典金句、图片生成保存、朋友圈分享、热度排行、点赞评论
🆕 活动管理（后台） — 预约登记、付款信息、档位统计
🔄 导航重构 — 良一下拉菜单、活动、产品、我的

📂 版本快照：/root/liangyishidian_v2.0_snapshot/（48个文件，2.2MB）

涵盖官网、小程序、App统一管理后台的PRD已发布。文档包含7大模块和5张可视化原型图：

🔐 后台登录 — 独立管理后台登录页

📊 仪表盘 — DAU/MAU/阅读时长/付费率核心指标看板

👥 用户管理 — 用户列表搜索筛选、封禁/解封、详情查看

📖 内容管理 — 十部经典章节管理、图文/课程/音频统一管理

💳 订单管理 — 订单列表、退款处理、收入统计

⭐ 积分管理 — 积分流水、等级配置、手动发放/扣除

📋 社区审核 — 动态审核、评论管理、举报处理

🔔 消息推送 — App Push + 模板消息推送

⚙️ 系统设置 — 角色权限、操作日志、数据导出

📎 下载管理后台PRD文档（含原型图）

根据实际运营考量，对众筹方案中荣耀会员和大道会员的权益进行了修订：

荣耀会员（5,999元）修订：

✅ 年度文化雅集：每年3次 → 每年1次（含食宿）

✅ 经典共修营：每年2期 → 每年1期（3天2晚）

✅ 推荐返利：15% → 10%

大道会员（15,999元）修订：

❌ 书院经营分润 — 取消（涉及股权和资金往来）

❌ 全家族账号 — 取消

✅ 改为赠送 5个创始荣耀会员名额（可转赠他人）

✅ 创始人私享会：明确为 每年1次

📎 下载修订版众筹方案文档

良一十典种子用户众筹活动方案正式发布，用于冷启动并积累种子用户。

活动核心信息：

⏰ 倒计时：2027年9月28日

🎯 目标：筹集100万元 或 参与用户超过10,000人

✅ 达成任意一项即告成功，立即上线兑现权益

五档权益方案：

⭐ 创始纪念会员 19.9元 — 对应月度会员权益

⭐⭐ 创始年度会员 199.99元 — 对应年度会员权益

⭐⭐⭐ 创始终身会员 999元 — 对应终身会员权益

👑 创始荣耀会员 5,999元 — 限500人

🌟 创始大道会员 15,999元 — 限99人

📎 下载完整众筹方案文档

产品需求文档 V3 已完成更新，所有章节新增可视化 UI 原型图：

🔑 登录页 — 微信/QQ/手机号三种授权方式

👤 个人主页 — 头部信息卡 + 数据概览 + 动态时间线

⭐ 积分中心 — 积分余额、等级进度、每日任务、排行榜

👑 会员购买页 — 三档方案对比 + 权益清单

💬 社区首页 — 信息流布局 + 多标签切换

📊 运营看板 — 核心指标 + 趋势图 + 内容排行

📎 下载完整PRD文档（含可视化原型图）

用户运营体系产品需求文档 V2 已完成，新增各模块原型示意图：

🔑 账号体系 — 登录页原型

👤 个人主页 — 时间线式主页原型

⭐ 积分系统 — 积分中心页面原型

👑 会员体系 — 购买页原型

💬 社区互动 — 社区首页原型

📊 数据后台 — 运营看板原型

📎 下载完整PRD文档（含原型图）

良一十典用户运营体系产品需求文档（PRD）V1.0 正式发布。

文档涵盖以下核心模块：

🔑 用户账号体系 — QQ/微信授权登录，三端数据同步

👤 个人主页系统 — 微博日志形式，记录行为轨迹

⭐ 积分系统 — 阅读1分钟=1积分，等级称号体系

👑 会员体系 — 月度19.9元/年度199元，对标微信读书

💬 社区互动 — 动态发布、点赞、评论、关注、排名

📊 数据后台 — 用户看板、内容管理、数据导出

📎 下载完整PRD文档（DOCX）

十部经典在线阅读平台正式上线！参考微信读书体验设计。

功能特性：

📖 原文 + 译文对照阅读

📑 章节导航目录

A+ 字体大小调节

⌨️ 键盘快捷键支持

📱 移动端自适应

官网菜单完成重构，新菜单结构如下：

首页 — 品牌展示与十部经典概览

良一 — 品牌文化内涵、经营规划、运营报告

十典 — 十部经典详细介绍，支持下拉菜单快速切换

开发日志 — 项目进展发布，支持游客评论

基于品牌核心理念——"乾☰立坤☷中，形如书，L1即良一"，推出三个Logo概念方向：

A · 书脊结构 — 乾卦为书脊，坤卦为书页，稳重经典

B · L1 符号 — L+1并排成书，远看字母近看乾坤，现代简洁

C · 书中有易 — 打开的书为轮廓，左乾右坤，文化含蓄

👉 查看完整概念方案

良一十典官方网站今日正式上线运行，基于 Nginx + HTML/CSS + SVG 搭建。

下一阶段：十部经典阅读平台 · 小程序开发