Continuo Platform

AI-powered business management platform for small businesses

---

📚 Documentation Hub

• Full documentation index: docs/README.md

For detailed project status, roadmap, and development planning, see:

• Project Status Summary
• Project Roadmap
• Development Plan
• API Reference
• Security
• Release Workflow
• Changelog

---

🚀 Quick Start

Prerequisites

• Docker and Docker Compose
• Node.js 18+ (for local development)
• Git

Installation & Setup

1. Clone the repository

   git clone <repository-url>
   cd Continuo

2. Start the application

   docker-compose up -d

3. Seed the database (first time setup)

   docker-compose exec api npm run db:seed

4. Access the application

Environment	Web App URL	API URL	Database Admin	Email Testing	Status
Production	https://continuo.pro	https://api.continuo.pro/graphql	-	-	Live
Dev (Railway)	https://continuo-web-dev.up.railway.app	https://continuo-api-dev.up.railway.app/graphql	-	-	Live
Localhost	http://localhost:3000	http://localhost:4000/graphql	http://localhost:8080	http://localhost:8025	Local

4. Test Accounts
   • Admin: admin@continuo-demo.com / TestPassword123!
   • Employee: employee@continuo-demo.com / Employee123!
   • Avery Test: avery@tester.com / NewPassword123!

---

🏗️ Architecture

Backend Stack

• Node.js with Express
• Apollo Server for GraphQL
• PostgreSQL database
• Prisma ORM
• Redis for caching (configured)
• JWT for authentication
• bcrypt for password hashing

Frontend Stack

• Next.js 14 with App Router (downgraded from 15 for stability)
• React 18 (downgraded from 19 for compatibility)
• TypeScript for type safety
• Tailwind CSS for styling
• Apollo Client for GraphQL
• Lucide React for icons
• React Hooks for state management

DevOps & Tools

• Docker containerization
• Docker Compose for orchestration
• ESLint for code linting
• Prettier for code formatting
• Linear for project management
• Release-it for automated releases
• Conventional Commits for version control

📁 Project Structure

Continuo/
├── api/                    # Backend API
│   ├── src/
│   │   ├── graphql/       # GraphQL resolvers and types
│   │   │   ├── typeDefs/  # GraphQL type definitions
│   │   │   └── resolvers/ # GraphQL resolvers
│   │   ├── shared/        # Shared utilities and middleware
│   │   └── index.js       # Main server file
│   ├── prisma/            # Database schema and migrations
│   ├── database/          # Seeds and database utilities
│   ├── tests/             # API tests
│   └── package.json
├── web-app/               # Frontend application
│   ├── src/
│   │   ├── app/          # Next.js app router pages
│   │   │   ├── dashboard/ # Dashboard pages
│   │   │   │   ├── accounts/    # Chart of Accounts
│   │   │   │   ├── transactions/ # Transaction Management
│   │   │   │   ├── invoices/    # Invoice Management (Complete)
│   │   │   │   ├── customers/   # Customer Database
│   │   │   │   ├── contacts/    # Contact Management
│   │   │   │   ├── leads/       # Lead Management
│   │   │   │   └── debug/       # Debug Page
│   │   │   └── auth/      # Authentication pages
│   │   ├── lib/          # Utilities and configurations
│   │   └── components/   # React components
│   └── package.json
├── docs/                  # Project documentation
│   ├── DEVELOPMENT_PLAN.md
│   ├── PROJECT_ROADMAP.md
│   ├── PROJECT_STATUS_SUMMARY.md
│   ├── SPRINT_2_TESTING_PLAN.md
│   ├── SPRINT_2_TEST_NOTES.md
│   ├── ...
├── scripts/               # Build and deployment scripts
├── docker-compose.yml     # Docker services configuration
├── README.md              # Main project documentation
├── CHANGELOG.md           # Project changelog
└── LICENSE                # Project license

---

🗂️ Issues & Project Management

• Internal Planning & Status: Use Linear for all sprint, epic, and planning issues. All internal docs link to Linear issues/epics.
• Public Bug Reports & Feature Requests: Use GitHub Issues for open source contributions and public tracking. Public docs link to GitHub issues.

---

🎯 Current Status

⏸️ Project Status: PAUSED (as of July 28, 2025)

• Development Complete: All planned Sprint 2 features implemented and functional
• Critical Issues Resolved: 8 major bugs fixed, development environment optimized
• Production Ready: Application is stable and ready for deployment when resumed
• Documentation: Comprehensive documentation and setup guides completed

✅ Completed Before Pause

• Sprint 2 Features: CRM, Accounting, Invoice Generation - 100% implemented
• Development Environment: Migrated to C:/dev/continuo with full Docker setup
• Compatibility Issues: React/Next.js version conflicts resolved
• Database Strategy: Three-tier environment strategy (localhost → dev → production)
• Testing Framework: Comprehensive testing documentation and bug fixes

📋 Project State

• Codebase: Stable, well-documented, production-ready
• Infrastructure: Docker containerization complete, Railway deployment configured
• Next Steps (when resumed): Complete remaining testing scenarios, finalize production deployment

---