Codex
9.2 KiB
PikaOA 企业办公平台
- 规格真相：
project-management/PJ2026-03/specs/PJ2026-03-pikaoa.md。 - 主执行记录：pikasTech/unidesk#1952。
- 产品仓库：
pikaInc/pikaoa，固定主工作区为/root/pikaoa。 - 目标运行面：owning YAML 选中的 NC01 Kubernetes 独立 namespace。
- 公网原入口：
https://oa.pikapython.com。 - 数据真相：PK01 host PostgreSQL 中的独立数据库与角色。
- 执行证据：GitHub issue/PR、任务报告、PaC/PipelineRun/GitOps/Argo 和 Web 原入口验证。
R1 [in_progress]
依据 PJ2026-03 建设企业级可扩展 PikaOA：在 /root/pikaoa 建立 pikaInc 仓库，采用 HWLAB v0.3 同族 Vue 技术栈和 Go 后端；CLI-first 完成员工/RBAC、甲方分类、合同多版本、发票关联与废弃、审计、OTel/Prometheus，再开发 Web；通过独立 K8s namespace、PK01 host PostgreSQL、YAML-first、PaC bootstrap、自动 CI/CD 和 https://oa.pikapython.com 原入口交付，完成任务后将详细报告写入任务报告。
R1.1 [completed]
调研成熟开源 OA、ERP、合同、发票、Go 微服务与 Vue 组件方案，形成采用/复用/不采用结论，依赖 R1 规格，执行记录见 pikasTech/unidesk#1953，完成任务后将详细报告写入任务报告。
R1.2 [completed]
建立 pikainc/pikaoa 私有仓库、/root/pikaoa 固定 master 和独立任务 worktree；远端已由 SSH 验证并以 1fc2353 建立唯一初始提交，完成任务后将详细报告写入任务报告。
R1.3 [in_progress]
实现企业模块内核、Go API/Worker、PostgreSQL 迁移、员工/RBAC、伙伴分类、合同版本、发票废弃、审计、OTel/Prometheus 与 CLI，并通过 CLI 后端验收，依赖 R1.1-R1.2，完成任务后将详细报告写入任务报告。
R1.3.1 [completed]
建立 Go API/Worker/CLI 企业模块共享内核、PostgreSQL 迁移与审计/outbox 端口、OTel/Prometheus 基线和 CLI health/modules 验收，执行记录见 pikasTech/unidesk#1977，完成任务后将详细报告写入任务报告。
R1.3.2 [completed]
采用 chi 建立可插拔模块 HTTP 运行时、disabled 模块关闭入口、示例模块扩展验收，并补齐 PostgreSQL OTel 与 HTTP/runtime/pool/migration Prometheus 基线，执行记录见 pikasTech/unidesk#1983，完成任务后将详细报告写入任务报告。
R1.3.3 [completed]
实现员工身份、Casbin RBAC、会话与 CLI login/logout/whoami/employees/roles，使用 YAML Secret 投影初始管理员和员工，执行记录见 pikasTech/unidesk#1984，完成任务后将详细报告写入任务报告。
R1.3.4 [completed]
实现 pgx 同事务审计、PostgreSQL outbox、Watermill handler pipeline、幂等 Worker 与 OTel/Prometheus，执行记录见 pikasTech/unidesk#1985，完成任务后将详细报告写入任务报告。
R1.3.5 [in_progress]
实现统一业务伙伴、甲方分类、角色、联系人、标签、归档、筛选和 CLI；持久化 REST 资源使用 UUIDv7，伙伴与分类只通过 typed ID 关联，并将业务、审计、outbox 保持同事务，执行记录见 pikasTech/unidesk#1990，完成任务后将详细报告写入任务报告。
R1.3.6 [in_progress]
实现统一附件元数据、对象引用、可替换存储端口、完整性校验、授权 API 和 CLI；附件使用 UUIDv7 平级资源身份，业务对象仅通过 typed ID 关联，执行记录见 pikasTech/unidesk#1991，完成任务后将详细报告写入任务报告。
R1.3.7
实现合同与合同版本平级 UUIDv7 REST 资源，通过 contractId、previousVersionId、currentVersionId 建立 ID 关系，保证版本不可变、并发序号唯一、附件关联和全量 CLI，执行记录见 pikasTech/unidesk#1992，完成任务后将详细报告写入任务报告。
R1.3.8
实现平级 UUIDv7 发票资源，通过 partnerId、contractId、contractVersionId 和 attachmentId 建立关联，支持定点金额、typed 一致性校验、不可删除废弃事实、筛选汇总和全量 CLI，执行记录见 pikasTech/unidesk#1993，完成任务后将详细报告写入任务报告。
R1.3.9 [in_progress]
复用 append-only 审计唯一真相实现 UUIDv7 平级审计资源、RBAC 查询 API、actor/resource/action/time/requestId/traceId 筛选和 audit list/get CLI，执行记录见 pikasTech/unidesk#1994，完成任务后将详细报告写入任务报告。
R1.4
在 R1.3 CLI 后端验收通过后实现 HWLAB v0.3 同族 Vue 工作台、响应式页面与同路径业务流，完成任务后将详细报告写入任务报告。
R1.5 [completed]
在 UniDesk 中声明 PK01 PostgreSQL、Secret、NC01 独立 namespace、Gitea/PaC、GitOps、OTel/Prometheus 和 PK01 公网暴露，并改进可复用 bootstrap 工具，依赖 R1.1-R1.2，完成任务后将详细报告写入任务报告。
R1.5.1 [completed]
改进 PaC bootstrap 的新服务首发预检、分阶段紧凑输出、typed failure 与中文说明，保持 PR merge 唯一交付 authority，执行记录见 pikasTech/unidesk#1955，完成任务后将详细报告写入任务报告。
R1.5.2 [completed]
扩展 NC01 共享 observability，使 OTel/Tempo 与 Prometheus 由同一 YAML-first 控制面管理并提供跨 namespace 指标抓取和有界查询，执行记录见 pikasTech/unidesk#1956，完成任务后将详细报告写入任务报告。
R1.5.3 [completed]
修复 platform-db postgres plan 默认 30KB JSON 被输出预算截断的可见性缺陷，提供数据库、角色、Secret/export、检查与下一步的紧凑 CLI-first 投影，执行记录沿用 主 issue，完成任务后将详细报告写入任务报告。
R1.5.4 [completed]
修复 platform-db postgres status 与 export-secrets --dry-run 默认输出超预算截断，提供与 plan 同族的 Secret/export 有界投影并保持 valuesPrinted=false，执行记录见 pikasTech/unidesk#1958，完成任务后将详细报告写入任务报告。
R1.5.5 [completed]
为 pikainc/pikaoa 补齐 YAML-first GitHub token repository override，使受控 CLI 可管理产品 PR 且不打印凭据，执行记录见 pikasTech/unidesk#1978，完成任务后将详细报告写入任务报告。
R1.5.6 [completed]
修复 GitHub repository override 对 owner/repo 大小写敏感，确保 pikaInc/pikaoa 与 canonical 名称选择同一受控 token，执行记录见 pikasTech/unidesk#1980，完成任务后将详细报告写入任务报告。
R1.6
审核并合并双仓 PR，执行首次受控 PaC bootstrap，由正常 source PR merge 自动发布，依赖 R1.3-R1.5，完成任务后将详细报告写入任务报告。
R1.7
通过 CLI、OTel、Prometheus 和 https://oa.pikapython.com 桌面/移动原入口验证完整主路径，依赖 R1.6，完成任务后将详细报告写入任务报告。
R1.8
完成 issue、MDTODO、阶段报告、post-task、已吸收 worktree 与分支清理，依赖 R1.7，完成任务后将详细报告写入任务报告。