Skip to content

Commit

Permalink
Add files via upload
Browse files Browse the repository at this point in the history
  • Loading branch information
ggeerraarrdd authored Dec 4, 2023
0 parents commit e83b176
Show file tree
Hide file tree
Showing 54 changed files with 3,972 additions and 0 deletions.
21 changes: 21 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2023 Gerard Bul-lalayao

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
96 changes: 96 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
# LAFSCMS

A companion CMS for the Landscape Architecture Film Series website

## Description

_LAFSCMS_ is the companion content management system (CMS) for the _Landscape Architecture Film Series_ [website](https://l-a-f-s.org/). Currently in alpha, the plan is to merge the beta version with the [film series repo](https://github.com/ggeerraarrdd/film-series).

Just like any real-world organization, student-run organizations such as a film series experience knowledge loss when their membership graduate. Unless there is a knowledge transfer process, that loss may lead to technical resources being underutilized or altogether becoming inactive. Alternative resources and processes always exist, but they either must be created from scratch, requiring non-zero time and resources, or are imperfect substitutes. If existing resources do the job perfectly fine, why go through all that effort?

_LAFSCMS_ was developed to address the issue of knowledge loss by providing a CMS accessed through a user-friendly web interface to manage content and users.

![LAFSCMS](/static/images/lafscms_1.png)

The features of the system are based on business requirements as captured in the following user stories:

1. "As an admin or a curator, I want to log in or log out of the CMS, so that I can access the functionalities of the CMS or stop that access."
2. "As an admin or a curator, I want to create a film series, so that I can start the process of updating the website with the new film series."
3. "As an admin or a curator, I want to edit a film series, so that information related to the film series is updated."
4. "As an admin or a curator, I want to publish a film series, so that website visitors can view information about the film series."
5. "As an admin or a curator, I want to unpublish a film series, so that the film series is removed from the website."
6. "As an admin or a curator, I want to delete a film series, so that the film series is removed from both the website and database."
7. "As an admin or a curator, I want to update a scheduled film in an ongoing series, so that website visitors are informed about new nformation."
8. "As an admin or a curator, I want to see a list of all films in a completed, ongoing or unpublished series, so that I don't duplicate a film in a future series."
9. "As an admin or a curator, I want perform CRUD operations on poster image files, so that the website and database are up-to-date in terms of the posters."
10. "As an admin or curator, I want to read documentations on using the film series website and CMS, so that I can update them."
11. "As an admin, I want to register new users, so that they can access the CMS."
12. "As an admin, I want to manage user privileges, so that users can access only the CMS functionalities based on their status and roles."

As of v2.0.0-alpha.1, all user stories have been implemented except for #1, #6, and #10-12.

More screenshots below.

## Disclaimer

ALL CONTENTS IN THIS REPO ARE FOR EDUCATIONAL PURPOSES ONLY.

## Getting Started

### Dependencies

* Flask==2.3.2
* flask_session==0.5.0

### Usage

Clone it!

```bash
git clone https://github.com/ggeerraarrdd/lafs-cms.git
```

Go into the project directory and run the command:

```bash
flask run
```

To open the film series website, copy the URL after 'Running on'.

To open the CMS, add `cms` at the end of the url.

### Notes on Google Maps

This is disabled.

## Author(s)

* [@ggeerraarrdd](https://github.com/ggeerraarrdd/)

## Version History

### Release Notes

* See [https://github.com/ggeerraarrdd/lafs-cms/releases](https://github.com/ggeerraarrdd/lafs-cms/releases)

### Future Work

Development of primary features is ongoing.

## License

* [MIT License](https://github.com/ggeerraarrdd/large-parks/blob/main/LICENSE)

## Acknowledgments

* Notion AI

## Screenshots

![LAFSCMS](/static/images/lafscms_2.png)
![LAFSCMS](/static/images/lafscms_3.png)
![LAFSCMS](/static/images/lafscms_4.png)
![LAFSCMS](/static/images/lafscms_5.png)
![LAFSCMS](/static/images/lafscms_6.png)
![LAFSCMS](/static/images/lafscms_7.png)
Loading

0 comments on commit e83b176

Please sign in to comment.