从头越 / KNOWLEDGE SYSTEM项目
← 返回项目
持续维护2026-07-01 — 至今

CTY Log 个人技术档案系统

基于 React、FastAPI 与 PostgreSQL 的真实公开仓库,覆盖内容管理、搜索、安全发布、测试和单机生产部署。

DockerFastAPIMarkdownPostgreSQLReact
状态持续维护
周期2026-07-01 — 至今
保密内容来自公开仓库;服务器地址、凭据、环境变量、备份内容和用户数据不进入项目正文。

背景

技术笔记需要长期可维护的固定地址、分类、搜索和发布审查,个人项目也需要用结构化方式记录背景、决策与验证。项目从展示站点演进为带管理后台和正式数据库的数据系统。

问题与限制

内容不能同时散落在前端常量和数据库;公开读取与管理写入需要独立权限边界;Markdown、媒体和项目案例必须兼顾展示、安全与保密;生产发布还要保护数据库、上传和备份数据卷。

职责

个人完成需求整理、前后端实现、数据建模、自动化测试、容器部署文档和内容维护,并使用公开仓库记录可复核变更。

架构

正在绘制图表…

PostgreSQL 是正式内容的唯一数据源;FastAPI 负责权限、发布规则和查询;React 负责服务端页面、SEO 与交互。Nginx 对外提供 HTTPS,Compose 保留数据库、上传和备份持久卷。

难点

需要在动态内容与服务端渲染之间保持单一数据源,同时确保公开 API 不泄露草稿、私有设置或已删除内容;发布必须兼顾数据库迁移与应用镜像回滚。

方案与取舍

通过仓储层集中公开查询条件,使用发布前保密确认和数据库约束;跨栈测试验证真实 API 进入 SSR;发布包采用唯一标签、摘要校验、迁移前备份和分层健康检查。

  • 文章、项目、分类、标签、时间线和媒体管理;
  • Markdown、代码高亮、KaTeX、Mermaid、目录和阅读进度;
  • 管理员会话、CSRF、角色、限流、软删除和版本冲突;
  • 统一搜索、RSS、Sitemap、Canonical 和结构化数据;
  • PostgreSQL 迁移、备份、隔离恢复和镜像回滚流程。

验证与结果

公开仓库已具备完整前后台、内容安全、测试、部署与运维闭环。本档案只引用仓库中可检查的能力,不虚构访问量、性能收益或商业结果。

复盘

持续完善真实内容,备案完成后复测公网 HTTPS,并根据内容规模评估中文搜索与异地加密备份。

关联文章