📖 docs (readme): clarify component usage and workflow in readme
This commit is contained in:
@@ -13,7 +13,7 @@ RSSA - Front End
|
||||
- `app.vue`: Main layout
|
||||
- `components` : Contains all reusable UI components.
|
||||
- `components/flows` : Entry point for business logic and workflows. Pages or routes call these flow components to handle API requests and process application logic
|
||||
- `components/app` : View-layer components that manage and present data. These are used within flows/ to render or handle specific parts of the UI, and return results back to the flow
|
||||
- `components/app` : View-layer components that manage and present data. These are used within `flows/` to render or handle specific parts of the UI, and return results back to the flow
|
||||
- `components/pub` : Public/shared components used across different parts of the app.
|
||||
- `composables` : Contains reusable logic and utility functions (e.g. composables, hooks)..
|
||||
- `layouts` : Reusable UI layout patterns used across pages.
|
||||
@@ -33,15 +33,15 @@ The basic development workflow follows these steps:
|
||||
- These should represent the structure of the data used across your app.
|
||||
|
||||
### Build UI Components in `components/app`
|
||||
- Create reusable UI and app-specific components.
|
||||
- Keep components pure — avoid making HTTP requests directly within them.
|
||||
- Create reusable UI and app specific components.
|
||||
- Keep components pure, avoid making HTTP requests directly within them.
|
||||
- They receive data via props and emit events upward.
|
||||
|
||||
### Business Logic in `components/flows`
|
||||
- This layer connects the UI with the logic (API calls, validations, navigation).
|
||||
- It composes components from components/app/, components/pub/, and other flows.
|
||||
- It composes components from `components/app/`, `components/pub/`, and other flows.
|
||||
- Also responsible for managing state, side effects, and interactions.
|
||||
|
||||
### Create Pages in `pages/`
|
||||
- Pages load the appropriate flow from `components/flows/`.
|
||||
- They do not contain UI or logic directly—just route-level layout or guards.
|
||||
- They do not contain UI or logic directly, just route level layout or guards.
|
||||
|
||||
Reference in New Issue
Block a user