Commit Graph

17 Commits

Author SHA1 Message Date
9e892dcd74 refactor(deployment): remove 10 redundant shell scripts replaced by Python CLI
All deployment commands now go through deployment.py. Deleted:
build-base-images.sh, build-apps.sh, build-testcontainers.sh, deploy.sh,
start-stack.sh, release.sh, nexus-ci-init.sh, push-to-nexus.sh,
populate-nexus.sh, publish-npm-patches.sh.

Kept nexus-init.sh and artifactory-init.sh (Docker container entrypoints).
Updated all references in CLAUDE.md, README.md, AGENTS.md, ROADMAP.md,
deployment docs, Dockerfiles, and docker-compose comments.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 01:19:32 +00:00
862cc29457 various changes 2026-03-09 22:30:41 +00:00
e717a1916b chore: Organize docs folder into logical subfolders
Grouped 100+ docs into categories:
- architecture/ - System design, DBAL, component architecture
- analysis/ - Status reports, assessments, migration analysis
- guides/ - Quick references, how-tos, integration guides
- implementation/ - Implementation details, migration guides
- packages/ - Package-specific docs (forum, notifications, etc)
- phases/ - Phase completion summaries and deliverables
- testing/ - E2E tests, Playwright, test architecture
- workflow/ - Workflow engine documentation

Root level retains: README, ROADMAP, AGENTS, CONTRACT, CLAUDE, PROMPT

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 17:55:28 +00:00
ccf383a642 docs: Create TECH_DEBT.md with bot-actionable task instructions
Add explicit, step-by-step instructions for each tech debt item so bots know exactly what to do:

- TD-1: DBAL Refactoring (🔴 CRITICAL) - Move database logic from frontend to DBAL (13 steps)
- TD-2: Rate limiting (🟡 HIGH) - Protect API endpoints from abuse
- TD-3: OpenAPI/Swagger (🟡 HIGH) - API contract visibility and client generation
- TD-4: Error handling docs (🟡 MEDIUM) - Consistent error response patterns

Also included 9 Phase 3+ tasks (TD-5 through TD-13) for future reference.

Each task includes:
- Current status and priority
- Clear problem statement
- Impact analysis
- Bot-actionable instructions (step-by-step)
- Expected outcomes

Updated ROADMAP.md, CLAUDE.md, and AGENTS.md to reference TECH_DEBT.md.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-15 00:49:20 +00:00
47b24927be Update ROADMAP.md 2026-01-15 00:35:03 +00:00
rmac
8690a9c902 Add comprehensive Technical Debt & Prioritization Roadmap to ROADMAP.md
Created detailed, prioritized technical debt roadmap with clear phases:

**Phase 1: Critical Cleanup (1-2 weeks, ~2-3 hours)**
- P1.1: Delete /old directory (119 files) - pre-Next.js SPA cruft
- P1.2: Delete .backup files (4 files) - Git history preserved
- P1.3: Verify experimental code (1 file)
- Deliverable: Remove 124 files of dead code

**Phase 2: Architecture Refactoring (4-6 weeks, ~9-16 hours)**
- P2.1: Migrate seed data to YAML (4-5h)
  - Move *.ts seed files to /seed/database/
  - Load via DBAL seedDatabase() orchestration
- P2.2: Eliminate adapter code duplication (2-3h)
  - Remove duplicate adapter logic from frontend
  - Use DBAL client exclusively
- P2.3: Migrate role/permission constants to DB (2-3h)
  - Move ROLE_LEVELS to permissions_schema.json
  - Create seed/database/roles.yaml
- P2.4: Migrate environment configuration (2-3h)
  - Move ENV_DEFAULTS, TIMEOUTS to app-config.yaml
  - Load at startup via DBAL
- Deliverable: Reach 35-40% data-driven architecture

**Phase 3: Polish & Optimization (Future, 2-3 hours)**
- Complete TODO items
- Add error boundaries
- Improve TypeScript coverage

**Success Metrics**:
- Data-Driven Ratio: 27% → 35-40%
- Hardcoded Data Sources: 3 → 0
- Deprecated Code: 119 files → 0
- Adapter Duplication: 355 lines → 0

**Risk Assessment**: Low risk, all backward compatible

**Integration with Roadmap**:
- Q1 2026: Phase 1 cleanup (Jan-Feb)
- Q2 2026: Phase 2 refactoring (Feb-Mar)
- Q2-Q3 2026: Feature development on clean codebase

This roadmap reflects the significant effort already spent
deleting TypeScript to reach the 95% JSON/JSON Script paradigm.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-14 19:13:27 +00:00
rmac
03aea05698 Update ROADMAP.md: Comprehensive codebase audit and technical debt analysis
Replaced outdated Technical Debt section with detailed audit findings:

