roboledger-app
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.
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.
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 bootstrapin the backend repo: it deploys OIDC and sets this
repository'sAWS_ROLE_ARN,AWS_ACCOUNT_IDandAWS_REGION - Run
npm run setup:ghahere 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_COMPUTEGitHub variable (apprunnerby default; per environment withAPP_COMPUTE_PROD/APP_COMPUTE_STAGING). App Runner is closed to new AWS customers, so an account that has never used it must setAPP_COMPUTE=ecs-express. Without a default VPC, also setECS_SUBNETSto 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)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi