项目说明
项目背景
运维资料常散落在工具清单、故障笔记和部署脚本中,难以从一个问题追溯到适用工具、执行过程与维护文档。本项目用共享分类、标签和内容关系组织这些资料,帮助读者从运维场景进入实践知识,再查看项目交付说明。
当前能力
公开站提供工具、场景、知识、项目和层级文档的目录与详情,以及统一搜索、更新日志、探索入口和体验申请。管理端具备 Cookie Session、CSRF、角色权限、按需绑定 TOTP、草稿维护、关系替换、发布和归档;写入使用乐观锁并维护审计与搜索投影。文档按项目和父子路径组织,本文档集以 handbook 为根。
技术实现
前端为 Nuxt 3、Vue 3 与 TypeScript,公开页面使用 SSR;后端为 Go、Gin 和手写 PostgreSQL 查询,并非已生成 sqlc 代码。PostgreSQL 存储内容与管理数据,Redis 支撑 Session、验证码和限流等能力。仓库提供 Docker Compose 的 PostgreSQL、Redis 开发依赖,以及 Nginx、Web、API、数据库、备份服务组成的单机发布栈。
依赖与参考场景
关联的 PostgreSQL、Redis 和 Docker 是仓库部署依赖。关联的 Linux 主机监控、集中日志与 CI/CD 场景是部署负责人可评估的运维实践,不代表本站已经接入完整监控、集中日志或持续交付系统。生产栈提供可选 Prometheus 抓取配置,但未随栈部署 Alertmanager 通知渠道。
边界与交付件
项目标记为 BETA,当前不填未经确认的正式版本号。代码中的可运行流程、内容包、OpenAPI 契约、数据库迁移、验证脚本与发布记录模板构成交付件;测试通过不等于目标环境验收,也不证明公网域名已经上线。生产 DNS、CA 证书、真实密钥、网络规则、异地备份和恢复演练均由部署负责人完成。体验申请入口是平台能力,本项目条目未开启在线体验。