**Codebase Composition (Current State)**:
- 2,047 total files
- 1,487 TypeScript files (73%)
  - DBAL: 282 files (14%)
  - FakeMUI: 514 files (25%)
  - NextJS Frontend: 491 files (24%)
  - Tests: 16 files (1%)
  - Deprecated code: 119 files (6%)
- 560 JSON/YAML files (27%)
  - Packages: 376 files (18%)
  - Schemas: 76 files (4%)
  - Seed config: 5 files (<1%)

**Data-Driven Ratio**: Currently 27% (can reach 35-40% with refactoring)

**Technical Debt (Prioritized)**:

High Priority (1-3 hours):
1. Delete /old directory (119 files) - pre-Next.js SPA cruft
2. Delete .backup files (4 files) - not needed with Git history
3. Migrate seed data from TS to YAML (4-5 hours)

Medium Priority (4-5 hours):
4. Eliminate adapter code duplication (2-3 hours)
5. Migrate role/permission constants to seed data (2-3 hours)
6. Migrate environment configuration (2-3 hours)

Low Priority (2-3 hours):
7. Remove experimental code (1 hour)
8. Complete TODO items (variable)

**Total Recommended Effort**: 9-16 hours to reach 35-40% data-driven

**Architecture Assessment**: A- (Excellent with minor improvements)

This audit reflects the work done deleting TypeScript to reach the 95%
JSON/JSON Script paradigm. The recommendations show clear path to better
data-driven architecture without breaking production code.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-01-14 19:06:41 +00:00
f21d1c7b0f Archive root summary markdown files 2026-01-13 21:07:41 +00:00
copilot-swe-agent[bot]
759ec80a44 Add comprehensive project history and Spark version comparison to ROADMAP.md
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 23:05:48 +00:00
copilot-swe-agent[bot]
c128eb02e7 Implement authentication middleware - Phase 2.6 complete
- Created auth-middleware.ts with authenticate() and requireAuth()
- Validates session tokens via getCurrentUser()
- Checks permission levels (0-5 scale)
- Returns 401/403/500 responses appropriately
- Supports public endpoints and custom checks
- Added 21 comprehensive unit tests (all passing)
- Updated ROADMAP.md and README.md with completion status
- All 464 tests passing (100% pass rate)

Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 05:15:57 +00:00
copilot-swe-agent[bot]
801e446ff2 docs: update ROADMAP.md and README.md with completed Phase 2 features
- Mark Phase 2 as 90% complete (up from 80%)
- Update test coverage stats (414/418 tests, 99.0% pass rate)
- Document completed features: retry, pagination, filtering, validation
- Add comprehensive API utility documentation in README
- Update testing requirements section with actual vs target numbers
- Mark 148 new utility tests as complete (exceeded 150 test target)

Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 04:31:02 +00:00
copilot-swe-agent[bot]
726f0bfc7b Update ROADMAP.md: Phase 2 APIs 80% complete, tests expanded
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 04:09:40 +00:00
copilot-swe-agent[bot]
38a61fbc11 docs: Expand ROADMAP.md with detailed Phase 2 implementation plan and testing strategy
- Added comprehensive Phase 2 (Backend Integration) breakdown with weekly targets
- Detailed 8 implementation tasks with 150+ unit tests, 30+ integration tests, 15+ E2E tests
- Added performance benchmarks for all API endpoints
- Expanded testing strategy with 200+ specific test scenarios
- Added test distribution targets (500+ unit, 100+ integration, 30+ E2E)
- Documented critical test scenarios by priority
- Added test performance targets and data management strategies

Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 03:41:43 +00:00
copilot-swe-agent[bot]
fa4b27a0f8 feat: Add comprehensive E2E tests with Playwright POM pattern and TDD examples
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 02:55:28 +00:00
copilot-swe-agent[bot]
3831e6cca9 docs: Add comprehensive TESTING_GUIDE.md with TDD and Playwright best practices
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 02:51:31 +00:00
copilot-swe-agent[bot]
579da82588 Fix MVP Milestone section header in ROADMAP.md
Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 02:30:59 +00:00
copilot-swe-agent[bot]
2c59bf40f0 Create comprehensive ROADMAP.md as single source of truth
- Complete system overview with technology stack
- Detailed architecture documentation (database, DBAL, packages)
- 52 built-in packages cataloged and categorized
- MVP milestone clearly marked with all achievements
- Complete phase-by-phase roadmap through 2028
- Comprehensive feature status matrix
- Known issues and technical debt documented
- Deployment options for all platforms
- Development workflow and code standards
- Success metrics and long-term vision
- Contributing guide and project resources
- Changelog and version history

Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
2026-01-08 02:29:50 +00:00