steilerdev/cornerstone

cornerstone

https://img.shields.io/github/v/release/steilerDev/cornerstone?label=release](https://github.com/steilerDev/cornerstone/releases/latest) https://img.shields.io/github/actions/workflow/status/steilerDev/cornerstone/ci.yml?branch=main&label=CI](https://github.com/steilerDev/cornerstone/actions/workflows/ci.yml) https://img.shields.io/docker/v/steilerdev/cornerstone?label=Docker&sort=semver](https://hub.docker.com/r/steilerdev/cornerstone)

一个面向房主的自托管房屋建设项目管理工具。可跟踪工作项、管理多资金来源的预算、在甘特图上可视化时间线，并按区域和行业组织所有内容——全部通过单个Docker容器实现，使用SQLite作为后端，无需外部数据库或云服务。

[!NOTE] 本项目完全使用智能体开发工作流（Agentic Development Workflow）结合Claude Code和https://docs.docker.com/ai/sandboxes/get-started/%E7%BC%96%E5%86%99%E3%80%82

这是一个探索如何充分利用现代LLM编码能力的实验项目，同时应用软件工程最佳实践创建高质量和可维护的代码。我的计划是尽量减少手动编写代码，而是依靠一组智能体来构建此应用程序。

项目范围受时间限制（我目前需要这个工具，之后可能不再需要）且功能有限——因此我不必过分关注长期可维护性和/或整体代码质量。

经过几周的项目开发，我既对LLM的能力感到惊讶，同时也觉得进展没有想象中那么快速和可靠。

到目前为止的主要经验：

• 为了让编码智能体产生良好的工作成果，验证非常重要。
• 高质量的工作将消耗大量tokens！
• 通过技能和智能体明确定义流程，可以简化开发人员的用户体验，并确保编码沿着正确的路径进行。
• 并行工作很重要——编码智能体应原生支持使用git worktrees实现并行开发。
• 在主机上运行编码智能体是危险的！它们可能（并且会）失控执行您从未想过的任务，并且它们很聪明地绕过限制。https://docs.docker.com/ai/sandboxes/%E5%AF%B9%E4%BA%8E%E4%B8%BA%E6%99%BA%E8%83%BD%E4%BD%93%E6%8F%90%E4%BE%9B%E6%98%8E%E7%A1%AE%E7%9A%84%E9%99%90%E5%88%B6%E5%B9%B6%E5%9C%A8%E5%87%BA%E7%8E%B0%E9%97%AE%E9%A2%98%E6%97%B6%E5%87%8F%E5%B0%91%E5%BD%B1%E5%93%8D%E8%8C%83%E5%9B%B4%E8%87%B3%E5%85%B3%E9%87%8D%E8%A6%81%E2%80%94%E2%80%94%E7%BC%96%E7%A0%81%E6%99%BA%E8%83%BD%E4%BD%93%E6%B2%BB%E7%90%86%E5%B0%86%E6%98%AF%E6%9C%AA%E6%9D%A5%E7%9A%84%E5%85%B3%E9%94%AE%E8%83%BD%E5%8A%9B%EF%BC%81
• 为了遵循策略，需要正确的执行机制——友好地要求智能体遵循策略并不总是有效：确保您的CI、仓库和部署流程有强制执行的质量关卡，且智能体无法绕过。

https://steilerDev.github.io/cornerstone/

核心功能

• 工作项——管理施工任务，包括状态、日期、区域分配、备注、子任务、依赖关系和键盘快捷键——每个工作项在列表、详情页、选择器和所有引用位置均显示完整的区域祖先路径（例如房屋 / 一楼 / 厨房）作为面包屑
• 区域与行业——通过层级区域（房间、楼层、区域）和行业专业（电气、 plum***g等）组织项目；专用的"无区域"筛选器可显示尚未分类的项目
• 预算管理——预算类别、带内联展开和批量移动附加行的资金来源、带分项金额的多预算行发票链接、带上限的补贴、报价跟踪，以及按区域分组的概览仪表板，包含可点击的摘要卡片和打印友好的导出
• 时间线与甘特图——交互式甘特图，包含依赖箭头、关键路径、缩放控制、里程碑和基于CPM的自动调度
• 日历视图——月历和周历网格，显示工作项和里程碑
• 家庭物品——跟踪家具、电器和固定装置，包括类别、区域分配、交付计划、预算集成和工作项链接
• 项目仪表板——一目了然的项目健康状况，包含预算、时间线、发票和补贴卡片、迷你甘特图预览和可自定义布局
• 施工日记——每日日志、现场访问记录、交付记录、自动系统事件、照片附件和数字签名捕获
• 文档集成——从Paperless-ngx浏览文档并链接到工作项、家庭物品和发票
• 高级列表视图——通过共享的数据表系统在所有列表页面进行筛选、排序、分页和自定义列
• 备份与恢复——手动和计划备份（可配置保留期），从设置界面进行恢复
• 国际化——英语和德语支持，自动检测区域设置，包括翻译的类别名称
• 身份验证——带设置向导的本地账户、OIDC单点登录
• 用户管理——管理员和成员角色、管理面板
• 深色模式——浅色、深色或系统主题

使用方法

快速启动

bash
docker run -d \
  --name cornerstone \
  -p 3000:3000 \
  -v cornerstone-data:/app/data \
  docker.xuanyuan.run/steilerdev/cornerstone:latest

打开http://localhost:3000——设置向导将引导您创建管理员账户。有关Docker Compose、反向代理和OIDC配置，请参阅https://steilerDev.github.io/cornerstone/getting-started/docker-setup%E3%80%82

适用场景

• 个人或家庭自建房屋项目管理
• 小型建筑项目的预算与进度跟踪
• 需要本地化数据存储的房屋建设管理需求
• 多区域、多行业协作的房屋装修项目

路线图

• EPIC-02: 应用程序框架和基础设施
• EPIC-11: CI/CD基础设施
• EPIC-01: 身份验证和用户管理
• EPIC-03: 工作项
• EPIC-12: 设计系统引导
• EPIC-05: 预算管理
• EPIC-06: 时间线和甘特图
• EPIC-08: Paperless-ngx集成
• EPIC-04: 家庭物品
• EPIC-07: 报告和导出
• EPIC-10: UX优化和可访问性
• EPIC-11: 统一标签和类别系统
• EPIC-12: 代码库改进和一致性
• EPIC-14: 跨实体代码去重
• EPIC-15: 预算行发票链接重构
• EPIC-09: 仪表板和概览
• EPIC-13: 施工日记
• EPIC-17: 国际化（英语+德语）
• EPIC-18: 区域与行业
• 数据表和列表视图大修
• 备份与恢复
• EPIC-16: 平面图和设施跟踪

在https://github.com/users/steilerDev/projects/4%E4%B8%8A%E8%B7%9F%E8%B8%AA%E5%AE%9E%E6%97%B6%E8%BF%9B%E5%BA%A6%E3%80%82

文档资源

贡献

Cornerstone是一个主要通过智能体开发工作流构建的个人项目。如有问题或建议，欢迎https://github.com/steilerDev/cornerstone/issues%E3%80%82

许可证

本项目目前未采用开源许可证。