Files
Nexus/docs/README.md
T
Your Name c9a99f4fb3 fix: 全项目文档对齐 + 代码清理
代码修复:
- web/agent/agent.py: datetime.utcnow() → datetime.now(timezone.utc)
- requirements.txt: 移除 paramiko==3.5.0 (已无活跃引用)
- 删除 server/infrastructure/ssh/pool.py (DEPRECATED, 无引用)

连接池三层对齐 (config.py/.env.example/session.py):
- DB_POOL_SIZE 100→160, DB_MAX_OVERFLOW 100→120
- 基于 MySQL max_connections=400, install.php 公式

文档修复 (21项):
- P0: 硬编码域名/IP替换为配置变量占位符
- P1: 10个过时设计文档加归档标注 (引用旧文件结构)
- P2: step-3-webssh报告 paramiko引用修正
- 6份审查报告连接池参数勘误 100/100→160/120
- ECC安全报告 EC5 datetime.utcnow 标记已修复
- docs/README.md 文档索引重写
- docs/memory/mem_nexus_overview.md 移除硬编码凭证
- docs/project/tech-stack-inventory.md paramiko标记已移除

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-22 08:19:56 +08:00

5.0 KiB

Nexus 文档索引

最后更新: 2026-05-22


project/ — 项目概况

文件 说明
project/status.md 项目进度总览 + 数据库结构 + 实施进度 (~85%)
project/roadmap.md 功能规划 + ADR架构决策(11项) + 技术债务
project/deploy.md 部署指南 (Ubuntu 20-24, Nginx+Supervisor)
project/tech-stack-inventory.md 技术栈清单 + 连接池参数对齐 + v1勘误

design/ — 设计规格与实施计划

活跃设计

文件 说明
design/specs/design-standards.md 设计标准 — 安全模型/性能基线/代码规范/架构模式
design/specs/2026-05-18-redis-iot-optimization.md Redis+实时数据架构 + Key规范
design/specs/2026-05-17-architecture-optimization.md 配置分发与部署架构
design/specs/2026-05-19-sprint-planning.md Sprint规划 — 已完成升级项 + 待实现建议
design/tech-stack-evaluation.md 技术栈评估 + 风险矩阵 + 连接池配置

已归档设计(历史参考)

文件 说明
design/specs/2026-05-16-password-presets-design.md ⚠️ 归档 — 密码预设设计(引用旧文件结构)
design/specs/2026-05-16-simplified-push-design.md ⚠️ 归档 — 简化推送设计(引用旧文件结构)
design/specs/2026-05-17-retry-progress-design.md ⚠️ 归档 — 重试+进度设计(引用旧文件结构)
design/specs/2026-05-17-server-add-optimize-design.md ⚠️ 归档 — 服务器添加优化设计(引用旧文件结构)
design/specs/2026-05-18-file-manager-v2-design.md ⚠️ 归档 — 文件管理器v2设计(引用旧文件结构)
design/specs/2026-05-19-code-review-followup.md ⚠️ 归档 — PHP代码审查(前端已迁移到Tailwind)
design/plans/2026-05-16-password-presets.md ⚠️ 归档 — 密码预设实施计划
design/plans/2026-05-16-simplified-push.md ⚠️ 归档 — 简化推送实施计划
design/plans/2026-05-17-retry-progress.md ⚠️ 归档 — 重试+进度实施计划
design/plans/2026-05-17-server-add-optimize.md ⚠️ 归档 — 服务器添加优化实施计划
design/plans/2026-05-18-file-manager-v2.md ⚠️ 归档 — 文件管理器v2实施计划

reports/ — 审查与工作报告

部门审查报告

文件 说明
reports/review-cto-2026-05-21.md CTO审查 — 连接池/SSH/CORS/依赖(含勘误)
reports/review-deploy-architecture-2026-05-21.md 运维总监审查 — 部署架构/三层守护/Nginx(含勘误)
reports/review-quality-director-2026-05-21.md 质量总监审查 — 代码规范/datetime/测试(含勘误)
reports/step-0-infrastructure/ecc-security-report.md ECC组安全审查 — Redis/Schema/认证/SSH/编码(含勘误)
reports/signoff-2026-05-21.md 审查签字确认
reports/session-log-2026-05-21.md 会话操作日志

实施报告

文件 说明
reports/implementation-progress-2026-05-21.md 6步实施进度总览
reports/step-0-infrastructure/engineering-report.md Step 0: 基础设施加固
reports/step-0-infrastructure/ag-code-review-report.md Step 0: 代码审查
reports/step-0-infrastructure/testing-report.md Step 0: 测试报告
reports/step-1-data-layer/engineering-report.md Step 1: 数据层
reports/step-2-auth/engineering-report.md Step 2: 认证层
reports/step-3-webssh/engineering-report.md Step 3: Web SSH(含paramiko→asyncssh迁移)
reports/step-4-sync/engineering-report.md Step 4: Sync引擎
reports/step-5-frontend/engineering-report.md Step 5: 前端迁移
reports/step-5-frontend/design-review-report.md Step 5: 前端设计审查
reports/step-5-frontend/product-department-report.md Step 5: 产品部报告

research/ — 竞品与技术调研

文件 说明
research/jumpserver-easynode-architecture-analysis.md JumpServer & EasyNode 架构对比分析
research/ag-research-report.md AI Agent 调研报告

changelog/ — 修复记录

文件 说明
changelog/fix-plan-2026-05-20.md 代码问题修复计划(13项)
changelog/fix-plan-full-2026-05-20.md 全量未完成项修复计划(24项)
changelog/fix-verification-report-2026-05-20.md 修复验证报告

memory/ — 项目记忆(AI辅助)

文件 说明
memory/MEMORY.md 记忆索引
memory/mem_*.md 17个记忆文件(概述/决策/数据流/守护/模块/测试/等)

team/ — 部门协作

文件 说明
team/collaboration-charter.md 部门协作章程(5阶段流水线)
team/roster-2026-05-21.md 团队编制档案(194人/9部门)
team/roles/ 12个部门角色定义文档

skills/ — 团队技能定义(AI辅助)

目录 说明
skills/ 194个技能文件(各部门AI技能定义)