aim42 / venom-example Goto Github PK

View Code? Open in Web Editor NEW

19.0 7.0 8.0 20.06 MB

arc42 documentation of a VERy NOrMal business system - used as example for several aim42 practices

License: Other

Groovy 100.00%

venom-example's Introduction

Beispiel

arc42 + aim42 documentation of a VERy NOrMal business system.

An example for several aim42 practices and for the arc42 architecture template.

Disclaimer: This system is completely artificial.
Any similarity to existing systems or organizations is purely accidental and against my intention.

(c) by Dr. Gernot Starke. Rights reserved. Reproduction and commercial use only with written permission by the author. Please see the file "license.txt" for details.

Diese Dokumentation ist auf Deutsch geschrieben!

Inhalt

Organisation und Geschäftsprozesse der (fiktiven) Organisation SAMM Inc., die das VENOM-System entwickelt und betreibt, eine Vertriebs- und Verkaufsplattform für komplexe Produkte.
arc42 Architekturdokumentation dieses Systems, inklusive Onlineshop, Backend-Logistik und Rechnungswesen, Warenwirtschaft, Beschaffung, Pricing, Kundenverwaltung...).
Issue-Liste: Gemäß aim42 dient die Issue-Liste der Sammlung und Ordnung bekannter Probleme eines Systems oder der damit verbundenen Prozesse.
Improvement-Backlog: Gemäß aim42 dient das Improvement-Backlog der Sammlung und Ordnung der bisher identifizierten Verbesserungsmöglichkeiten zu den erkannten Problemen.

Was bedeutet "Venom"?

venom (Engl.): Gift, Giftigkeit, Bosheit.

Ich verwende den Begriff hier als Kurzform von "VEry NOrMal System, sozusagen als einen (fiktiven) Normalfall einer über Jahre hinweg entwickelten und benutzten Individualsoftware.

Fehler und Hinweise

Bitte melden Sie Fehler oder Hinweise über unseren Issue-Tracker. Pull-Requests sind herzlich willkommen!

Credits

Das ursprüngliche VENOM-Logo basiert auf Bone-Clipart von matheod sowie Poison-Clipart von Lil_Mermaid_Girl und Dear-theophilus

venom-example's People

Contributors

Stargazers

Watchers

Forkers

lilienth anrichter rdmueller chakra-coder feststelltaste ahoendgen mrpoudel business-model-canvas

venom-example's Issues

Bilderkennung

um in Konfiguratoren initiale Vorschläge, Raum-Maße oder Grundrisse bestimmen zu können.

generate pdf output

currently the asciidoctor-gradle plugin does NOT support pdf.

We need pdf for printing the example.

security versus performance

optimized performance -> reduced security

add HtmlSanityCheck to gradle build

to check links & image references

add and explain system context

optisches Archiv Whitebox -> broken

4-5 High-Level Q-Ziele

von unterschiedlichen Stakeholdern,
möglichst "widersprechend"

Build Fails

Hallöchen

Ich versuche das Venom Example aktuell unter Windows 11 mit Gradle zu bilden. Ich habe den Befehl "git submodule update -i" für die docToolchain auch vorher ausgeführt.

Gradle ist installiert:
Gradle 7.6
Build time: 2022-11-25 13:35:10 UTC
Revision: daece9dbc5b79370cc8e4fd6fe4b2cd400e150a8
Kotlin: 1.7.10
Groovy: 3.0.13
Ant: Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM: 11.0.18 (Eclipse Adoptium 11.0.18+10)
OS: Windows 11 10.0 amd64

Ascidoctor ist installiert:
Asciidoctor 2.0.18 [https://asciidoctor.org]
Runtime Environment (ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [x64-mingw-ucrt]) (lc:CP850 fs:UTF-8 in:UTF-8 ex:UTF-8)

Java ist installiert:
openjdk 11.0.18 2023-01-17
OpenJDK Runtime Environment Temurin-11.0.18+10 (build 11.0.18+10)
OpenJDK 64-Bit Server VM Temurin-11.0.18+10 (build 11.0.18+10, mixed mode)

Jetzt bekomme ich einen Fehler:

"Could not find method testCompile() for arguments [junit:junit:4.12, org.spockframework:spock-core:1.1-groovy-2.4, com.athaydes:spock-reports:1.3.2, org.slf4j:slf4j-api:1.7.13, org.slf4j:slf4j-simple:1.7.13, org.gradle.api.internal.artifacts.dependencies.DefaultSelfResolvingDependency_Decorated@2f60c48d] on object of type org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler."

Ich habe den stacktrace von Gradle angehängt.

logoutput.txt

Was noch gut wäre im readme wäre ein hinweis wie man es builden muss, kein Vortrag aber den gradle build command angeben wäre spannend. Dann weiss man was man tun muss.
Und irgendwie habe ich jetzt nicht ganz rausgefunden was am Schluss des buildes rauskommen müsste und man starten müsste um das sample anzuschauen.

Ich habe jetzt die .adoc im src\docs files mit asciidoctor gebuildet, das muss man aber auch mal rausfinden.
Ich arbeite übrigens Ihr Buch durch ;-).

Für den Moment ist das glaube ich ok wenn ich es von Hand bilde aber für andere wäre es natürlich gut wenn die buildchain wieder funktioniert.

Gruss

Alex

Verfügbarkeit + Termine
Preise für konkrete Anfragen

Daten(banken)
generische Nachrichtenformate
ESB