# iPLAss

> iPLAss is an open-source Java-based high-productivity / low-code development platform. It provides metadata-driven data modeling, auto-generated UIs, an MVC framework, authentication and authorization, multi-tenancy, workflow, data aggregation, job scheduling, AI integration, and more.

Things to know when working with iPLAss:

- An iPLAss application is shaped by two distinct configuration layers: **metadata** (entities, screens, authentication policies, workflows, schedules, etc.) managed through the AdminConsole, and **`service-config.xml`** which selects framework Service implementations (RDB adapter, authentication providers, logging, caching, and so on). Feature behavior such as account lockout, password policy, or screen layout belongs to metadata, *not* to `service-config.xml`.
- Business logic is implemented as **`Command` classes** (`org.iplass.mtp.command.Command`). REST/JSON endpoints are defined by annotating a Command with **`@WebApi`** (`org.iplass.mtp.command.annotation.webapi.WebApi`).
- Public APIs live under the `org.iplass.mtp` package, excluding `*.impl.*` subpackages which are internal. Javadoc class pages follow `https://iplass.org/docs/javadoc/org/iplass/mtp/{path}/{ClassName}.html`; use the [all-classes index](https://iplass.org/docs/javadoc/allclasses-index.html) when the containing package is unknown.
- Documentation map: concepts and how-to → [Developer Guide](https://iplass.org/docs/developerguide/index.html); API signatures → [Javadoc](https://iplass.org/docs/javadoc/index.html); `service-config.xml` settings → [service-config reference](https://iplass.org/docs/serviceconfig/index.html).
- The primary documentation is in Japanese under `/docs/...`; English mirrors live under `/en/docs/...` where available.
- **MCP (Model Context Protocol)**: iPLAss Enterprise Edition provides an MCP server (Streamable HTTP transport). When enabled, MCP clients can discover and invoke iPLAss tools – including built-in tools for browsing/updating metadata. The MCP endpoint is served at the application's context path under `/mcp` (e.g. `https://{host}/{contextPath}/mcp`). Configuration details: [AI連携 Developer Guide](https://iplass.org/docs/developerguide/ai/index.html).

## Developer Guide

- [メタデータ管理](https://iplass.org/docs/developerguide/metadata/index.html): Metadata administration, tenant and service configuration
- [データ管理（Entity）](https://iplass.org/docs/developerguide/datamanagement/index.html): Entity definitions, property types, CRUD via EntityManager, EQL queries
- [GEM（Generic Entity Manager）](https://iplass.org/docs/developerguide/genericentitymanager/index.html): Customizing the auto-generated search and detail screens for entities
- [MDC（Material Design Components）](https://iplass.org/docs/developerguide/materialdesigncomponents/index.html): Material Design-compliant UI components
- [カスタムロジックの組込](https://iplass.org/docs/developerguide/customizing/index.html): Implementing business logic with Command / Interceptor / Filter / EventListener
- [Web API](https://iplass.org/docs/developerguide/webapi/index.html): Defining REST/JSON Web APIs, authentication, CORS, file upload
- [帳票出力](https://iplass.org/docs/developerguide/report/index.html): PDF / Excel report generation
- [認証](https://iplass.org/docs/developerguide/authentication/index.html): User authentication, two-factor authentication, login control
- [認可](https://iplass.org/docs/developerguide/authorization/index.html): Roles, permissions, row- and property-level authorization
- [OAuth / OpenID Connect](https://iplass.org/docs/developerguide/oauth/index.html): OAuth 2.0 / OIDC provider and relying-party support
- [SAML](https://iplass.org/docs/developerguide/saml/index.html): Single sign-on via SAML 2.0
- [SCIM](https://iplass.org/docs/developerguide/scim/index.html): SCIM provisioning
- [多言語対応](https://iplass.org/docs/developerguide/i18n/index.html): Internationalization and localization
- [通知](https://iplass.org/docs/developerguide/notification/index.html): Email, SMS, and push notifications with template management
- [マルチテナント](https://iplass.org/docs/developerguide/multitenant/index.html): Multi-tenant design and operations
- [汎用検索（Entity Listing）](https://iplass.org/docs/developerguide/entitylisting/index.html): Building and persisting entity search screens
- [定型集計](https://iplass.org/docs/developerguide/aggregation/index.html): Aggregation queries and aggregation screens
- [簡易 BI](https://iplass.org/docs/developerguide/simplebi/index.html): Cube-based lightweight BI features
- [ワークフロー](https://iplass.org/docs/developerguide/workflow/index.html): Workflow definitions and execution
- [スケジューラ](https://iplass.org/docs/developerguide/schedule/index.html): Scheduled / batch job management
- [開発・運用サポート](https://iplass.org/docs/developerguide/support/index.html): Debugging, logging, and operations tools
- [Gradle Plugin](https://iplass.org/docs/developerguide/gradleplugin/index.html): Build and deployment automation
- [WAM（Web Account Manager）](https://iplass.org/docs/developerguide/wam/index.html): Member-management plugin for existing websites
- [AI連携](https://iplass.org/docs/developerguide/ai/index.html): AI integration – generative AI platform integration, data connect, MCP (Model Context Protocol)
- [MCP（Model Context Protocol）](https://iplass.org/docs/developerguide/mcp/index.html): MCP server/client – exposing iPLAss Commands as MCP Tools, OAuth and bearer-token authentication for MCP clients
- [パフォーマンスチューニング](https://iplass.org/docs/developerguide/performance/index.html): Performance tuning guidance
- [セキュリティ対策](https://iplass.org/docs/developerguide/securitycoding/index.html): Secure coding practices
- [アップグレードガイド](https://iplass.org/docs/developerguide/upgradeguide/index.html): Migration from 3.2 to 4.0

## Reference

- [Javadoc](https://iplass.org/docs/javadoc/index.html): Class reference for public APIs under `org.iplass.mtp`
- [Javadoc all-classes index](https://iplass.org/docs/javadoc/allclasses-index.html): Entry point for resolving a class name to its package
- [EQL reference](https://iplass.org/docs/eqlreference/index.html): Entity Query Language (EQL) syntax and operators
- [service-config reference](https://iplass.org/docs/serviceconfig/index.html): Per-service settings (`EntityService`, `AuthService`, `WebApiService`, etc.)
- [Environment](https://iplass.org/docs/environment/index.html): Supported runtime environment, deployment, and setup notes

## Site

- [トップ](https://iplass.org/): Japanese landing page
- [はじめる](https://iplass.org/intro/): Getting started
- [製品仕様](https://iplass.org/products/): Editions and feature matrix
- [ダウンロード](https://iplass.org/downloads/): Downloads
- [GitHub](https://github.com/dentsusoken/iPLAss/): Source code, issues, releases

## Optional

- [Top (English)](https://iplass.org/en/)
- [Get Started (English)](https://iplass.org/en/intro/)
- [Product Details (English)](https://iplass.org/en/products/)
- [Downloads (English)](https://iplass.org/en/downloads/)
- [GitHub: iPLAss-docs](https://github.com/dentsusoken/iPLAss-docs/): AsciiDoc source repository for the Developer Guide and service-config reference
- [iPLAss Enterprise Edition](https://itsol.dentsusoken.com/iplass/): Commercial edition by Dentsu Soken