Comptaleyes Platform

Modern accounting and finance management platform built with scalable microservices architecture.

📋 Project Overview

Comptaleyes is a full-stack web application designed for accounting and financial management. The platform features a NestJS backend API, React frontend, and automated AWS infrastructure deployment using CDK.

🏗️ Architecture

This monorepo contains three main components:

comptaleyes/
├── backend/          # NestJS API with authentication & business logic
├── frontend/         # React SPA with modern UI components
├── infra/            # AWS CDK infrastructure as code
└── .github/          # CI/CD workflows (GitHub Actions)

Backend

• Framework: NestJS (Node.js 22)
• Database: MongoDB Atlas
• Authentication: JWT + OAuth2 (Microsoft, Google, Facebook)
• Email: SMTP-based verification & password reset
• Deployment: Docker → AWS ECR → EC2

Frontend

• Framework: React 19 with TypeScript
• Build Tool: Vite
• UI Library: @ciscode/ui-authentication-kit
• Deployment: S3 + CloudFront CDN

Infrastructure

• IaC: AWS CDK (TypeScript)
• Compute: EC2 for backend containers
• Storage: S3 for frontend static assets
• CDN: CloudFront for global distribution
• Secrets: SSM Parameter Store

🚀 Quick Start

Prerequisites

• Node.js 22+ and npm
• Docker Desktop
• AWS CLI configured (for deployment)
• MongoDB Atlas account

Backend Setup

cd backend
cp .env.example .env
# Edit .env with your credentials
npm install
npm run dev

Backend will be available at http://localhost:3000

Health Check: curl http://localhost:3000/health

Frontend Setup

cd frontend
cp .env.example .env
# Edit .env with backend URL
npm install
npm run dev

Frontend will be available at http://localhost:5173

Full Stack with Docker

cd backend
docker compose -f compose/docker-compose.dev.yml up --build

📚 Documentation

• Backend README - API architecture, domain logic, deployment
• Frontend README - UI components, routing, authentication
• Infrastructure README - CDK stacks, AWS resources

🔐 Environment Configuration

All sensitive credentials are stored in .env files (local) or AWS SSM Parameter Store (production).

Required Environment Variables: See .env.example files in each directory:

• backend/.env.example
• frontend/.env.example

🧪 Testing

# Backend tests
cd backend
npm test                 # All tests
npm run test:watch       # Watch mode
npm run test:cov         # Coverage report

# Frontend tests
cd frontend
npm test

🚢 Deployment

CI/CD Pipelines

GitHub Actions workflows handle automated deployments:

• Backend CI: PR validation (lint, test, typecheck)
• Backend CD: Build Docker → ECR → EC2 deployment
• Frontend CI: PR validation (lint, test, typecheck)
• Frontend CD: Build Vite → S3 → CloudFront invalidation
• CDK Deploy: Infrastructure updates via CDK

Manual Deployment

# Deploy infrastructure
cd infra
npm run build
npx cdk deploy --all

# Deploy backend (via GitHub Actions)
git push origin master  # Triggers backend-cd.yml

# Deploy frontend (via GitHub Actions)
git push origin master  # Triggers frontend-cd.yml

🏃 Production Environments

• Frontend: Deployed via CloudFront CDN for global distribution
• Backend API: Deployed on AWS EC2 with Docker
• Database: MongoDB Atlas
• Infrastructure: AWS (us-east-1 region)

🛠️ Development Workflow

1. Create feature branch from develop
2. Make changes and commit
3. Push and create PR → develop
4. CI pipeline validates (lint, test, typecheck)
5. After review, merge to develop
6. When ready for release, PR → master triggers deployment

📦 Tech Stack Summary

Component	Technologies
Backend	NestJS, TypeScript, MongoDB, Docker
Frontend	React, Vite, TailwindCSS, React Router
Authentication	JWT, OAuth2, @ciscode/authentication-kit
Infrastructure	AWS CDK, EC2, S3, CloudFront, ECR
CI/CD	GitHub Actions with OIDC
Monitoring	CloudWatch Logs, Health endpoints

🤝 Contributing

See CONTRIBUTING.md for development guidelines.

🔒 Security

To report security vulnerabilities: info@ciscod.com

See SECURITY for our security policy.

📝 License

MIT License - See LICENSE file for details.

Copyright (c) 2026 CisCode