tractatus/docs
TheFlow 2fc6e0a593 feat: implement documentation reorganization with archives
Documentation Reorganization (Option A - Full):
- Reduced public docs from 47 to 11 (76% reduction)
- 31 documents archived (project tracking, outdated)
- 5 documents marked confidential (security, payments)
- Clear 3-tier structure: Getting Started, Framework Details, Case Studies

Archives Infrastructure:
- Added visibility: 'archived' | 'public' | 'confidential' | 'internal'
- Added category: 'conceptual' | 'practical' | 'reference' | 'archived' | 'project-tracking'
- Added order field for explicit document ordering (1-11 for public)
- Added archiveNote field for explaining why documents were archived
- New endpoint: GET /api/documents/archived
- New controller method: listArchivedDocuments()
- UI: Archives section (collapsed by default) at bottom of docs list

Public Documentation (11 documents, well-organized):
  1. Architectural Overview (reference)
  2. Core Concepts (conceptual) - needs Phase 5 update
  3. Implementation Guide (practical) - needs MongoDB rewrite
  4. Core Values & Principles (conceptual)
  5. Case Studies (practical)
  6. Business Case Template (practical)
  7. Glossary (reference) - needs Phase 5 terms
  8-11. Recent Case Studies (practical)

Model Updates:
- src/models/Document.model.js: Added visibility, category, order, archiveNote fields
- src/models/Document.model.js: Added listArchived() static method
- Default sort by order (1-999) instead of date

Controller Updates:
- src/controllers/documents.controller.js: Added listArchivedDocuments()
- Filter excludes archived docs from main list by default

Route Updates:
- src/routes/documents.routes.js: Added GET /api/documents/archived

UI Updates:
- public/js/docs-app.js: New category structure (Getting Started, Framework Details, Reference)
- public/js/docs-app.js: Fetches and displays archived documents in collapsed section
- public/js/docs-app.js: Archives show document count badge
- public/js/docs-app.js: Archive notes displayed below archived document links
- Auto-loads Architectural Overview (order: 1) on page load

Scripts Created:
- scripts/archive-outdated-documents.js: Archive 10 outdated documents
- scripts/update-document-metadata.js: Set order/category for 7 core docs
- scripts/archive-all-internal-documents.js: Mass archive 23 internal docs

Documentation:
- docs/DOCUMENT_AUDIT_2025-10-11.md: Comprehensive audit of all 47 documents
- docs/DOCUMENT_REORGANIZATION_SUMMARY.md: Executive summary with before/after

Next Steps (Phase 2 - Content Updates):
- Update Core Concepts for Phase 5 MongoDB architecture
- Rewrite Implementation Guide for MongoDB deployment
- Update Glossary with Phase 5 terms (MongoDB, MemoryProxy, API Memory)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-11 01:26:14 +13:00
..
case-studies feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
governance feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
markdown feat: enhance framework services and format architectural documentation 2025-10-11 00:50:47 +13:00
research feat: enhance framework services and format architectural documentation 2025-10-11 00:50:47 +13:00
AUTOMATED_SYNC_SETUP.md feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
BLOG-POST-OUTLINES.md feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
BLOG_CURATION_WORKFLOW.md feat: implement blog curation AI with Tractatus enforcement (Option C) 2025-10-10 08:01:53 +13:00
claude-code-framework-enforcement.md feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
DOCUMENT_AUDIT_2025-10-11.md feat: implement documentation reorganization with archives 2025-10-11 01:26:14 +13:00
DOCUMENT_REORGANIZATION_SUMMARY.md feat: implement documentation reorganization with archives 2025-10-11 01:26:14 +13:00
DOCUMENT_SECURITY_GOVERNANCE.md feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
FRAMEWORK_FAILURE_2025-10-09.md CRITICAL: Replace fabricated business case with honest template 2025-10-09 10:32:20 +13:00
FRAMEWORK_PERFORMANCE_ANALYSIS.md feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
GLOSSARY.md docs: add comprehensive Glossary of Terms for Tractatus framework 2025-10-07 11:11:56 +13:00
IMPLEMENTATION_PROGRESS_2025-10-07.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
KOHA-SECURITY-AUDIT-2025-10-09.md security: complete Koha authentication and security hardening 2025-10-09 21:10:29 +13:00
KOHA_PRODUCTION_DEPLOYMENT.md feat: add Koha pre-production deployment configuration 2025-10-08 21:00:54 +13:00
KOHA_STRIPE_SETUP.md feat: add multi-currency support and privacy policy to Koha system 2025-10-08 15:17:23 +13:00
MULTI_PROJECT_GOVERNANCE_IMPLEMENTATION_PLAN.md docs: integrate concurrent session architecture and create API Memory handoff 2025-10-10 23:21:41 +13:00
PHASE-2-COST-ESTIMATES.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-DEPLOYMENT-GUIDE.md docs: create comprehensive Phase 2 deployment guide with granular tasks 2025-10-07 13:51:45 +13:00
PHASE-2-EMAIL-TEMPLATES.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-INFRASTRUCTURE-PLAN.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-KICKOFF-CHECKLIST.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-PREPARATION-ADVISORY.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-PRESENTATION.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PHASE-2-PROGRESS-WEEK-5.md feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
PHASE-2-ROADMAP.md docs: Phase 2 kickoff materials & domain migration to agenticgovernance.digital 2025-10-07 13:17:42 +13:00
PRODUCTION_DEPLOYMENT_CHECKLIST.md docs: create comprehensive production deployment checklist 2025-10-09 22:19:00 +13:00
PRODUCTION_MONITORING_SETUP.md ops: implement comprehensive production monitoring system 2025-10-09 22:23:40 +13:00
SECURITY-AUDIT-2025-10-09.md security: comprehensive security audit and hardening 2025-10-10 05:34:40 +13:00
SESSION-2025-10-07-AI-FEATURES.md feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
session-handoff-2025-10-07-part2.md docs: add comprehensive session handoff for 2025-10-07 Part 2 2025-10-07 08:44:13 +13:00
session-handoff-2025-10-07-part3-crossreference.md fix: CrossReferenceValidator 100% - prohibition & preference detection 2025-10-07 10:03:56 +13:00
session-handoff-2025-10-07-part4-governance-active.md docs: session handoff - governance active & 100% coverage achieved 2025-10-07 11:26:12 +13:00
session-handoff-2025-10-07-tractatus-activation.md feat: ACTIVATE Tractatus Governance Framework 🤖 2025-10-07 09:22:05 +13:00
session-handoff-2025-10-07.md fix: resolve CrossReferenceValidator conflict detection and enhance parameter extraction 2025-10-07 01:46:04 +13:00
SESSION_HANDOFF_2025-10-10.md docs: integrate concurrent session architecture and create API Memory handoff 2025-10-10 23:21:41 +13:00
SESSION_INIT_API_MEMORY_AUDIT.md docs: audit session-init.js for API Memory and provide next session prompt 2025-10-10 23:43:51 +13:00
TESTING-CHECKLIST.md feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
TESTING-RESULTS-2025-10-07.md feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00