Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koderizer/arc
Software system architecture authoring and inspecting made easy
https://github.com/koderizer/arc
arc architecture c4model
Last synced: 7 days ago
JSON representation
Software system architecture authoring and inspecting made easy
- Host: GitHub
- URL: https://github.com/koderizer/arc
- Owner: koderizer
- License: apache-2.0
- Created: 2020-04-11T16:47:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-06-08T16:20:49.000Z (over 4 years ago)
- Last Synced: 2024-08-02T16:35:36.668Z (3 months ago)
- Topics: arc, architecture, c4model
- Language: Go
- Homepage:
- Size: 255 KB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arc
__Software architecture made simple__
arc is a simple utility to author, visualize, inspect and update software architecture design easily through simple YAML files.
It is the utility to adopt the [C4model](https://c4model.com) architecture design approach that is promoted by Simon Brown. Arc allow the practice of architecture as code, allow easy integration to CiCd workflows such that archictecture information is accumulated and kept up to date as the system complexity grows, easily and free of any additional manual effort.
The objective is to design and deliver software product with clear architecture and clean working code, with the least amount of effort and duplicating cognitive workload.
The workflow using arc utilities is:
- Start note down architecture model of your app on a yaml file named arc.yaml.
- Use arcli to inspect and arcviz service to visualize the architecture in different views such as Landscape, Context, Containers or Component.
- Share the visualization through a centrally hosted arcviz server if your team fancy.
## Install
- Install and run arcviz on your machine. You need __Docker__ as it is the only option now.
```
docker run -d -p 10000:10000 -p 8080:8080 koderizer/arcviz:latest
```
- Install arcli utility, via Homebrew on Mac as it is the only convenient option now:
```
brew tap koderizer/arc
brew install arcli
```
_Build from source or download from release package and put to your bin path is another option_
## Usage
arcli help
## Example
One simple application
```yaml
app: arcs
desc: "Arc is a simple utility to author, view, inspect and update software architecture design"
users:
- name: dev
role: "one who create software service"
internal-systems:
- name: arc
desc: "Enable deloper to author, inspect and version control software systems design and code."
containers:
- name: cli
runtime: arcli-binary
technology: golang
desc: "local utility to parse and build arc data to and from visualizations"
- name: viz
runtime: docker-jetty
technology: "gRPC golang, plantuml"
desc: "render visualization of archtecture design given a arc data blob specifications"
components:
- name: arcviz
desc: grpc server to structure the layout into markup for renderer
- name: plantuml-renderer
desc: vizualize server using plantuml
external-systems:
- name: dev-ide
desc: software developement editor and integrated environment
relations:
- { s: dev, p: design and develop software, o: arc}
- { s: arc.arcli, p: send render request (gRPC), o: arc.arcviz}
- { s: dev-ide, p: integrate, o: arc.arcli}
```
to visualize this, simply run from the same directory this file is in:
arcli inspect
**This project is underconstruction**
Utilizing and base on works done from:
- [PlantUML](https://github.com/plantuml/plantuml)
- [C4-PlantUML](https://github.com/RicardoNiepel/C4-PlantUML)