← 返回项目
CTY Log 个人技术档案系统
基于 React、FastAPI 与 PostgreSQL 的真实公开仓库,覆盖内容管理、搜索、安全发布、测试和单机生产部署。
DockerFastAPIMarkdownPostgreSQLReact
背景
技术笔记需要长期可维护的固定地址、分类、搜索和发布审查,个人项目也需要用结构化方式记录背景、决策与验证。项目从展示站点演进为带管理后台和正式数据库的数据系统。
问题与限制
内容不能同时散落在前端常量和数据库;公开读取与管理写入需要独立权限边界;Markdown、媒体和项目案例必须兼顾展示、安全与保密;生产发布还要保护数据库、上传和备份数据卷。
职责
个人完成需求整理、前后端实现、数据建模、自动化测试、容器部署文档和内容维护,并使用公开仓库记录可复核变更。
架构
正在绘制图表…
PostgreSQL 是正式内容的唯一数据源;FastAPI 负责权限、发布规则和查询;React 负责服务端页面、SEO 与交互。Nginx 对外提供 HTTPS,Compose 保留数据库、上传和备份持久卷。
难点
需要在动态内容与服务端渲染之间保持单一数据源,同时确保公开 API 不泄露草稿、私有设置或已删除内容;发布必须兼顾数据库迁移与应用镜像回滚。
方案与取舍
通过仓储层集中公开查询条件,使用发布前保密确认和数据库约束;跨栈测试验证真实 API 进入 SSR;发布包采用唯一标签、摘要校验、迁移前备份和分层健康检查。
- 文章、项目、分类、标签、时间线和媒体管理;
- Markdown、代码高亮、KaTeX、Mermaid、目录和阅读进度;
- 管理员会话、CSRF、角色、限流、软删除和版本冲突;
- 统一搜索、RSS、Sitemap、Canonical 和结构化数据;
- PostgreSQL 迁移、备份、隔离恢复和镜像回滚流程。
验证与结果
公开仓库已具备完整前后台、内容安全、测试、部署与运维闭环。本档案只引用仓库中可检查的能力,不虚构访问量、性能收益或商业结果。
复盘
持续完善真实内容,备案完成后复测公网 HTTPS,并根据内容规模评估中文搜索与异地加密备份。
关联文章
项目链接
公开仓库或演示入口。