specs

The design and specifications of the app

View the Project on GitHub theWatchMasters/specs

NowPower Design

This repository contains the specifications and designs for our app

Structure

.
├── flows       # Contains MD files with user flows
│   ├── TEMPLATE.md  # Contains a template of user flows
│   ├── README.md    # Contains the specification of user flows
│   └── ...
├── design      # Contains MD files with app designs
│   ├── TEMPLATE.md  # Contains a template of screen designs
│   ├── README.md    # Contains the specification of screen designs 
│   └── ...
├── api         # Contains YAML files of OpenAPI data 
│   ├── README.md   
│   ├── openapi.yaml        # The root OpenAPI document which imports all other YAML documents
│   ├── paths               # Each YAML file in a subdirectory corresponds to the definition of a specific API endpoint path
│   │   └── ...
│   └── schema              # Each YAML file consists of a reusable OpenAPI schema model (e.g. a User model)
│       ├── components            # Contains the building block models (users, etc.)
│       │   └── ...
│       ├── errors                # Contains the models for error responses
│       │   └── ...
│       ├── requests              # Contains the models for request bodies
│       │   └── ...
│       └── responses             # Contains the models for successful response bodies
│           └── ...
└── infra       # Contains MD files which describe an aspect of the future infrastructure deployment
    ├── README.md    # Contains the infrastructure specifications
    └── ...

The repository consists of 4 subdirectories, each describing a facet of the app’s design