john/tractatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
tractatus/public
History
TheFlow 6ceac8f449 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
..
.well-known security: comprehensive security audit and hardening 2025-10-10 05:34:40 +13:00
about feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
admin feat: enhance framework services and format architectural documentation 2025-10-11 00:50:47 +13:00
css fix(ui): rebuild Tailwind CSS with tooltip classes and update cache to v1.0.4 2025-10-09 09:53:07 +13:00
demos feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
images feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
js feat: implement documentation reorganization with archives 2025-10-11 01:26:14 +13:00
koha feat: add Koha pre-production deployment configuration 2025-10-08 21:00:54 +13:00
about.html fix: improve About page presentation and resolve search endpoint tests 2025-10-10 11:39:14 +13:00
advocate.html feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
api-reference.html feat: change license from MIT to Apache License 2.0 2025-10-07 23:43:20 +13:00
case-submission.html feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
check-version.html feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
docs-viewer.html feat: change license from MIT to Apache License 2.0 2025-10-07 23:43:20 +13:00
docs.html feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
favicon.svg feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
implementer.html feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00
index.html feat: comprehensive documentation improvements and GitHub integration 2025-10-09 14:33:14 +13:00
koha.html feat: add Koha pre-production deployment configuration 2025-10-08 21:00:54 +13:00
leader.html feat: initial commit with security hardening and framework documentation 2025-10-09 12:05:07 +13:00
media-inquiry.html feat: complete Phase 2 - accessibility, performance, mobile polish 2025-10-08 13:29:26 +13:00
privacy.html feat: add multi-currency support and privacy policy to Koha system 2025-10-08 15:17:23 +13:00
researcher.html feat(infra): semantic versioning and systemd service implementation 2025-10-09 09:16:22 +13:00