roboledger-app

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in .github/workflows/build.yml
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

RoboLedger, the general ledger built on RoboSystems, the open-source knowledge graph for finance. Close, consolidation, schedules, bank feeds, reconciliations and forecasting, every number traced to the entry, from the app or any MCP client. Next.js, deployable to your own AWS account.

README.md

RoboLedger App

Part of RoboSystems, the open-source knowledge graph for finance. RoboLedger is the general ledger built on it, a full accounting system in its own right: close, consolidation, schedules, bank feeds, reconciliations and forecasting, every number traced to the entry. This repository is its web app, served at roboledger.ai; your AI works the same books from Claude, ChatGPT or any MCP client.

  • Every number traced: Open any figure on a statement down to the accounts and entries behind it
  • QuickBooks Integration: Sync with existing QuickBooks data; nothing writes back until you post an entry
  • Plain-English Questions: Ask about your books in plain English and get answers that open to the entries behind them
  • Your AI, over MCP: Connect the AI assistant you already use; it drafts, and your people approve
  • Multi-Source Data: QuickBooks, bank feeds through Plaid, and custom datasets

Core Features

  • Dashboard: Financial overview with quick actions
  • Ledger: Chart of accounts with taxonomy framework mapping, bank accounts, journal entries, trial balance, account register, and receivables and payables
  • Period Close: Fiscal calendar bootstrap, close workflow with gate checks, and rule-based pre-close evaluation
  • Live Statements: Render balance sheet, income statement, and cash flow directly from the current ledger, no period close required
  • Schedules: Recurring journal entry templates with auto-evaluation on close
  • Inbox: Review and approve captured events before they post to the ledger, one at a time or in a batch
  • Posting Rules: The event handlers that turn a matching event into journal entries
  • Reports: Custom report builder with fact grids, statement and text-block disclosure rendering, templates, publish lists, and multi-format export
  • Plan: Monthly statements and a scenario's assumptions in one grid spanning the actuals/forecast seam, with scenario switching, period windowing, and CSV export
  • Block Explorer: Browse Information Blocks through rendered, chart, facts, elements, validation, and rules views, with on-the-fly metric computation
  • Mapping Workbench: Configure taxonomy framework mappings with AI suggestions and the automapper operator
  • Connections: QuickBooks OAuth sync and bank feeds through Plaid
  • Entity Detail: Per-entity details and configuration
  • Agents: Counterparties (customers, vendors, employees) with their open balances
  • AI Console: Natural language and Cypher query terminal with streaming results and MCP integration
  • Document Search: Full-text and semantic search across uploaded documents and connected sources
  • Library: Browse canonical taxonomies, elements, and reference data
  • Entities: The reporting group of the selected graph: the parent and its subsidiaries

Quick Start

npm install              # Install dependencies
cp .env.example .env     # Configure environment (edit with your API endpoint)
npm run dev              # Start development server

The application will be available at http://localhost:3001

Development Commands

Core Development

npm run dev              # Start development server (port 3001)
npm run build            # Production build

Testing

npm run test:all         # All tests and code quality checks
npm run test             # Run Vitest test suite
npm run test:coverage    # Generate coverage report

Code Quality

npm run lint             # ESLint validation
npm run lint:fix         # Auto-fix linting issues
npm run format           # Prettier code formatting
npm run format:check     # Check formatting compliance
npm run typecheck        # TypeScript type checking

SDLC Commands

npm run feature:create   # Create a feature branch
npm run release:create   # Create GitHub release
npm run deploy:staging   # Deploy to staging environment
npm run deploy:prod      # Deploy to production

Shared Core Library

Shared components live in the @robosystems/core npm package (repo: robosystems-core). Bump the pinned version to pick up changes:

npm install @robosystems/core@latest

Prerequisites

System Requirements

  • Node.js 26+ (LTS)
  • 4GB RAM minimum
  • Modern browser (Chrome, Firefox, Safari, Edge)

Required Services

  • RoboSystems API endpoint (local development or production)
  • Intuit Developer account (for QuickBooks OAuth)

Deployment Requirements

  • Fork this repo (and the robosystems backend)
  • AWS account with IAM Identity Center (SSO)
  • Run just bootstrap in the backend repo: it deploys OIDC and sets this
    repository's AWS_ROLE_ARN, AWS_ACCOUNT_ID and AWS_REGION
  • Run npm run setup:gha here to configure the remaining deployment variables

See the Bootstrap Guide for complete instructions including access modes (internal, public).

Architecture

Application Layer:

  • Next.js 16 App Router
  • TypeScript 5 for type safety
  • Tailwind CSS with the shared UI primitives in @robosystems/core/ui
  • RoboSystems Client SDK for API communication
  • Statement and report rendering via @robosystems/report-components
  • Intuit OAuth for QuickBooks integration

Core Library (@robosystems/core):

Shared modules consumed as an npm package across RoboSystems frontend apps:

  • Auth components (login, register, password reset)
  • Session management and JWT handling
  • Graph creation wizard and shared components
  • Layout, forms, chat, and settings components
  • Graph, organization, and entity contexts
  • SSE-based background job progress tracking

Infrastructure:

  • AWS App Runner or Amazon ECS Express Mode with auto-scaling, chosen by the APP_COMPUTE GitHub variable (apprunner by default; per environment with APP_COMPUTE_PROD / APP_COMPUTE_STAGING). App Runner is closed to new AWS customers, so an account that has never used it must set APP_COMPUTE=ecs-express. Without a default VPC, also set ECS_SUBNETS to comma-separated public subnet IDs in at least two AZs.
  • S3 + CloudFront for static asset hosting
  • CloudFormation templates in /cloudformation/

Support

License

Apache License 2.0 - see LICENSE for details.

Apache-2.0 © 2026 RFS LLC

Yorumlar (0)

Sonuc bulunamadi